配置文件

配置文件 (php.ini) 在 PHP 启动时读取。对于 PHP 的服务器模块版本，这仅在 Web 服务器启动时发生一次。对于 CGI 和 CLI 版本，它在每次调用时都会发生。

php.ini 在以下位置（按顺序）中搜索

• SAPI 模块特定位置 (PHPIniDir 指令在 Apache 2 中，-c 命令行选项在 CGI 和 CLI 中)
• PHPRC 环境变量。
• 配置文件的存放位置可以通过不同的PHP版本进行设置。注册表键的根目录取决于已安装的操作系统和 PHP 的 32 位或 64 位属性。对于 32 位操作系统上的 32 位 PHP 或 64 位操作系统上的 64 位 PHP，使用 [(HKEY_LOCAL_MACHINE\SOFTWARE\PHP]，对于 64 位操作系统上的 32 位版本 PHP，使用 [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP]] 代替。对于相同位数的安装，将按以下顺序检查以下注册表键：[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y.z]、[HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y] 和 [HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x]，其中 x、y 和 z 表示 PHP 的主版本、次版本和发行版本。对于 64 位操作系统上的 32 位版本 PHP，将按以下顺序检查以下注册表键：[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6421Node\PHP\x.y.z]、[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6421Node\PHP\x.y] 和 [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6421Node\PHP\x]，其中 x、y 和 z 表示 PHP 的主版本、次版本和发行版本。如果在这些键中的任何一个中都有 IniFilePath 的值，则找到的第一个值将用作 php.ini 的位置（仅限 Windows）。
• [HKEY_LOCAL_MACHINE\SOFTWARE\PHP] 或 [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\PHP]，IniFilePath 的值（仅限 Windows）。
• 当前工作目录（CLI 除外）。
• Web 服务器的目录（对于 SAPI 模块），或 PHP 的目录（在 Windows 中否则）。
• Windows 目录 (C:\windows 或 C:\winnt)（对于 Windows），或 --with-config-file-path 编译时选项。

如果 php-SAPI.ini 存在（其中 SAPI 是正在使用的 SAPI，例如，php-cli.ini 或 php-apache.ini），则使用它而不是 php.ini。可以使用 php_sapi_name() 确定 SAPI 名称。

注意:

Apache Web 服务器在启动时将目录更改为根目录，导致 PHP 尝试从根文件系统读取 php.ini（如果存在）。

可以使用环境变量在 php.ini 中使用，如下所示。

; PHP_MEMORY_LIMIT is taken from environment
memory_limit = ${PHP_MEMORY_LIMIT}

由扩展处理的 php.ini 指令在扩展本身的各个页面上进行了说明。可以在附录中找到 核心指令的列表。并非所有 PHP 指令都一定会在本手册中进行说明：有关 PHP 版本中可用指令的完整列表，请阅读您已注释的 php.ini 文件。或者，您可能会发现 » 来自 Git 的最新 php.ini 也很有用。

; any text on a line after an unquoted semicolon (;) is ignored
[php] ; section markers (text within square brackets) are also ignored
; Boolean values can be set to either:
;    true, on, yes
; or false, off, no, none
register_globals = off
track_errors = yes

; you can enclose strings in double-quotes
include_path = ".:/usr/local/lib/php"

; backslashes are treated the same as any other character
include_path = ".;c:\php\lib"

可以从 .ini 文件中引用现有的 .ini 变量。例如：open_basedir = ${open_basedir} ":/new/dir"。

Assuming PHP is configured with --with-config-file-scan-dir=/etc/php.d,
and that the path separator is :...

$ php
  PHP will load all files in /etc/php.d/*.ini as configuration files.

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d php
  PHP will load all files in /usr/local/etc/php.d/*.ini as
  configuration files.

$ PHP_INI_SCAN_DIR=:/usr/local/etc/php.d php
  PHP will load all files in /etc/php.d/*.ini, then
  /usr/local/etc/php.d/*.ini as configuration files.

$ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php
  PHP will load all files in /usr/local/etc/php.d/*.ini, then
  /etc/php.d/*.ini as configuration files.