php.ini 核心配置选项说明

小鱼儿 2022-08-21 14:42 253阅读 0赞

## 1、找到PHP.ini文件，将“;extension=php\_mysql.dll\\mssql.dll\\mbs\_string.dll\\gb2.dll”前的“;”删除以取消注释，同时搜索并修改“extension\_dir”的值为“php\_mysql.dll”文件所在文件夹。即：  extension\_dir = "D:\\PHP\\ext\\"  2、将libmysql.dll放到windows system32文件夹中（关键为这一步，因为所部署的服务器上安装了多个mysql）  3、重新启动计算机，OK      ##

## Httpd 选项 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>Httpd 选项</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> async_send</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

## 语言选项 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>语言和杂类配置选项</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> short_open_tag</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.0.0 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> asp_tags</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.0.0 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> precision</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "14"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> y2k_compliance</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> allow_call_time_pass_reference</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.0.0 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> expose_php</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 仅可在&nbsp;php.ini&nbsp;中配置。</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> zend.ze1_compatibility_mode</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 5.0.0 起可用。</td> 
  </tr> 
 </tbody> 
</table>

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

*short\_open\_tag* [boolean][]

决定是否允许使用 PHP 代码开始标志的缩写形式（**`<? ?>`**）。如果要和 XML 结合使用 PHP，可以禁用此选项以便于嵌入使用 **`<?xml ?>`**。否则还可以通过 PHP 来输出，例如：**`<?php echo '<?xml version="1.0"'; ?>`**。如果禁用了，必须使用 PHP 代码开始标志的完整形式（**`<?php ?>`**）。

> **Note**:
> 
> 本指令也会影响到缩写形式 **`<?=`**，它和 **`<? echo`** 等价。使用此缩写需要 `short_open_tag` 的值为 On。

*asp\_tags* [boolean][]

除了通常的 <?php ?> 标志之外还允许使用 ASP 风格的标志 <% %>。这也包括了输出变量值的缩写 <%= $value %>。更多信息见[从 HTML 中分离][HTML]一节。

> **Note**:
> 
> ASP 风格标志的支持是 3.0.4 版新加的。

*precision* [integer][]

浮点数中显示有效数字的位数。

*y2k\_compliance* [boolean][]

强制 2000 年兼容（在不兼容的浏览器中会出问题）。

*allow\_call\_time\_pass\_reference* [boolean][]

在函数调用时参数被按照引用传递时是否发出警告。此方法已不被赞成并在 PHP/Zend 未来的版本中很可能不再支持。鼓励使用的方法是在函数定义中指定哪些参数应该用引用传递。鼓励大家尝试关闭此选项并确保脚本能够正常运行，以确保该脚本也能在未来的版本中运行（每次使用此特性都会收到一条警告）。

在函数调用时通过引用传递参数是不推荐的，因为它影响到了代码的整洁。如果函数的参数没有声明作为引用传递，函数可以通过未写入文档的方法修改其参数。要避免其副作用，最好仅在函数声明时指定那个参数需要通过引用传递。

参见[引用的解释][Link 1]。

*expose\_php* [boolean][]

决定是否暴露 PHP 被安装在服务器上（例如在 Web 服务器的信息头中加上其签名）。没有任何安全上的威胁，只是让客户端能够知道是否在服务器中安装了 PHP。

*zend.ze1\_compatibility\_mode* [boolean][]

启用 Zend 引擎 1(PHP 4) 兼容模式。这影响到了对象的复制、构造（无属性的对象会产生 **FALSE** 或 0）及[比较][Link 2]。此模式下，对象将以值传递，而不是默认的引用传递。

参见[从 PHP 4 移植到 PHP 5][PHP 4 _ PHP 5]。

## 资源限制 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>资源限制</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> memory_limit</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "8M"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

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

*memory\_limit* [integer][]

本指令设定了一个脚本所能够申请到的最大内存字节数。这有助于防止写得不好的脚本消耗光服务器上的可用内存。要使用此指令必须在编译的时候激活。因此 configure 一行中应该包括：*--enable-memory-limit*。如果不需要任何内存上的限制，必须将其设为 -1。

