php.ini

时间  2021-08-13
标签 php html web sql windows 数组 浏览器 安全 服务器 cookie 栏目 PHP 繁體版
原文   原文链接
该列表只包含核心的 php.ini 配置选项。扩展的配置选项在各个扩展的文档页面分别被描述。有关 session 的选项能够在 sessions 页面找到。

Httpd 选项

表 I-3. Httpd 选项
名称 默认值 可修改范围 更新记录
async_send "0" PHP_INI_ALL  

语言选项

表 I-4. 语言和杂类配置选项
名称 默认值 可修改范围 更新记录
short_open_tag "1" PHP_INI_PERDIR 在 PHP <= 4.0.0 时是 PHP_INI_ALL。
asp_tags "0" PHP_INI_PERDIR 在 PHP <= 4.0.0 时是 PHP_INI_ALL。
precision "14" PHP_INI_ALL  
y2k_compliance "1" PHP_INI_ALL  
allow_call_time_pass_reference "1" PHP_INI_PERDIR 在 PHP <= 4.0.0 时是 PHP_INI_ALL。
expose_php "1" 仅可在 php.ini 中配置。  
zend.ze1_compatibility_mode "0" PHP_INI_ALL 从 PHP 5.0.0 起可用。
如下是配置选项的简要解释。
short_open_tag boolean
决定是否容许使用 PHP 代码开始标志的缩写形式（ <? ?>）。若是要和 XML 结合使用 PHP，能够禁用此选项以便于嵌入使用 <?xml ?>。不然还能够经过 PHP 来输出，例如： <?php echo '<?xml version="1.0"'; ?>。若是禁用了，必须使用 PHP 代码开始标志的完×××式（ <?php ?>）。
注意: 本指令也会影响到缩写形式 <?=，它和 <? echo 等价。使用此缩写须要 short_open_tag 的值为 On。
asp_tags boolean
除了一般的 <?php ?> 标志以外还容许使用 ASP 风格的标志 <% %>。这也包括了输出变量值的缩写 <%= $value %>。更多信息见 从 HTML 中分离一节。
注意: ASP 风格标志的支持是 3.0.4 版新加的。
precision integer
浮点数中显示有效数字的位数。
y2k_compliance boolean
强制 2000 年兼容（在不兼容的浏览器中会出问题）。
allow_call_time_pass_reference boolean
在函数调用时参数被按照引用传递时是否发出警告。此方法已不被同意并在 PHP/Zend 将来的版本中极可能再也不支持。鼓励使用的方法是在函数定义中指定哪些参数应该用引用传递。鼓励你们尝试关闭此选项并确保脚本可以正常运行，以确保该脚本也能在将来的版本中运行（每次使用此特性都会收到一条警告）。
在函数调用时经过引用传递参数是不推荐的，由于它影响到了代码的整洁。若是函数的参数没有声明做为引用传递，函数能够经过未写入文档的方法修改其参数。要避免其反作用，最好仅在函数声明时指定那个参数须要经过引用传递。
参见 引用的解释。
expose_php boolean
决定是否暴露 PHP 被安装在服务器上（例如在 Web 服务器的信息头中加上其签名）。没有任何安全上的威胁，只是让客户端可以知道是否在服务器中安装了 PHP。
zend.ze1_compatibility_mode boolean
启用 Zend 引擎 1(PHP 4) 兼容模式。这影响到了对象的复制、构造（无属性的对象会产生 FALSE 或 0）及 比较。此模式下，对象将以值传递，而不是默认的引用传递。

资源限制

表 I-5. 资源限制
名称 默认值 可修改范围 更新记录
memory_limit "8M" PHP_INI_ALL  
如下是配置选项的简要解释。
memory_limit integer
本指令设定了一个脚本所可以申请到的最大内存字节数。这有助于防止写得很差的脚本消耗光服务器上的可用内存。要使用此指令必须在编译的时候激活。所以 configure 一行中应该包括： --enable-memory-limit。若是不须要任何内存上的限制，必须将其设为 -1。
自 4.3.2 起，当激活了 memory_limit，PHP 函数 memory_get_usage() 即可以使用了。
当使用 integer 类型时，其值以字节为度量单位。还能够用简化符号，说明见此 FAQ。
参见 max_execution_time。

