## php.ini 核心指令说明

该列表只包含可以配置 PHP 的核心 php.ini 指令。扩展的指令处理在各个扩展的文档页面分别列出和详细说明；比如，有关 session 指令可以在 sessions 页面找到。

> 注意:

> 当未加载 php.ini 时，使用以下列出的默认值；开发和生产环境的 php.ini 值可能会有所不同。

## 语言选项

语言和杂类配置选项
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
short_open_tag | "1" | `INI_PERDIR` |
precision | "14" | `INI_ALL` |
serialize_precision | "-1" | `INI_ALL` | 在 PHP 7.1.0 以前，默认值为 17。
disable_functions | "" | 仅为 `INI_SYSTEM` |
disable_classes | "" | 仅为 php.ini |
exit_on_timeout | "" | `INI_ALL` |
expose_php | "1" | 仅为 php.ini |
hard_timeout | "2" | `INI_SYSTEM` | 从 PHP 7.1.0 起可用
zend.exception_ignore_args | "0" | `INI_ALL` | 从 PHP 7.4.0 起可用
zend.multibyte | "0" | `INI_ALL` |
zend.script_encoding | NULL | `INI_ALL` |
zend.detect_unicode | NULL | `INI_ALL` |
zend.signal_check | "0" | `INI_SYSTEM` |
zend.assertions | "1" | 有限制的 `INI_ALL` |
zend.exception_string_param_max_len | "15" | `INI_ALL` | 自 PHP 8.0.0 起可用。

这是配置指令的简短说明。

`short_open_tag` bool

  告诉 PHP 是否允许 PHP 开放标签的缩写形式（`<? ?>`）。如果要 PHP 和 XML 结合使用，可以禁用此选项以便嵌入使用 `<?xml ?>`。否则还可以通过 PHP 来打印，例如：`<?php echo '<?xml version="1.0"?>'; ?>`。此外，如果禁用，必须使用 PHP 开放标签的完整形式（`<?php ?>`）。

  > 注意:

  > 本指令不会影响简写 `<?=`，因为它始终可用。

`precision` int
  浮点数中显示有效数字的位数。`-1` 表示将使用增强算法来四舍五入此类数字。
`serialize_precision` int
  序列化浮点数时存储的有效数字的位数。`-1` 表示将使用增强算法来四舍五入此类数字。
`expose_php` bool

  确定是否向外界公开服务器上安装了 PHP，在 HTTP 标头中包含 PHP 版本号（例如：X-Powered-By: PHP/5.3.7）。

`disable_functions` string
  此指令允许禁用某些函数。它接受逗号分隔的函数名列表作为参数。 从 PHP 8.0.0 开始，禁用函数会删除其定义，允许用户重新定义它。 在 PHP 8.0.0 之前，禁用函数只是阻止函数被调用。 此指令仅能禁用 内置函数。不能影响用户自定义函数。 本指令必须在 php.ini 中设置。不能在 httpd.conf 中设置。
`disable_classes` string

  此指令允许禁用某些类。它接受逗号分隔的类名列表作为参数。 禁用类只是阻止类的实例化。

  使用此指令只能禁用内部类。用户定义的类不受影响。

  本指令必须在 php.ini 中设置。不能在 httpd.conf 中设置。
`zend.assertions` int
  当设置为 `1` 时，生成断言代码并执行（开发模式）。当设置为 `0` 时，将生成断言代码，但运行时会跳过（不执行）。当设置为 `-1` 时，不生成断言代码，使断言成本为零（生产模式）。

  > 注意:

  > 如果在生产模式下启动进程，则 zend.assertions 不能在运行时修改，因为未生成断言代码。

  > 如果在开发模式下启动进程，则 zend.assertions 不能在运行时设置为 `-1`。

`zend.exception_string_param_max_len` int
  字符串化栈追踪中字符串函数参数的最大长度。必须介于 `"0"` 和 `"1000000"` 之间。