自 4.3.2 起，当激活了 memory\_limit，PHP 函数 [memory\_get\_usage()][memory_get_usage] 便可以使用了。

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

参见 [max\_execution\_time][max_execution_time]。

## 性能调整 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>性能调整</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> realpath_cache_size</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "16K"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 自 PHP 5.1.0 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> realpath_cache_ttl</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "120"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 自 PHP 5.1.0 起可用。</td> 
  </tr> 
 </tbody> 
</table>

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

*realpath\_cache\_size* [integer][]

决定 PHP 所使用的真实路径缓冲区的大小。此值在 PHP 会打开很多文件的系统下应增大，以反映出所执行文件操作的数量。

*realpath\_cache\_ttl* [integer][]

对给定文件或目录以秒为单位的真实路径信息缓冲的时间。对文件很少改变的系统，可以考虑增大此值。

## 数据处理 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>数据处理配置选项</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> track_vars</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "On"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_??</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> arg_separator.output</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "&amp;"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.0.5 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> arg_separator.input</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "&amp;"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.0.5 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> variables_order</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "EGPCS"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 5.0.5 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> auto_globals_jit</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 5.0.0 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> register_globals</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> register_argc_argv</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> register_long_arrays</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 5.0.0 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> post_max_size</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "8M"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.0.3 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> gpc_order</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "GPC"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> auto_prepend_file</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> auto_append_file</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> default_mimetype</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "text/html"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> default_charset</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> ""</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> always_populate_raw_post_data</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.1.0 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> allow_webdav_methods</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

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

*track\_vars* [boolean][]

如果激活，则环境变量，GET，POST，Cookie 和 Server 变量都能够分别在全局关联数组中找到：[$\_ENV][ENV]，[$\_GET][GET]，[$\_POST][POST]，[$\_COOKIE][COOKIE] 和 [$\_SERVER][SERVER]。

注意自 PHP 4.0.3 起，`track_vars` 总是打开的。

*arg\_separator.output* [string][]

PHP 所产生的 URL 中来分隔参数的分隔符。

*arg\_separator.input* [string][]

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

> **Note**:
> 
> 本指令中的每个字符都会被当成分隔符！

*variables\_order* [string][]

设定 EGPCS（Environment，GET，POST，Cookie，Server）变量解析的顺序。默认设定为“EGPCS”。举例说，将其设为“GP”，会导致 PHP 完全忽略环境变量，cookies 和 server 变量，并用 GET 方法的变量覆盖 POST 方法的同名变量。

参见 [register\_globals][register_globals]。

*request\_order* [string][]

This directive describes the order in which PHP registers GET, POST and Cookie variables into the \_REQUEST array. Registration is done from left to right, newer values override older values.

If this directive is not set, variables\_order is used for [$\_REQUEST][REQUEST] contents.

*auto\_globals\_jit* [boolean][]

启用后，SERVER 和 ENV 变量在他们第一次使用后 (Just In Time) 便被创建，而不是等到脚本开始运行时。如果这些变量没有在脚本总使用，启用这个变量会提高服务器性能。

要使此选项有效，PHP 配置选项 [register\_globals][register_globals], [register\_long\_arrays][register_long_arrays], 和 [register\_argc\_argv][register_argc_argv] 必须禁用。

*register\_globals* [boolean][]

决定是否将 EGPCS（Environment，GET，POST，Cookie，Server）变量注册为全局变量。

PHP [» 4.2.0][4.2.0] 开始，本选项默认为 *off*。

相关信息请阅读安全一章中的[使用 register\_globals][register_globals 1]。

请注意 `register_globals` 不能在运行时设定（[ini\_set()][ini_set]），尽管如以上说明在主机允许时可以用 .htaccess。一个 .htaccess 项目的例子：**`php_flag register_globals off`**。

> **Note**:
> 
> `register_globals` 受 [variables\_order][variables_order] 选项的影响。

*register\_argc\_argv* [boolean][]

决定 PHP 是否定义 argv & argc 变量（可能包含有 GET 信息）。  参见[命令行方式][Link 3]。此外，本选项自 PHP 4.0.0 起可用，在此之前总是“On”。

