语言选项

以下是配置指令的简短说明。

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 等包含多字节字符串数据中特殊字符的字符编码。UTF-8、EUC 等与 ISO-8859-1 兼容的编码不需要此选项。

启用 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（字节顺序标记）并查看文件是否包含有效的多字节字符。此检测在处理 __halt_compiler() 之前执行。仅在 Zend 多字节模式下可用。

zend.signal_check bool

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

exit_on_timeout bool

这是一个仅限 Apache1 mod_php 的指令，如果发生 PHP 执行超时，它会强制 Apache 子进程退出。这种超时会在 Apache1 中导致内部 longjmp() 调用，这可能会使某些扩展处于不一致的状态。通过终止进程，任何未完成的锁或内存都将被清理。

资源限制

以下是配置指令的简短说明。

memory_limit int

这将设置脚本允许分配的最大内存量（以字节为单位）。这有助于防止编写不良的脚本占用服务器上的所有可用内存。请注意，要没有内存限制，请将此指令设置为 -1。

当使用 int 时，值以字节为单位。也可以使用此常见问题解答中描述的简写符号。

另请参见：max_execution_time。

性能调整

注意:

使用 open_basedir 将禁用 realpath 缓存。

以下是配置指令的简短说明。

realpath_cache_size int

决定PHP使用的realpath缓存的大小。对于PHP打开许多文件的系统，应增加此值以反映执行的文件操作数量。

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

缓存条目数据所需的大小取决于系统。

realpath_cache_ttl int

为给定文件或目录缓存realpath信息的时间长度（以秒为单位）。对于文件很少更改的系统，请考虑增加此值。

数据处理

以下是配置指令的简短说明。

arg_separator.output string

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

arg_separator.input string

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

注意:

此指令中的每个字符都被视为分隔符！

variables_order string

设置EGPCS（Environment，Get，Post，Cookie 和 Server）变量解析的顺序。例如，如果将variables_order设置为"SP"，则PHP将创建超全局变量$_SERVER和$_POST，但不会创建$_ENV，$_GET和$_COOKIE。设置为""表示不会设置任何超全局变量。

警告

在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变量将在首次使用时（Just In Time）创建，而不是在脚本启动时创建。如果脚本中未使用这些变量，则启用此指令将提高性能。

警告

在编译时检查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时，值以字节为单位测量。也可以使用此常见问题解答中描述的简写表示法。 如果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	当内容类型为application/x-www-form-urlencoded或未在PHP中注册时，post_max_size = 0不会禁用限制。
5.3.2 , 5.2.12	通过将post_max_size设置为0来允许无限的POST大小。

auto_prepend_file string

指定在主文件之前自动解析的文件名。该文件包含的方式如同使用require函数调用一样，因此使用include_path。

特殊值none禁用自动预置。

auto_append_file string

指定在主文件之后自动解析的文件名。该文件包含的方式如同使用require函数调用一样，因此使用include_path。

特殊值none禁用自动附加。

注意：如果脚本使用exit()终止，则不会发生自动附加。

default_mimetype string

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

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

default_charset string

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

所有版本的PHP都将此值用作PHP发送的默认Content-Type标头中的字符集，除非标头被对header()的调用覆盖。

不建议将default_charset设置为empty值。

input_encoding string

此设置用于mbstring和iconv等多字节模块。默认为empty。

output_encoding string

此设置用于mbstring和iconv等多字节模块。默认为empty。

internal_encoding string

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

路径和目录

以下是配置指令的简短说明。

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 路径中使用 . 允许相对包含，因为它表示当前目录。但是，显式使用 include './file' 比让 PHP 总是检查每个 include 的当前目录效率更高。

注意:

.ini 文件也可以访问 ENV 变量。因此，可以使用 ${LOGIN} 和 ${USER} 来引用主目录。

环境变量可能因服务器 API 而异，因为这些环境可能不同。

示例 #3 使用 ${USER} 环境变量的 Unix include_path

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

open_basedir 字符串

将 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 字符串

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

user_ini.cache_ttl 整数

user_ini.filename 字符串

user_dir 字符串

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

extension_dir 字符串

PHP 应该在哪个目录中查找动态加载的扩展。建议指定绝对路径。另见：enable_dl 和 dl()。

extension 字符串

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

zend_extension 字符串

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

cgi.check_shebang_line 布尔值

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

cgi.discard_path 布尔值

如果启用此选项，则可以安全地将 PHP CGI 二进制文件放置在 Web 树之外，并且人们将无法规避 .htaccess 安全性。

cgi.fix_pathinfo 布尔值

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

cgi.force_redirect 布尔值

在大多数 Web 服务器下以 CGI 运行 PHP 时，cgi.force_redirect 是必要的安全措施。如果未定义，PHP 默认情况下会启用它。您可以自担风险将其关闭。

注意:

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

cgi.nph 布尔值

如果启用 cgi.nph，它将强制 cgi 在每次请求时都发送 Status: 200。

cgi.redirect_status_env 字符串

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

注意:

设置此变量可能会导致安全问题，请先了解您在做什么。

cgi.rfc2616_headers 整数

告诉 PHP 发送 HTTP 响应代码时使用哪种类型的标头。如果设置为 0，PHP 将发送 » RFC 3875 “Status:” 标头，Apache 和其他 Web 服务器都支持该标头。当此选项设置为 1 时，PHP 将发送符合 » RFC 2616 的标头。

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

除非您知道自己在做什么，否则请将其设置为 0。

fastcgi.impersonate 字符串

IIS（基于 WINNT 的操作系统）下的 FastCGI 支持模拟调用客户端的安全令牌的功能。这允许 IIS 定义请求在其下运行的安全上下文。Apache 下的 mod_fastcgi 目前不支持此功能 (2002 年 3 月 17 日) 在 IIS 下运行时设置为 1。默认为零。

fastcgi.logging 布尔值

使用 FastCGI 时启用 SAPI 日志记录。默认为启用日志记录。

文件上传

以下是配置指令的简短说明。

file_uploads 布尔值

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

upload_tmp_dir 字符串

用于存储文件上传文件的临时目录。必须可由运行 PHP 的用户写入。如果未指定，PHP 将使用系统的默认值。

如果此处指定的目录不可写，则 PHP 将回退到系统的默认临时目录。如果 open_basedir 已启用，则必须允许系统默认目录才能成功上传。

upload_max_filesize 整数

上传文件的最大大小。

post_max_size 必须大于此值。

当使用 int 时，值以字节为单位。也可以使用此常见问题解答中描述的简写符号。

max_file_uploads 整数

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

通用SQL

以下是配置指令的简短说明。

sql.safe_mode 布尔值

如果启用，指定默认值的数据库连接函数将使用这些值代替任何用户提供的参数。有关默认值的详细信息，请参阅相关连接函数的文档。

警告

此功能已于 PHP 7.2.0 中移除。

Windows 特定

以下是配置指令的简短说明。

windows.show_crt_warning bool

启用此指令后，将显示 Windows CRT 警告。