NGINXとPHPサービスの組み合わせを構成するためにMACOSを使用してPHP Nginx環境を構築する方法

MAC環境の構築におけるHomebrewの中心的な役割は、ソフトウェアのインストールと管理を簡素化することです。 1. Homebrewは、依存関係を自動的に処理し、複雑な編集プロセスとインストールプロセスを簡単なコマンドにカプセル化します。 2。ソフトウェアのインストールの場所と構成の標準化を確保するために、統一されたソフトウェアパッケージエコシステムを提供します。 3.サービス管理機能を統合し、Brew Servicesを通じてサービスを簡単に開始および停止できます。 4.便利なソフトウェアのアップグレードとメンテナンス、およびシステムのセキュリティと機能を改善します。

MacにPHP Nginx環境を構築することは、実際には強力なパッケージマネージャーであるHomeBrewを使用して、NginxをWebサーバーとしてインストールおよび構成し、同時にPHP-FPM（PHP FastCGI Process Manager）プロセスPHPスクリプトを使用することです。 2つは、FastCGIプロトコルを介して連携します。この組み合わせは、ローカル開発環境にとって効率的で柔軟です。

解決策について話すために、これはおそらくアイデアです。

まず、MacがMac開発者のスイスアーミーナイフであるHomebrewを持っていることを確認する必要があります。そうでない場合は、ターミナルで文を実行します： /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" Homebrewをインストールしてください。

nginxのインストール： brew install nginxコマンドとnginxは、システムに素直に横たわっています。そのデフォルトの構成ファイルパスは、通常/usr/local/etc/nginx/nginx.confにあります。

PHPをインストールします（プロジェクト要件に応じてPHP 8.2または8.3などの最新の安定したバージョンのインストールに慣れています）： brew install phpまたは特定のバージョンが必要な場合： brew install php@8.2インストールが完了した後、HomebrewはPHP-fpm構成ファイルがどこにあるか、通常/usr/local/etc/php/8.2/php-fpm.d/www.conf PHPバージョンに応じて）。

nginx構成はコアです。 nginx.confを編集する必要があります。 httpブロックでserverブロックを見つけたり、自分で新しいブロックを作成したりします。典型的な構成は次のようになります：

 http {
    ＃...他の構成...

    サーバー{
        8080を聞いてください。 ＃またはシステムserver_name localhostで他のサービスとの競合を回避したいポート。 ＃またはローカルドメイン名root/users/your_username/sites; ＃これは、Webサイトファイルを保存するディレクトリです。独自のPATH Index.php index.html index.htmに置き換えることを忘れないでください。

        位置 / {
            try_files $ uri $ uri / / index.php？$ query_string;
        }

        ＃これが重要な部分です。nginxをphp-fpmに転送します
        場所〜\ .php $ {
            ＃ファイルが存在するかどうかを確認し、存在しないphpファイルのnginx処理を避けますtry_files $ uri = 404;
            ＃fastcgiサーバーアドレス、通常はphp-fpmのデフォルトソケット
            FASTCGI_PASS 127.0.0.1:9000; ＃またはunix：/usr/local/var/run/php-fpm.sock
            ＃fastCGIパラメーターの導入FASTCGI_PARAMS;
            ＃SICTING_FILENAMEを設定してPHP-FPMを伝え、スクリプトパスが現在実行されているfastcgi_param script_filename $ document_root $ fastcgi_script_name;
            ＃nginxがHTTP認証ヘッダーfastcgi_param path_info $ fastcgi_path_info;に渡すことを許可します。
        }

        ＃敏感な情報を防ぐための.ht*ファイルを非表示漏れ場所〜/\.ht {
            すべてを否定します。
        }
    }
}

fastcgi_pass行に注意してください。 PHP-FPMがデフォルトでTCPポート9000に耳を傾ける場合、 127.0.0.1:9000 ：9000を使用します。 UNIXソケットに耳を傾ける場合、パスは/usr/local/var/run/php-fpm.sockのようになります（このパスはphp-fpm www.confにあります）。私は個人的には、わずかなパフォーマンスの利点があり、ポートの競合の可能性を回避するUnixソケットを使用することを好みます。