`hard_timeout` int

  当命中 max_execution_time 中设置的超时的时候，PHP 运行时将会优雅的销毁资源。如果在这时卡住，硬超时将计时设置的秒数。当命中硬超时的时候，PHP 将异常退出。当设置为 0 时，硬超时始终不会激活。

  当 PHP 因硬超时而停止时，它看起来像这样：

      Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0

`zend.exception_ignore_args` bool

  从异常产生的栈中排除参数。

`zend.multibyte` bool

  启用多字节编码的源文件解析。启用 zend.multibyte 是使用 SJIS、BIG5 等在多字节字符串数据中包含特殊字符的字符编码所必需的。ISO-8859-1 兼容的编码，如 UTF-8、EUC 等，则不需要这个选项。

  启用 zend.multibyte 需要 mbstring 扩展可用。

`zend.script_encoding` string

  除非在脚本顶部出现 declare(encoding=...) 指令，否则将会使用此值。当使用不兼容 ISO-8859-1 的编码时，必须同时使用 zend.multibyte 和 zend.script_encoding。

  文本字符串将从 zend.script_encoding 直译为 mbstring.internal_encoding，就像调用了 mb_convert_encoding() 一样。

`zend.detect_unicode` bool

  检查 BOM（Byte Order Mark，即字节顺序标记）并查看文件是否包含有效的多字节字符。此检测可以在处理 __halt_compiler() 执行。仅在 Zend 多字节模式下使用。

`zend.signal_check` bool

  在关闭时检查替换的信号处理程序。

`exit_on_timeout` bool

  这是 Apache1 mod_php-only 指令，如果 PHP 执行超时，会强制 Apache 子程序退出。这样的超时会导致 Apache1 内部的 longjmp() 调用，从而使一些扩展处于不一致的状态。通过终止进程，将会清除任何未完成的锁或内存。

## 资源限制

资源限制
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
memory_limit | "128M" | `INI_ALL` |

这是配置指令的简短说明。

`memory_limit` int

  设置了允许脚本分配的最大内存量，以字节为单位。这有助于防止写得不好的脚本吃掉服务器上所有可用的内存。请注意，如果不需要内存限制，请将此指令设置为 `-1`。

  当使用 int 时, 其值以字节来衡量。还可以使用在 FAQ 中描述的速记符。

请参阅：max_execution_time。

## 性能调整

性能调整
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
realpath_cache_size | "4M" | `INI_SYSTEM` | PPHP 7.0.16 和 7.1.2 之前，默认值为 `"16K"`
realpath_cache_ttl | "120" | `INI_SYSTEM` |

> 注意:

> 启用 open_basedir 将会 禁用 realpath 缓存。

这是配置指令的简短说明。

`realpath_cache_size` int

  设定 PHP 使用的 realpath 缓存的大小。在 PHP 打开很多文件的系统中，这个值应该增加，以优化执行文件操作的数量。

  这里的大小表示存储的路径字符串的总字节数，加上与缓存条目相关的数据大小。这意味着，为了在缓存中存储更长的路径，缓存大小必须更大。这个值不直接控制可以缓存的不同路径的数量。

  缓存输入数据所需的大小取决于操作系统。

`realpath_cache_ttl` int

  缓存指定文件或目录的真实路径信息的持续时间（以秒为单位）。对于很少改变文件的系统，可以考虑增加该值。

## 数据处理

数据处理配置选项
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
arg_separator.output | "&" | `INI_ALL` |
arg_separator.input | "&" | `INI_PERDIR` |
variables_order | "EGPCS" | `INI_PERDIR` |
request_order | "" | `INI_PERDIR` |
auto_globals_jit | "1" | `INI_PERDIR` |
register_argc_argv | "1" | `INI_PERDIR` |
enable_post_data_reading | "1" | `INI_PERDIR` |
post_max_size | "8M" | `INI_PERDIR` |
auto_prepend_file | NULL | `INI_PERDIR` |
auto_append_file | NULL | `INI_PERDIR` |
default_mimetype | "text/html" | `INI_ALL` |
default_charset | "UTF-8" | `INI_ALL` |
input_encoding | "" | `INI_ALL` |
output_encoding | "" | `INI_ALL` |
internal_encoding | "" | `INI_ALL` |

