Windows レジストリによる場所の指定

Windows では、PHP がメインの設定ファイルの場所を、レジストリの IniFilePath の値から取得することがあります。

どのレジストリキーを調べるかは、PHP のバージョンと、 PHP と Windows がそれぞれ 32bit か 64bit かによって変わります。

32bit OS 上の 32bit ビルドの PHP、 もしくは 64bit OS 上の 64bit ビルドの PHP では、 以下のレジストリキーを順に調べます。

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y.z]

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y]

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x]

• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP]

キー名の x、y、 z は、それぞれ PHP のメジャーバージョン、 マイナーバージョン、リリース番号を表します。 これらのキーのいずれかに IniFilePath の値があれば、最初に見つかった値を使います。

64bit OS 上の 32bit ビルドの PHP では、 以下のレジストリキーを順に調べます。

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP\x.y.z]

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP\x.y]

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP\x]

• [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP]

これらのキーのいずれかに IniFilePath の値があれば、最初に見つかった値を使います。

設定ファイルの構文

php.ini の中で環境変数を参照するには、次のようにします。 PHP 8.3.0 以降では、参照する変数が未定義の場合にフォールバックする値を 指定できるようになりました。

; 環境変数 PHP_MEMORY_LIMIT を利用します
memory_limit = ${PHP_MEMORY_LIMIT}
; 環境変数 PHP_MAX_EXECUTION_TIME が未定義の場合、30 にフォールバックします
max_execution_time = ${PHP_MAX_EXECUTION_TIME:-30}

拡張モジュールに対する php.ini ディレクティブは、 各拡張モジュールのドキュメントで解説されています。 コア ディレクティブ （PHP 本体に対するディレクティブ）のリストは付録にまとめられています。 ただし、（更新の都合上）すべての PHP ディレクティブが 本マニュアル中で解説されている訳ではありません。 使っているバージョンの PHP で指定可能なすべてのディレクティブについては、 php.ini ファイル内に詳細なコメントが記されていますので、参照ください。 もしくは、Git から入手可能な »  最新の php.ini も有用でしょう。

; 引用符をつけないセミコロン(;)の後のテキストは、すべて無視されます
[php] ; セクションマーカ (角括弧の中のテキスト) は無視されます
; 論理値は、次のいずれかで指定します
;    true, on, yes
; または false, off, no, none
register_globals = off
magic_quotes_gpc = yes

; 文字列を二重引用符で括ることも可能です
include_path = ".:/usr/local/lib/php"

; バックスラッシュは他の文字と同様に処理されます
include_path = ".;c:\php\lib"

ini ファイル内で既存の ini 変数を参照することが可能です。 例: open_basedir = ${open_basedir} ":/new/dir"

スキャンディレクトリ

PHP の設定で、php.ini を読んだ後に .ini ファイルを探すディレクトリを指定できます。 これは、コンパイル時のオプション --with-config-file-scan-dir で設定します。 このスキャンディレクトリは実行時に上書きできます。 環境変数 PHP_INI_SCAN_DIR で指定します。

複数のディレクトリを指定するには、各プラットフォームのパス区切り文字 (Window や NetWare そして RISC OS の場合は ;、 その他のプラットフォームの場合は :。PHP が用いる値は定数 PATH_SEPARATOR で取得できます) を用います。PHP_INI_SCAN_DIR に空文字列が指定された場合は、 PHP のコンパイル時に --with-config-file-scan-dir で指定されたディレクトリもスキャンします。

指定されたディレクトリの中にあるファイルの中で、ファイル名が .ini で終わるすべてのファイルを、アルファベット順にスキャンします。 読み込まれたファイルの一覧とその順序を調べるには、 php_ini_scanned_files() を呼ぶか、あるいは --ini オプションつきで PHP を実行します。

PHP のコンパイル時に --with-config-file-scan-dir=/etc/php.d
を指定しており、パス区切り文字が : であるものとします

$ php
  PHP は /etc/php.d/*.ini を設定ファイルとして読み込みます。

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d php
  PHP は /usr/local/etc/php.d/*.ini を設定ファイルとして読み込みます。

$ PHP_INI_SCAN_DIR=:/usr/local/etc/php.d php
  PHP はまず /etc/php.d/*.ini を設定ファイルとして読み込み、
  続いて /usr/local/etc/php.d/*.ini も設定ファイルとして読み込みます。

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php
  PHP はまず /usr/local/etc/php.d/*.ini を設定ファイルとして読み込み、
  続いて /etc/php.d/*.ini を設定ファイルとして読み込みます。