PHP-FPM構成の場合、通常、移動しすぎる必要はありません。 www.confのlistenパラメーターが、nginx構成のfastcgi_passのアドレスと一致することを確認してください。デフォルトでインストールされているPHP-FPMは、通常、すでに構成されています。

サービスの開始：nginxを開始： brew services start nginx start php-fpm： brew services start php （またはbrew services start php@8.2インストールしたバージョンに対応します）

テストする： <?php phpinfo(); ?>のコンテンツを使用して、Webサイトのルートディレクトリ（ /Users/your_username/Sitesなど）にindex.phpファイルを作成します。 <?php phpinfo(); ?> 。次に、ブラウザを開き、 http://localhost:8080/index.php （または構成したポートとドメイン名）にアクセスします。おなじみのPHP情報ページが表示されている場合は、おめでとうございます。環境は準備ができています。

Mac環境を構築する上でのHomebrewの中心的な役割は何ですか？

Macの開発環境に関して言えば、Homebrewは本当に人々を愛と憎しみにするものですが、愛についてです。そのコア関数は、手動でダウンロード、コンパイルし、構成する必要があるソフトウェアを単純なコマンドのラインに変えることです。 Homebrewがなければ、Nginxをインストールする場合は、公式Webサイトにソースコードをダウンロードし、それを解凍し、 ./configure Configure、 make 、 make install 。プロセス中に、さまざまな依存関係の問題に遭遇し、頭が大きすぎます。 Homebrewは非常に勤勉な執事のようなもので、これらすべての退屈なタスクを手伝っています。

それについて最も良い点は、統一された、管理しやすいソフトウェアパッケージエコシステムを提供することです。何をインストールしたいですか？ brew install ITは、すべての依存関係を処理し、正しい場所にインストールするのに役立ちます。通常、NGINXやPHP-FPMなどのスタートアップスクリプトの構成に役立ち、 brew services startによって実行できます。この利便性は、開発者が生産性を向上させるための強力なツールです。 Macのコマンドライン環境をより友好的で強力にし、環境構築の泥沼よりもコード自体にもっと集中できるようになります。さらに、ソフトウェアのアップグレードもシンプルでbrew upgradeであり、HomeBrewを通じてインストールされているすべてのソフトウェアは最新の状態に保つことができます。これは、セキュリティと機能の点で非常に有益です。

NginxはPHP-FPMとどのように連携しますか？

NginxとPHP-FPMのコラボレーションは、PHP Webサービスアーキテクチャ全体で非常に絶妙なデザインです。簡単に言えば、nginxは「ファサード」であり、Php-fpmは「舞台裏」です。

http://localhost:8080/index.phpなど、ユーザーがブラウザにURLを入力すると、リクエストは最初にnginxに到達します。 Nginxは効率的な静的ファイルサーバーです。写真、CSS、JSなどの静的リソースを要求すると、ファイルシステムから直接読み取り、非常に速い速度でブラウザに戻ります。しかし、要求された.phpファイルの場合、nginxはこの問題自体を処理できず、それを処理するためにPHPが必要であることを知っています。

現時点では、NginxはPHPコードを直接実行することはありませんが、「フォワーダー」の役割を果たします。 FastCGIプロトコルを介してこのPHPリクエストをPHP-FPMに転送します。 PHP-FPMは、1つ以上のPHPインタープリタープロセスプールを維持するPHPのプロセスマネージャーです。 Nginxがリクエストをスローすると、PHP-FPMはプロセスプールからアイドル状態のPHPプロセスを見つけてリクエストを処理します。このPHPプロセスがリクエストを受信した後、対応する.phpファイルを解析し、内部のPHPコードを実行し、データベースに接続したり、ビジネスロジックを処理したりします。

PHPコードが実行された後、PHP-FPMは実行結果（通常はHTML、JSON、またはその他のデータ）をFASTCGIプロトコルを介してNGINXに返します。 Nginxがこの結果を取得した後、最終的にユーザーのブラウザに送信します。

この分離設計の利点は明らかです。NGINXは、HTTPリクエストと静的ファイルの効率的な処理に焦点を当て、PHP-FPMはPHPコードの解析と実行に焦点を当てています。どちらも独自の義務を果たし、互いに干渉しず、システム全体の安定性とパフォーマンスを大幅に改善します。たとえば、PHPプロセスがクラッシュしたとしても、Nginxは依然として正常に実行できますが、PHPリクエストを処理できず、Webサービス全体がダウンしません。