这是配置指令的简短说明。

`arg_separator.output` string

  在 PHP 生成的 URL 中用来分隔参数的分隔符。

`arg_separator.input` string

  PHP 用于将输入的 URL 解析为变量的分隔符列表。

  > 注意:

  > 本指令中的每一个字符都被视为分隔符！

`variables_order` string

  设置 EGPCS（`E`nvironment、`G`et、`P`ost、`C`ookie 和 `S`erver）变量解析的顺序。例如，如果 variables_order 设置为 `"SP"`，然后 PHP 将创建 superglobals $_SERVER 和 $_POST，但不会创建 $_ENV、$_GET 和 $_COOKIE。设置为 "" 意味着不会设置 superglobals。

  警告

  在 CGI 和 FastCGI SAPI 中，$_SERVER 也包含环境的值；`S` 始终等同于 `ES`，而不关心 `E` 在该指令中的位置。

  > 注意:

  > $_REQUEST 的内容和顺序也受到此指令的影响。

`request_order` string

  该指令描述了 PHP 将 GET、POST 和 Cookie 变量注册到 _REQUEST 数组中的顺序。注册是从左到右完成的，新值覆盖旧值。

  如果未设置此指令，则 variables_order 用于 $_REQUEST 内容。

  请注意，出于安全考虑，默认分发的 php.ini 文件不包含 cookie 的 `'C'`。

`auto_globals_jit` bool

  启用后，SERVER、REQUEST 和 ENV 变量在首次使用时（即时）创建，而不是在脚本启动时创建。如果这些变量未在脚本中使用，启用此指令将提高性能。

  警告

  在编译期间检查 SERVER、REQUEST 和 ENV 变量的使用，因此通过可变变量使用它们将不会使其初始化。

`register_argc_argv` bool
  告诉 PHP 是否声明 argv & argc 变量（将包含 GET 信息）。 另请参阅命令行。
`enable_post_data_reading` bool
  禁用这个选项会导致不会填充 $_POST 和 $_FILES。读取 postdata 的唯一方法是通过 php://input 流封装协议。这对于代理请求或以高效内存的方式处理 POST 数据很有用。
`post_max_size` int
  设置允许 post 数据的最大大小。此设置也会影响文件上传。要上传大文件，此值必须大于 upload_max_filesize。 一般来说，memory_limit 应该大于 `post_max_size`。 当使用 int 时, 其值以字节来衡量。还可以使用在 FAQ 中描述的速记符。 如果 post 数据的大小大于 post_max_size，则 $_POST 和 $_FILES 超全局变量为空。这可以通过多种方式进行跟踪，例如通过将 $_GET 变量传递给处理数据的脚本，即 `<form action="edit.php?processed=1">`，然后检查是否设置了 $_GET['processed']。

  > 注意:

  > PHP 允许使用字节值的快捷方式，包括 K（千）、M（兆）和 G（千兆）。如果使用其中任何一个，PHP 将自动进行转换。注意不要超过 32 位有符号整数限制（如果使用的是 32 位版本），因为这会导致脚本失败。

  `post_max_size` 变更日志
  版本 | 说明
  --- | ---
  5.3.4 | `post_max_size` = 0 will not disable the limit when the content type is application/x-www-form-urlencoded or is not registered with PHP.
  5.3.2 , 5.2.12 | Allow unlimited post size by setting `post_max_size` to 0.

`auto_prepend_file` string

  指定在主文件之前自动解析的文件名。included 该文件像是用 require 函数调用的一样，因此使用了 include_path。

  特殊值 `none` 禁用 auto-prepending。

`auto_append_file` string

  指定在主文件之后自动解析的文件名。included 该文件像是用 require 函数调用的一样，因此使用了 include_path。

  特殊值 `none` 禁用 auto-prepending。

  > 注意: 如果脚本以 exit() 终止，则不会发生 auto-append。