*register\_long\_arrays* [boolean][]

设定 PHP 是否注册已过时的 $HTTP\_\*\_VARS 之类的[预定义变量][Link 4]。如果为 On（默认值），则类似 $HTTP\_GET\_VARS 的 PHP 变量会被注册。如果不使用，为性能考虑建议关闭此选项，而使用超全局数组例如 [$\_GET][GET] 替代之。  本指令自 PHP 5.0.0 起可用。

*post\_max\_size* [integer][]

设定 POST 数据所允许的最大大小。此设定也影响到文件上传。要上传大文件，该值必须大于 [upload\_max\_filesize][upload_max_filesize]。  如果配置脚本中激活了内存限制，[memory\_limit][memory_limit] 也会影响文件上传。通常说，[memory\_limit][memory_limit] 应该比 *post\_max\_size* 要大。 当使用 [integer][] 时, 其值以字节来衡量。还可以使用在[FAQ][]中描述的速记符。  如果 POST 数据尺寸大于 post\_max\_size [$\_POST][POST] 和 [$\_FILES][FILES] [superglobals][] 便会为空。这可以以多种方式证明，例如，传递 [$\_GET][GET] 变量到脚本以处理数据， 也就是 *<form action="edit.php?processed=1">*, 然后查看 [$\_GET\['processed'\]][GET] 是否被设置。

*gpc\_order* [string][]

设定 GET/POST/COOKIE 变量解析的顺序，默认为“GPC”。举例说，将其设为“GP”，会导致 PHP 完全忽略 cookie 变量，并用 GET 方法的变量覆盖 POST 方法的同名变量。

> **Note**:
> 
> 本选项不能用于 PHP 4。用 [variables\_order][variables_order] 替代之。

*auto\_prepend\_file* [string][]

指定在主文件之前自动解析的文件名。该文件就像调用了 **include()** 函数一样被包含进来，因此会使用 [include\_path][include_path]。

特殊值 **none** 禁止了自动前缀。

*auto\_append\_file* [string][]

指定在主文件之后自动解析的文件名。该文件就像调用了 **include()** 函数一样被包含进来，因此会使用 [include\_path][include_path]。

特殊值 **none** 禁止了自动后缀。

> **Note**: 如果脚本通过 [exit()][exit] 终止，则自动后缀*不会*发生。

*default\_mimetype* [string][]

*default\_charset* [string][]

自 4.0b4 起，PHP 总是默认在 HTTP 信息头 Content-type: 中输出字符编码。要禁止发送字符集，将本选项设为空即可。

*always\_populate\_raw\_post\_data* [boolean][]