MAC環境での一般的なNginxおよびPHP構成トラップとソリューション

MacでNginxとPHPを構成しますが、HomeBrewはプロセスを大幅に簡素化しましたが、一部の場所ではまだ簡単に行き詰まっています。私は個人的に多くに出会いました。要約すると、おそらくいくつかの一般的なトラップと対応するソリューションがあります。

1.ポート競合の問題： Nginxはデフォルトでポート80を聴きますが、Macが既にApache（MacOSでコムが入っている）または他のサービスがポート80を占有している場合、Nginxは開始されません。

• 解決策：最も直接的な方法は、NGINX構成を変更して、8080、8000、または8888などの頻繁に使用されるポートをリッスンさせることですnginx.confのserverブロックのlisten命令を変更するだけです。または、Apacheが必要ないと確信している場合は、無効にすることができます： sudo apachectl stop 。

2。ファイル許可の問題： NGINXまたはPHP-FPMは、Webサイトファイルを読み取ることができないか、PHPがログまたはキャッシュファイルに書き込むことができません。これは、ユーザーの許可とファイルシステムの許可が微妙な場合があるため、Macで特に一般的です。

• ソリューション戦略：
  • Webサイトのルートディレクトリ（ rootディレクティブによって指されるディレクトリ）とその中のファイルとフォルダーが、NGINXを実行しているユーザー（通常_wwwまたはnobody ）が許可を読み取っていることを確認してください。
  • PHPが書き込む必要があるディレクトリ（ログ、キャッシュなど）の場合、PHP-FPMを実行しているユーザーに書き込み許可があることを確認してください。最も簡単なラフな方法はchmod -R 777ですが、それはベストプラクティスではありません。より安全な方法は、 chown -R _www:_www /path/to/your/project 、そしてchmod -R 755 /path/to/your/projectおよびchmod -R 775 /path/to/your/project/cache_or_log_dirです。

3。PHP-FPMが実行されていないか、構成が不一致ではありません： NGINXにはfastcgi_passが設定されていますが、PHP-FPMは開始されていません。または、NGINXが指すFASTCGIアドレス（ポートまたはソケットパス）は、PHP-FPMの実際のリスニングと矛盾しています。

• ソリューション戦略：
  • PHP-FPMが開始されたかどうかを確認します。BREW brew services list phpまたはphp@版本号のステータスがstartedかどうかを確認します。そうでない場合、 brew services start php 。
  • php-fpm構成ファイル（通常/usr/local/etc/php/版本号/php-fpm.d/www.conf ）を確認し、 listenディレクティブを見つけ、TCPポート（ 127.0.0.1:9000 ）を聴いているかどうかを確認するか、Unixソケット（ listen = /usr/local/var/run/php-fpm.sock ）。次に、nginx構成のfastcgi_passが正確に一致していることを確認します。

4。NGINX構成構文エラー： NGINX構成は非常に厳格です。小さなセミコロンが逃したか、ブラケットの不一致により、Nginxが開始されません。

• ソリューション戦略： nginx構成を変更した後、最初にnginx -tコマンドを使用して、構成ファイルの構文が正しいかどうかをテストする必要があります。 syntax is okあり、 test is successful場合、Nginxを自信を持って再起動できます。

5。 rootまたはindexファイル構成エラー： nginxはWebサイトファイルを見つけることができない、またはindex.php見つかりません。

• 解決策： nginx.confのroot指令によって指されたパスが正しいかどうかを再確認し、 index指令にindex.phpが含まれており、順序が正しいことを確認してください。

問題が発生した場合、最初のステップは、常にnginxのエラーログ（通常/usr/local/var/log/nginx/error.log ）とphp-fpmのログを確認することです。これらのログファイルは、何が間違っているのかを示します。それは、許可、ポートの競合、またはPHPコードエラーが不十分なためです。経験から、ロギングは問題を解決するための最良のガイドであることがわかります。

以上がNGINXとPHPサービスの組み合わせを構成するためにMACOSを使用してPHP Nginx環境を構築する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。