`default_mimetype` string

  默认情况下，PHP 将使用 Content-Type 标头输出媒体类型。只需将其设置为空即可禁用。

  PHP 内置默认媒体类型设置为 text/html。

`default_charset` string

  “UTF-8”是默认值，如果省略 `encoding` 参数，它的值将用作 htmlentities()、html_entity_decode() 和 htmlspecialchars() 的默认字符编码。 如果未设置 `iconv.input_encoding`、`iconv.output_encoding` 和 `iconv.internal_encoding` 配置选项，则 `default_charset` 的值也将用于设置 iconv 函数的默认字符集，如果 `mbstring.http_input` `mbstring.http_output` `mbstring.internal_encoding` 配置选项未设置，则也可用于 mbstring 函数。

  如果标头未通过调用 header() 覆盖，则所有版本的 PHP 都将使用此值作为 PHP 发送的默认 Content-Type 报头中的字符集。

  不推荐设置 `default_charset` 为空字符串。

`input_encoding` string

  此设置用于多字节模块，例如 mbstring 和 iconv。 默认为空。

`output_encoding` string

  此设置用于多字节模块，例如 mbstring 和 iconv。 默认为空。

`internal_encoding` string

  此设置用于多字节模块，例如 mbstring 和 iconv。 默认为空。 如果为空，则使用 default_charset。

## 路径和目录

路径和目录配置项
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
include_path | ".;/path/to/php/pear" | `INI_ALL` |
open_basedir | NULL | `INI_ALL` |
doc_root | NULL | `INI_SYSTEM` |
user_dir | NULL | `INI_SYSTEM` |
user_ini.cache_ttl | "300" | `INI_SYSTEM` |
user_ini.filename | ".user.ini" | `INI_SYSTEM` |
extension_dir | "/path/to/php" | `INI_SYSTEM` |
extension | NULL | php.ini only |
zend_extension | NULL | php.ini only |
cgi.check_shebang_line | "1" | `INI_SYSTEM` |
cgi.discard_path | "0" | `INI_SYSTEM` |
cgi.fix_pathinfo | "1" | `INI_SYSTEM` |
cgi.force_redirect | "1" | `INI_SYSTEM` |
cgi.nph | "0" | `INI_SYSTEM` |
cgi.redirect_status_env | NULL | `INI_SYSTEM` |
cgi.rfc2616_headers | "0" | `INI_ALL` |
fastcgi.impersonate | "0" | `INI_SYSTEM` |
fastcgi.logging | "1" | `INI_SYSTEM` |

这是配置指令的简短说明。

`include_path` string

  指定 require、include、fopen()、file()、readfile() 和 file_get_contents() 函数在其中查找文件的目录列表，格式类似于系统的 PATH 环境变量：目录列表，在 Unix 中使用冒号分隔，在 Windows 中使用分号分隔。

  在查找要包含的文件时，PHP 会分别考虑 include 路径中的每个条目。它将检查第一个路径，如果没有找到它，则检查下一个路径，直到找到包含的文件或返回 `E_WARNING` 或 `E_ERROR`。可以在运行时使用 set_include_path() 修改或设置 include 路径。

  示例 #1 Unix include_path

      include_path=".:/php/includes"

  示例 #2 Windows include_path

      include_path=".;c:\php\includes"

  在 include 路径中使用 `.` 允许相对 includes，因为其表示当前目录。但是，显式使用 `include './file'` 比让 PHP 始终检查当前目录中的每个 include 更有效。

  > 注意:

  > ENV 变量也可以在 .ini 文件中访问。因此，可以使用 `${LOGIN}` 和 `${USER}` 引用 home 目录。

  > 服务器 API 之间的环境变量可能会有所不同，因为这些环境可能不同。

  示例 #3 Unix include_path 使用 ${USER} env 变量

      include_path = ".:${USER}/pear/php"