性能调整

表 I-6. 性能调整
名称 默认值 可修改范围 更新记录
realpath_cache_size "16K" PHP_INI_SYSTEM 自 PHP 5.1.0 起可用。
realpath_cache_ttl "120" PHP_INI_SYSTEM 自 PHP 5.1.0 起可用。
如下是配置选项的简要解释。
realpath_cache_size integer
决定 PHP 所使用的真实路径缓冲区的大小。此值在 PHP 会打开不少文件的系统下应增大，以反映出所执行文件操做的数量。
realpath_cache_ttl integer
对给定文件或目录以秒为单位的真实路径信息缓冲的时间。对文件不多改变的系统，能够考虑增大辞职。

数据处理

表 I-7. 数据处理配置选项
名称 默认值 可修改范围 更新记录
track_vars "On" PHP_INI_??  
arg_separator.output "&" PHP_INI_ALL 从 PHP 4.0.5 起可用。
arg_separator.input "&" PHP_INI_PERDIR 从 PHP 4.0.5 起可用。
variables_order "EGPCS" PHP_INI_PERDIR 在 PHP <= 5.0.5 时是 PHP_INI_ALL。
auto_globals_jit "1" PHP_INI_PERDIR 从 PHP 5.0.0 起可用。
register_globals "0" PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。
register_argc_argv "1" PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。
register_long_arrays "1" PHP_INI_PERDIR 从 PHP 5.0.0 起可用。
post_max_size "8M" PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.0.3 起可用。
gpc_order "GPC" PHP_INI_ALL  
auto_prepend_file NULL PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。
auto_append_file NULL PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。
default_mimetype "text/html" PHP_INI_ALL  
default_charset "" PHP_INI_ALL  
always_populate_raw_post_data "0" PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.1.0 起可用。
allow_webdav_methods "0" PHP_INI_PERDIR  
如下是配置选项的简要解释。
track_vars boolean
若是激活，则环境变量，GET，POST，Cookie 和 Server 变量都可以分别在全局关联数组中找到： $_ENV， $_GET， $_POST， $_COOKIE 和 $_SERVER。
注意自 PHP 4.0.3 起， track_vars 老是打开的。
arg_separator.output string
PHP 所产生的 URL 中来分隔参数的分隔符。
arg_separator.input string
PHP 用来将 URL 解析为变量的分隔符列表。
注意: 本指令中的每一个字符都会被当成分隔符！
variables_order string
设定 EGPCS（Environment，GET，POST，Cookie，Server）变量解析的顺序。默认设定为“EGPCS”。举例说，将其设为“GP”，会致使 PHP 彻底忽略环境变量，cookies 和 server 变量，并用 GET 方法的变量覆盖 POST 方法的同名变量。
参见 register_globals。
auto_globals_jit boolean
启用后，SERVER 和 ENV 变量在他们第一次使用后 (Just In Time) 便被建立，而不是等到脚本开始运行时。若是这些变量没有在脚本总使用，启用这个变量会提升服务器性能。
要使此选项有效，PHP 配置选项 register_globals, register_long_arrays, 和 register_argc_argv 必须禁用。
register_globals boolean
决定是否将 EGPCS（Environment，GET，POST，Cookie，Server）变量注册为全局变量。
PHP 4.2.0 开始，本选项默认为 off。
相关信息请阅读安全一章中的 使用 register_globals。
请注意 register_globals 不能在运行时设定（ ini_set()），尽管如以上说明在主机容许时能够用 .htaccess。一个 .htaccess 项目的例子： php_flag register_globals off。
注意: register_globals 受 variables_order 选项的影响。
register_argc_argv boolean
决定 PHP 是否认义 argv & argc 变量（可能包含有 GET 信息）。
参见 命令行方式。此外，本选项自 PHP 4.0.0 起可用，在此以前老是“On”。
register_long_arrays boolean
设定 PHP 是否注册已过期的 $HTTP_*_VARS 之类的 预约义变量。若是为 On（默认值），则相似 $HTTP_GET_VARS 的 PHP 变量会被注册。若是不使用，为性能考虑建议关闭此选项，而使用超全局数组例如 $_GET 替代之。
本指令自 PHP 5.0.0 起可用。
post_max_size integer
设定 POST 数据所容许的最大大小。此设定也影响到文件上传。要上传大文件，该值必须大于 upload_max_filesize。
若是配置脚本中激活了内存限制， memory_limit 也会影响文件上传。一般说， memory_limit 应该比 post_max_size 要大。
当使用 integer 类型时，其值以字节为度量单位。还能够用简化符号，说明见此 FAQ。
若是 POST 数据尺寸大于 post_max_size $_POST 和 $_FILES superglobals 便会为空。这能够以多种方式证实，例如，传递 $_GET 变量到脚本以处理数据， 也就是 <form action="edit.php?processed=1">, 而后查看 $_GET['processed'] 是否被设置。
gpc_order string
设定 GET/POST/COOKIE 变量解析的顺序，默认为“GPC”。举例说，将其设为“GP”，会致使 PHP 彻底忽略 cookie 变量，并用 GET 方法的变量覆盖 POST 方法的同名变量。
注意: 本选项不能用于 PHP 4。用 variables_order 替代之。
auto_prepend_file string
指定在主文件以前自动解析的文件名。该文件就像调用了 include() 函数同样被包含进来，所以会使用 include_path。
特殊值 none 禁止了自动前缀。
auto_append_file string
指定在主文件以后自动解析的文件名。该文件就像调用了 include() 函数同样被包含进来，所以会使用 include_path。
特殊值 none 禁止了自动后缀。
注意: 若是脚本经过 exit() 终止，则自动后缀 不会发生。
default_mimetype string
default_charset string
自 4.0b4 起，PHP 老是默认在 HTTP 信息头 Content-type: 中输出字符编码。要禁止发送字符集，将本选项设为空便可。
always_populate_raw_post_data boolean
老是产生 $HTTP_RAW_POST_DATA 变量包含有原始的 POST 数据。不然，此变量仅在碰到未识别 MIME 类型的数据时产生。不过，访问原始 POST 数据的更好方法是 php://input。 $HTTP_RAW_POST_DATA 对于 enctype="multipart/form-data" 表单数据不可用。
allow_webdav_methods boolean
容许在 PHP 脚本中处理 WebDAV 的 HTTP 请求（例如 PROPFIND，PROPPATCH，MOVE，COPY 等）。此选项在 PHP 4.3.2 之后便不存在了。若是要取得这些请求的 POST 数据，也要设定 always_populate_raw_post_data。