总是产生 [$HTTP\_RAW\_POST\_DATA][HTTP_RAW_POST_DATA] 变量包含有原始的 POST 数据。否则，此变量仅在碰到未识别 MIME 类型的数据时产生。不过，访问原始 POST 数据的更好方法是 [php://input][php_input]。[$HTTP\_RAW\_POST\_DATA][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][always_populate_raw_post_data]。

参见 [magic\_quotes\_gpc][magic_quotes_gpc]，[magic-quotes-runtime][] 和 [magic\_quotes\_sybase][magic_quotes_sybase]。

## 路径和目录 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>路径和目录配置选项</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> include_path</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> ".;/path/to/php/pear"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> doc_root</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> user_dir</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> extension_dir</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "/path/to/php"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> extension</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 仅限于&nbsp;php.ini</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> cgi.fix_pathinfo</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.3.0 起可用</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> cgi.force_redirect</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.2.0 起可用</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> cgi.redirect_status_env</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.2.0 起可用</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> fastcgi.impersonate</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.3.0 起可用</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> cgi.rfc2616_headers</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_ALL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 从 PHP 4.3.0 起可用</td> 
  </tr> 
 </tbody> 
</table>

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

*include\_path* [string][]

指定一组目录用于 **require()**，**include()** 和 **fopen\_with\_path()** 函数来寻找文件。格式和系统的 PATH 环境变量类似：一组目录的列表，在 UNIX 下用冒号分隔，在 Windows 下用分号分隔。

**Example \#1 Unix include\_path**

include_path=".:/php/includes"

**Example \#2 Windows include\_path**

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

在包含路径中使用 *.* 可以允许相对路径，它代表当前目录。

*doc\_root* [string][]

PHP 在服务器上的根目录。仅在非空时使用。如果 PHP 被配置为[安全模式][Link 5]，则此目录之外的文件一概不被解析。如果 PHP 编译时没有指定 FORCE\_REDIRECT，并且在任何 web 服务器（除了 IIS）中以 CGI 方式运行 PHP，则应该设定 doc\_root。替代方案是使用下面的 [cgi.force\_redirect][cgi.force_redirect] 配置选项。

*user\_dir* [string][]

在用户目录之下使用 *PHP* 文件的基本目录名，例如 *public\_html*。

*extension\_dir* [string][]

PHP 用来寻找动态连接扩展库的目录。参见 [enable\_dl][enable_dl] 和 [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。可以将其关闭，但*风险自担*。

> **Note**:
> 
> Windows 用户：可以安全地在 IIS 之下将其关闭，事实上必须这么做。要在 OmniHTTPD 或 Xitami 之下使用也必须将其关闭。

*cgi.redirect\_status\_env* [string][]

如果打开了 cgi.force\_redirect，并且不是在 Apache 或 Netscape（iPlanet）web 服务器之下运行，可能需要设定一个环境变量名，PHP 将去寻找它来知道可以继续执行下去。

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

*fastcgi.impersonate* [string][]

IIS（在基于 WINNT 的操作系统上）中的 FastCGI 支持模仿客户端安全令牌的能力。这使得 IIS 能够定义运行时所基于的请求的安全上下文。Apache 中的 mod\_fastcgi 不支持此特性（03/17/2002）。如果在 IIS 中运行则设为 1。默认为 0。

*cgi.rfc2616\_headers* [int][integer]

指定 PHP 在发送 HTTP 响应代码时使用何种报头。如果设定为 0，PHP 发送一个 Status: 报头，Apache 和其它 web server 都支持。如果此选项设定为 1，PHP 将发送 [» RFC 2616][RFC 2616] 兼容的报头。除非你知道自己在做什么，否则保留其值为 0。

## 文件上传 ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>文件上传配置选项</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> file_uploads</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "1"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.0.3 起可用。</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> upload_tmp_dir</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> NULL</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> upload_max_filesize</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "2M"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_PERDIR</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> 在 PHP &lt;= 4.2.3 时是 PHP_INI_ALL。</td> 
  </tr> 
 </tbody> 
</table>

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

*file\_uploads* [boolean][]

是否允许 HTTP [文件上传][Link 6]。参见 [upload\_max\_filesize][upload_max_filesize]，[upload\_tmp\_dir][upload_tmp_dir] 和 [post\_max\_size][post_max_size] 指令。

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

*upload\_tmp\_dir* [string][]

文件上传时存放文件的临时目录。必须是 *PHP* 进程所有者用户可写的目录。如果未指定则 PHP 使用系统默认值。

*upload\_max\_filesize* [integer][]

所上传的文件的最大大小。

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

## 普通 SQL ##

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word">  
 <strong>普通 SQL 配置选项</strong>  
 <thead> 
  <tr> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">名称</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">默认值</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">可修改范围</th> 
   <th style="border:1px solid silver; border-collapse:collapse; padding:3px">更新记录</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> sql.safe_mode</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> "0"</td> 
   <td align="left" style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> PHP_INI_SYSTEM</td> 
   <td style="font-size:14px; border:1px solid silver; border-collapse:collapse; padding:3px"> &nbsp;</td> 
  </tr> 
 </tbody> 
</table>

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

*sql.safe\_mode* [boolean][]

## 调试器配置选项 ##

**Caution**

仅 PHP 3 实现了一个默认的调试器。更多信息请参考[PHP 的调试][PHP]。

*debugger.host* [string][]

调试器所使用的主机的 DNS 名或 IP 地址。

*debugger.port* [string][]

调试器所用的端口号。

*debugger.enabled* [boolean][]

是否启用调试器。

[boolean]: http://cn.php.net/manual/zh/language.types.boolean.php
[HTML]: http://cn.php.net/manual/zh/language.basic-syntax.phpmode.php
[integer]: http://cn.php.net/manual/zh/language.types.integer.php
[Link 1]: http://cn.php.net/manual/zh/language.references.php
[Link 2]: http://cn.php.net/manual/zh/language.oop5.object-comparison.php
[PHP 4 _ PHP 5]: http://cn.php.net/manual/zh/migration5.php
[memory_get_usage]: http://cn.php.net/manual/zh/function.memory-get-usage.php
[FAQ]: http://cn.php.net/manual/zh/faq.using.php#faq.using.shorthandbytes
[max_execution_time]: http://cn.php.net/manual/zh/info.configuration.php#ini.max-execution-time
[ENV]: http://cn.php.net/manual/zh/reserved.variables.environment.php
[GET]: http://cn.php.net/manual/zh/reserved.variables.get.php
[POST]: http://cn.php.net/manual/zh/reserved.variables.post.php
[COOKIE]: http://cn.php.net/manual/zh/reserved.variables.cookies.php
[SERVER]: http://cn.php.net/manual/zh/reserved.variables.server.php
[string]: http://cn.php.net/manual/zh/language.types.string.php
[register_globals]: http://cn.php.net/manual/zh/ini.core.php#ini.register-globals
[REQUEST]: http://cn.php.net/manual/zh/reserved.variables.request.php
[register_long_arrays]: http://cn.php.net/manual/zh/ini.core.php#ini.register-long-arrays
[register_argc_argv]: http://cn.php.net/manual/zh/ini.core.php#ini.register-argc-argv
[4.2.0]: http://www.php.net/releases/4_2_0.php
[register_globals 1]: http://cn.php.net/manual/zh/security.globals.php
[ini_set]: http://cn.php.net/manual/zh/function.ini-set.php
[variables_order]: http://cn.php.net/manual/zh/ini.core.php#ini.variables-order
[Link 3]: http://cn.php.net/manual/zh/features.commandline.php
[Link 4]: http://cn.php.net/manual/zh/language.variables.predefined.php
[upload_max_filesize]: http://cn.php.net/manual/zh/ini.core.php#ini.upload-max-filesize
[memory_limit]: http://cn.php.net/manual/zh/ini.core.php#ini.memory-limit
[FILES]: http://cn.php.net/manual/zh/reserved.variables.files.php
[superglobals]: http://cn.php.net/manual/zh/language.variables.superglobals.php
[include_path]: http://cn.php.net/manual/zh/ini.core.php#ini.include-path
[exit]: http://cn.php.net/manual/zh/function.exit.php
[HTTP_RAW_POST_DATA]: http://cn.php.net/manual/zh/reserved.variables.httprawpostdata.php
[php_input]: http://cn.php.net/manual/zh/wrappers.php.php
[always_populate_raw_post_data]: http://cn.php.net/manual/zh/ini.core.php#ini.always-populate-raw-post-data
[magic_quotes_gpc]: http://cn.php.net/manual/zh/info.configuration.php#ini.magic-quotes-gpc
[magic-quotes-runtime]: http://cn.php.net/manual/zh/info.configuration.php#ini.magic-quotes-runtime
[magic_quotes_sybase]: http://cn.php.net/manual/zh/sybase.configuration.php#ini.magic-quotes-sybase
[Link 5]: http://cn.php.net/manual/zh/ini.sect.safe-mode.php#ini.safe-mode
[cgi.force_redirect]: http://cn.php.net/manual/zh/ini.core.php#ini.cgi.force-redirect
[enable_dl]: http://cn.php.net/manual/zh/info.configuration.php#ini.enable-dl
[dl]: http://cn.php.net/manual/zh/function.dl.php
[RFC 2616]: http://www.faqs.org/rfcs/rfc2616
[Link 6]: http://cn.php.net/manual/zh/features.file-upload.php
[upload_tmp_dir]: http://cn.php.net/manual/zh/ini.core.php#ini.upload-tmp-dir
[post_max_size]: http://cn.php.net/manual/zh/ini.core.php#ini.post-max-size
[PHP]: http://cn.php.net/manual/zh/debugger.php