`open_basedir` string

  将 PHP 可以访问的文件限制在指定的目录树中，包括文件本身。

  当脚本尝试访问文件系统时，例如使用 include 或 fopen() 时，将检查文件的位置。当文件位于指定的目录树之外时，PHP 将拒绝访问它。所有符号链接都已解析，因此无法通过符号链接避免此限制。如果文件不存在，则符号链接无法解析，文件名将与（已解析的）open_basedir 进行比较。

  open_basedir 不仅可以影响文件系统函数；例如，如果 `MySQL` 配置为使用 `mysqlnd` 驱动程序，则 `LOAD DATA INFILE` 将受到 open_basedir 的影响。PHP 的许多扩展功能都以这种方式使用 `open_basedir`。

  特殊值 `.` 表示脚本的工作目录将用作基础目录。然而，这有点危险，因为脚本的工作目录可以很容易地用 chdir() 更改。

  在 httpd.conf 中，open_basedir 可以被关闭（例如对于某些虚拟主机）。就像以相同方式使用“`php_admin_value open_basedir none`”的其它任何配置指令。

  在 Windows 中，用分号分隔目录。在所有其它系统上，用冒号分隔目录。现在 Apache 模块将自动继承来自父目录的 open_basedir 路径。

  open_basedir 指定的限制是目录名称，而不是前缀。

  默认设置是允许打开所有文件。

  > 注意: open_basedir 可以在运行时限制更多。这意味着如果在 php.ini 中将 open_basedir 设置为 `/www/`，则脚本可以在运行时使用 ini_set() 将配置限制到 `/www/tmp/`。当列出多个目录时，无论操作系统如何，都可以使用 `PATH_SEPARATOR` 常量作为分隔符。 自 PHP 8.3.0 起，当在运行时使用 ini_set() 设置时，open_basedir 不再接受包含父级目录（`..`）的路径

  > 注意:

  > 使用 open_basedir 会将 realpath_cache_size 设置为 `0`，从而禁用 realpath 缓存。

  警告

  `open_basedir` 只是额外的安全保障，并不全面，因此在需要安全性时并不能依赖它。

`doc_root` string

  PHP 在服务器上的“根目录”。仅在非空时使用。如果 PHP 未使用 FORCE_REDIRECT 编译，并且在任何 Web 服务器（IIS 除外）下将 PHP 作为 CGI 运行，则应设置 doc_root。另一种方法是使用下面的 cgi.force_redirect 配置。

`user_ini.cache_ttl` int

`user_ini.filename` string

`user_dir` string

  用户 home 目录中用于 PHP 文件的基本目录名，例如 public_html。

`extension_dir` string

  PHP 寻找可动态加载扩展的目录。建议指定绝对路径。参阅 enable_dl 和 dl()。

`extension` string

  PHP 启动时要加载的动态可加载扩展。

`zend_extension` string

  PHP 启动时要加载的动态可加载 Zend 扩展名（例如 XDebug）。

`cgi.check_shebang_line` bool

  控制 CGI PHP 是否检查以 `#!`（shebang）在运行脚本的顶部。如果脚本支持作为独立脚本和通过 PHP CGI 运行，则可能需要此行。如果此指令打开，CGI 模式下的 PHP 将跳过此行并忽略其内容。

`cgi.discard_path` bool

  如果启用，PHP CGI 二进制文件可以安全地放置在 web 树之外，用户将无法绕过 .htaccess 安全性。

`cgi.fix_pathinfo` bool

  为 CGI 提供真正的 `PATH_INFO`/`PATH_TRANSLATED` 支持。PHP 以前的行为是将 `PATH_TRANSLATED` 设置为 `SCRIPT_FILENAME`，而不去理解 `PATH_INFO` 是什么。有关 `PATH_INFO` 的更多信息，请参阅 CGI 规范。将此设置为 `1` 将导致 PHP CGI 修复其路径以符合规范。设置为 `0` 会导致 PHP 像以前一样运行。默认打开。应该修复脚本以使用 `SCRIPT_FILENAME` 而不是 `PATH_TRANSLATED`。