路径和目录

表 I-8. 路径和目录配置选项
名称 默认值 可修改范围 更新记录
include_path ".;/path/to/php/pear" PHP_INI_ALL  
doc_root NULL PHP_INI_SYSTEM  
user_dir NULL PHP_INI_SYSTEM  
extension_dir "/path/to/php" PHP_INI_SYSTEM  
extension NULL 仅限于 php.ini  
cgi.fix_pathinfo "1" PHP_INI_ALL 从 PHP 4.3.0 起可用
cgi.force_redirect "1" PHP_INI_ALL 从 PHP 4.2.0 起可用
cgi.redirect_status_env NULL PHP_INI_ALL 从 PHP 4.2.0 起可用
fastcgi.impersonate "0" PHP_INI_ALL 从 PHP 4.3.0 起可用
cgi.rfc2616_headers "0" PHP_INI_ALL 从 PHP 4.3.0 起可用
如下是配置选项的简要解释。
include_path string
指定一组目录用于 require()， include() 和 fopen_with_path() 函数来寻找文件。格式和系统的 PATH 环境变量相似：一组目录的列表，在 UNIX 下用冒号分隔，在 Windows 下用分号分隔。
例 I-1. Unix include_path 
include_path=".:/php/includes"
例 I-2. Windows include_path 
include_path=".;c:\php\includes"
在包含路径中使用 . 能够容许相对路径，它表明当前目录。
doc_root string
PHP 在服务器上的根目录。仅在非空时使用。若是 PHP 被配置为 安全模式，则此目录以外的文件一律不被解析。若是 PHP 编译时没有指定 FORCE_REDIRECT，而且在任何 web 服务器（除了 IIS）中以 CGI 方式运行 PHP，则应该设定 doc_root。替代方案是使用下面的 cgi.force_redirect 配置选项。
user_dir string
在用户目录之下使用 PHP 文件的基本目录名，例如 public_html。
extension_dir string
PHP 用来寻找动态链接扩展库的目录。参见 enable_dl 和 dl()。
extension string
当 PHP 启动时所加载的动态链接扩展库。
cgi.fix_pathinfo boolean
对 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 boolean
在大多数 web 服务器中以 CGI 方式运行 PHP 时颇有必要用 cgi.force_redirect 提供安全。PHP 默认其为 On。能够将其关闭，但 风险自担。
注意: Windows 用户：能够安全地在 IIS 之下将其关闭，事实上必须这么作。要在 OmniHTTPD 或 Xitami 之下使用也必须将其关闭。
cgi.redirect_status_env string
若是打开了 cgi.force_redirect，而且不是在 Apache 或 Netscape（iPlanet）web 服务器之下运行，可能须要设定一个环境变量名，PHP 将去寻找它来知道能够继续执行下去。
注意: 设定此变量可能会致使安全问题，首先要知道本身在作什么。
fastcgi.impersonate string
IIS（在基于 WINNT 的操做系统上）中的 FastCGI 支持模仿客户端安全令牌的能力。这使得 IIS 可以定义运行时所基于的请求的安全上下文。Apache 中的 mod_fastcgi 不支持此特性（03/17/2002）。若是在 IIS 中运行则设为 1。默认为 0。
cgi.rfc2616_headers int
指定 PHP 在发送 HTTP 响应代码时使用何种报头。若是设定为 0，PHP 发送一个 Status: 报头，Apache 和其它 web server 都支持。若是此选项设定为 1，PHP 将发送 RFC 2616 兼容的报头。除非你知道本身在作什么，不然保留其值为 0。

