PHP設定の変更

ServBayにはPHP環境が組み込まれており、柔軟な設定オプションが提供されています。この記事では、ServBayでPHP設定を変更する方法について詳しく説明します。php.iniとphp-fpm.confファイルの場所や一般的な設定項目についても紹介します。PHPのバージョンによって、これらのファイルは/Applications/ServBay/etc/php/<version>ディレクトリに配置されています。さらに、PHPモジュールのロード設定ファイル（例：xdebug.ini）は、/Applications/ServBay/etc/php/<version>/conf.dディレクトリにあります。

重要な注意

設定ファイルを手動で変更しないでください。すべての設定ファイルはServBayによって自動生成され、手動で変更すると上書きされるリスクがあります。設定変更はUI画面を通じて行ってください。

概要

ServBayでは、PHPの設定ファイルがバージョンごとに異なるディレクトリに保存されています。例えば、PHP 8.3の設定ファイルは/Applications/ServBay/etc/php/8.3ディレクトリにあります。これらの設定ファイルの詳細な場所は以下の通りです：

• php.ini：/Applications/ServBay/etc/php/8.3/php.ini
• php-fpm.conf：/Applications/ServBay/etc/php/8.3/php-fpm.conf
• PHPモジュールのロード設定ファイル：/Applications/ServBay/etc/php/8.3/conf.d/

ServBay UI画面を通じての変更

ServBayには強力なグラフィカル管理インターフェースが備わっており、ユーザーは管理画面で直接異なる設定パラメータを変更できます。保存をクリックすると、変更が自動的に適用され、すぐに有効になります。手動でパラメータを編集する手間が省けます。

左のナビゲーションで言語を開き、変更したいPHPバージョンを選択することで、右側に編集メニューが表示されます。典型的なインターフェースは以下の図のようになります。

インターフェースは、PHP-FPM設定、PHP設定、PHPモジュール設定の3つの異なる設定項目に分かれています。以下でそれぞれについて説明します。

PHP FPM

ヒント

php-fpm.confは、WebサービスでのPHPの動作を設定し、すべての設定はphp.iniの設定よりも優先されます（上書き）。

ただし、ここでの設定はCLIでのコード実行には影響しません。

まず、PHP FPM設定画面です。CaddyやNGINXに関係なく、ServBay WebサービスのPHPはFPM方式で動作します。この画面では、FPMプロセスの数、メモリ制限、ログのエラーレベル、ブラウザでのエラー情報の表示可否などを設定できます。

例えば、WebでMemory Limitを64Mから1Gに変更したい場合、Memory Limitのドロップダウンメニューから1Gを選択し、保存するだけで変更が可能です。この変更はphp.iniの設定には影響せず、CLI方式でのPHPスクリプト実行時にはphp.iniの設定が適用されます。

仮にphp.iniでのMemory Limitが512M、PHP FPMでのMemory Limitが128Mに設定されている場合、同じスクリプトがCLIで実行されると512Mまでメモリを使用できますが、Webで実行されると128Mまでしか使用できません。

php.ini

ヒント

php.iniの設定はグローバルで、CLIとWebの両方の動作に対応しています。 ただし、php.iniの設定はWebではphp-fpm.confによって上書きされることがあります。

PHP設定部分はphp.iniの設定項目に対応しており、これはPHPのコア設定ファイルです。

ここでは、php.iniでのオプションの大部分を設定できます。例えば、postフォームのpost_max_sizeやアップロードファイルサイズに影響するupload_max_filesize。また、関数やクラスを無効化するためのdisable_functionsおよびdisable_classesなどがあります。

設定はグローバルなものであるため、open_basedirを設定する場合は、ウェブサイトのプロジェクトを/Applications/ServBay/wwwに統一して配置し、複数のディレクトリを設定しなくて済むようにすると良いでしょう。

詳細な設定項目については、php.iniの公式ドキュメントを参照してください。

拡張モジュール

ServBayには、多くの一般的なPHP拡張モジュールが組み込まれており、xDebug、OPcache、Image Magick、Redis、MongoDB、Phalcon、Swooleなどがあります。詳細なモジュールリストはPHP 拡張モジュールリストを参照してください。

PHP拡張モジュールの有効化は非常に簡単で、スイッチをクリックし、保存をクリックするだけです。xDebugなど追加の設定項目があるモジュールも、設定項目を直接簡単に変更できます。

手動編集による設定変更

WARNING

手動での設定ファイル編集は、一時的にいくつかの設定項目を変更する場合にのみ適しています。

PHPの設定ファイルを手動で変更することはお勧めしません。すべての変更はServBayによって上書きされてしまいます。

php.ini設定

php.iniファイルはPHPの主な設定ファイルで、PHPのさまざまな実行時オプションを設定するために使用されます。

よくある設定項目

以下は、いくつかの一般的なphp.iniの設定項目とその変更方法です：

1. メモリ制限の変更：

   memory_limit = 256M

2. アップロードファイルのサイズ制限の変更：

   upload_max_filesize = 50M
   post_max_size = 50M

3. タイムゾーン設定の変更：

   date.timezone = "Asia/Tokyo"

4. エラー表示の有効化：

   display_errors = On
   error_reporting = E_ALL

5. 最大実行時間の変更：

   max_execution_time = 300

php-fpm.conf設定

php-fpm.confファイルは、PHP-FPM（FastCGI Process Manager）の実行パラメータを設定するために使用されます。

よくある設定項目

以下は、いくつかの一般的なphp-fpm.confの設定項目とその変更方法です：

1. プロセスプール設定の変更：

   [www]
   listen = /Applications/ServBay/tmp/php-cgi-8.3.sock
   listen.backlog = -1
   listen.allowed_clients = 127.0.0.1
   ;listen.owner = www
   ;listen.group = www
   listen.mode = 0666
   ;user = www
   ;group = www
   pm = dynamic
   pm.max_children = 10
   pm.start_servers = 2
   pm.min_spare_servers = 1
   pm.max_spare_servers = 6
   pm.max_requests = 1024
   pm.process_idle_timeout = 10s

2. スローログの有効化：

   request_slowlog_timeout = 5s
   slowlog = /Applications/ServBay/logs/php/8.3/slow.log

3. エラーログのパスの変更：

   error_log = /Applications/ServBay/logs/php/8.3/errors.log

PHPモジュールのロード設定

PHPモジュールのロード設定ファイルは、/Applications/ServBay/etc/php/8.3/conf.d/ディレクトリにあります。例として、xdebug.iniはXdebug拡張を設定するためのファイルです。

xdebug.iniの例

以下は、xdebug.iniファイルの例です：

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

PHPの再起動

PHP設定ファイルを変更した後、変更を有効にするためにPHPサービスを再起動する必要があります。ServBayの管理画面またはservbayctlコマンドラインツールを使用して再起動できます。

ServBay管理画面を通じて再起動

1. ServBay管理画面を開きます。
2. サービスに移動します。
3. 対応するバージョンのPHPサービスを見つけ、再起動ボタンをクリックします。

servbayctlによる再起動

servbayctlコマンドラインツールを使用して簡単にPHPサービスを再起動できます：

servbayctl restart php 8.3

まとめ

ServBayでは、PHPの設定ファイルは/Applications/ServBay/etc/php/<version>ディレクトリにあります。php.iniとphp-fpm.confを含みます。PHPモジュールのロード設定ファイルは/Applications/ServBay/etc/php/<version>/conf.d/ディレクトリにあります。これらの設定ファイルを変更した後、ServBayの管理画面またはservbayctlコマンドラインツールを使用してPHPサービスを再起動し、変更を有効にすることができます。