`cgi.force_redirect` bool

  cgi.force_redirect 是在大多数 Web 服务器下提供将 PHP 作为 CGI 运行的安全性所必需的。如果未定义，PHP 默认开启。也可以关闭它自行承担风险。

  > 注意:

  > Windows 用户：使用 IIS 时必须关闭此选项。对于 OmniHTTPD 或 Xitami，同样适用。

`cgi.nph` bool

  如果启用了 cgi.nph，对每个请求始终强制 cgi 发送 Status: 200。

`cgi.redirect_status_env` string

  如果打开了 cgi.force_redirect，并且没有在 Apache 或 Netscape (iPlanet) Web 服务器下运行，可能需要设置一个环境变量名称，PHP 将查找该名称以了解是否可以继续执行。

  > 注意:

  > 设置此变量可能会导致安全问题，首先要知道自己在做什么。

`cgi.rfc2616_headers` bool

  告诉 PHP 在发送 HTTP 响应 code 时使用什么样的 header 类型。如果禁用，PHP 将发送 Apache 和其他 Web 服务器支持的 » RFC 3875 "Status:" header。当启用时，PHP 将发送 » RFC 2616 兼容 header。

  如果启用此选项，并且在 CGI 环境（例如 PHP-FPM）中运行 PHP，则不应使用标准的 RFC 2616 样式的 HTTP 状态响应标头，而应使用其等效的 RFC 3875，例如不该使用 header("HTTP/1.0 404 Not found"); 应该使用 header("Status: 404 Not Found");

  除非知道自己在做什么，否则请将其禁用。

`fastcgi.impersonate` bool

  IIS 下的 FastCGI（在基于 WINNT 的操作系统上）支持模拟调用客户端的安全令牌的能力。这允许 IIS 定义请求在其下运行的安全上下文。Apache 下的 mod_fastcgi 目前不支持此功能（2002-03-17）。如果在 IIS 下运行，则启用。默认禁用。

`fastcgi.logging` bool

  使用 FastCGI 时打开 SAPI 日志记录。默认是启用日志记录。

## 文件上传

文件上传配置项
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
file_uploads | "1" | `INI_SYSTEM` |
upload_tmp_dir | NULL | `INI_SYSTEM` |
max_input_nesting_level | 64 | `INI_PERDIR` |
max_input_vars | 1000 | `INI_PERDIR` |
upload_max_filesize | "2M" | `INI_PERDIR` |
max_file_uploads | 20 | `INI_PERDIR` |

这是配置指令的简短说明。

`file_uploads` bool

  是否允许 HTTP 文件上传。参阅 upload_max_filesize、upload_tmp_dir 和 post_max_size 指令。

`upload_tmp_dir` string

  上传文件时用来存放文件的临时目录。必须允许运行 PHP 的任何用户写入。如果未指定，PHP 将使用系统默认值。

  如果此处指定的目录不可写，PHP 回退到系统默认临时目录。如果打开 open_basedir，然后允许系统临时目录才可以成功上传。

`upload_max_filesize` int

  上传文件的最大大小。

  post_max_size 必须大于此值。

  当使用 int 时, 其值以字节来衡量。还可以使用在 FAQ 中描述的速记符。
`max_file_uploads` int

  允许同时上传的最大文件数。提交时留空的上传字段不计入此限制。

## 常规 SQL

常规 SQL 配置项
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
sql.safe_mode | "0" | `INI_SYSTEM` | 自 PHP 7.2.0 起移除

这是配置指令的简短说明。

`sql.safe_mode` bool

  If turned on, database connection functions that specify default values will use those values in place of any user-supplied arguments. For details on the default values, see the documentation for the relevant connection functions.

  警告

  此功能自 PHP 7.2.0 起移除。

## Windows 专用

Windows 专用配置选项
名字 | 默认 | 可修改范围 | 更新日志
--- | --- | --- | ---
windows.show_crt_warning | "0" | `INI_ALL` |

这是配置指令的简短说明。

`windows.show_crt_warning` bool

  该指令在启用时显示 Windows CRT 警告。

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open