文件上传

表 I-9. 文件上传配置选项
名称 默认值 可修改范围 更新记录
file_uploads "1" PHP_INI_SYSTEM 在 PHP <= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.0.3 起可用。
upload_tmp_dir NULL PHP_INI_SYSTEM  
upload_max_filesize "2M" PHP_INI_PERDIR 在 PHP <= 4.2.3 时是 PHP_INI_ALL。
如下是配置选项的简要解释。
file_uploads boolean
是否容许 HTTP 文件上传。参见 upload_max_filesize， upload_tmp_dir 和 post_max_size 指令。
当使用 integer 类型时，其值以字节为度量单位。还能够用简化符号，说明见此 FAQ。
upload_tmp_dir string
文件上传时存放文件的临时目录。必须是 PHP 进程全部者用户可写的目录。若是未指定则 PHP 使用系统默认值。
upload_max_filesize integer
所上传的文件的最大大小。
当使用 integer 类型时，其值以字节为度量单位。还能够用简化符号，说明见此 FAQ。

普通 SQL

表 I-10. 普通 SQL 配置选项
名称 默认值 可修改范围 更新记录
sql.safe_mode "0" PHP_INI_SYSTEM  
如下是配置选项的简要解释。
sql.safe_mode boolean

调试器配置选项

当心
仅 PHP 3 实现了一个默认的调试器。更多信息请参考 附录 G。
debugger.host string
调试器所使用的主机的 DNS 名或 IP 地址。
debugger.port string
调试器所用的端口号。
debugger.enabled boolean
是否启用调试器。
表 I-2. PHP_INI_* 常量的定义
常量 值 含义
PHP_INI_USER 1 配置选项可在用户的 PHP 脚本或 Windows 注册表中设置
PHP_INI_PERDIR 2 配置选项可在 php.ini, .htaccess 或 httpd.conf 中设置
PHP_INI_SYSTEM 4 配置选项可在 php.ini or httpd.conf 中设置
PHP_INI_ALL 7 配置选项可在各处设置
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程