php.ini配置文件参数中文说明文档【持续整理】

php.ini配置文件参数中文说明文档【持续整理】

一、中文翻译php.ini配置文件

[PHP 5.0.4 php.ini-dist]

;;;;;;;;;;
;; 警告 ;;
;;;;;;;;;;
; 这是PHP新安装时的默认设置。默认设置适合于开发但是不适合正式应用。
; 出于安全方面考虑，请在发布正式应用程序时使用php.ini-recommended
; 并且参考如下页面：http://php.net/manual/en/security.php

;;;;;;;;;;;;;;;;;;;
;; 关于 php.ini ;;
;;;;;;;;;;;;;;;;;;;
; 这个文件控制了PHP许多方面的性能和行为。 为了让PHP正确读取这个文件，
; 它必须被命名为'php.ini'。PHP将按照如下顺序依次查找该文件：
; 1.当前工作目录；2.环境变量PHPRC指明的路径；3.编译时指定的路径。
; 在windows下，编译时的路径是Windows的安装目录（C:WINDOWS等）。
; 在命令行模式下，php.ini的查找路径可以用 -c 参数指定。
;
; 该文件的语法非常简单。空白字符(" ","t",...)和用分号(";")开始的行被简单地忽略。
; 章节标题（例如 : [php]）也被简单地忽略，即使将来它们可能有某种意义。
;
; 设置格式如下：
; directive = value
; 指令标识符(directive) 是大小写敏感的! "foo=bar" 不同于 "FOO = bar"。
; 值(value)可以是：
; 1.一个字符串、2.一个数字、3.一个 PHP常量(如：E_ALL, M_PI)、
; 4.一个INI常量(On, Off, True, False, Yes, No, None)、
; 5.一个表达式(如：E_ALL & ~E_NOTICE)、
; 6.用引号括起来的字符串("foo").
;
; INI文件中的表达式仅限于使用位运算符/逻辑非/小括号。
; | 位或
; & 位与
; ~ 位非
; ! 逻辑非
;
; 布尔标志可用 1, On, True, Yes 打开，亦可用 0, Off, False, No 关闭。
;
; 一个空字符串可以用在等号后不写任何东西表示，或者用 none 关键字，举例如下：
; foo = 将foo置为空字符串
; foo = none 将foo置为空字符串
; foo = "none" 将foo置为字符串'none'
;
; 如果你在值设置中使用常量，而这些常量属于动态扩展（PHP扩展或Zend扩展）
; 那么你只能在调入这些动态扩展的行之后使用这些常量。
;
; 所有在 php.ini-dist 文件里设定的值与内建的默认值相同。
; 也就是说，如果 php.ini 不存在，或者你删掉了某些行，默认值与之相同。
;;;;;;;;;;;;;;;
;;; 语言选项 ;;
;;;;;;;;;;;;;;;

engine = On
; 使PHP脚本语言引擎在Apache下有效。

zend.ze1_compatibility_mode = Off
; 允许使用兼容Zend引擎1(PHP 4.x)的模式

short_open_tag = On
; 允许 "" 短标识，否则只有""和""才能被识别。
; 注意：除非你的php程序只供自己使用，否则请不要使用短标记。
; 如果要和XML结合使用PHP，你可以选择禁用此选项以方便直接嵌入使用 ，
; 不然你必须用PHP来输出：
; 本指令也会影响到缩写形式
asp_tags = Off
; 是否允许ASP风格的标记"<% %>"，这也会影响到缩写形式：<%= $value %>

precision = 12
;[recommended]->precision = 14
; 浮点型数据显示的有效位数

y2k_compliance = On
; 强制打开2000年适应 (可能在非Y2K适应的浏览器中导致问题)

output_buffering = Off
;[recommended]->output_buffering = 4096
; 输出缓存允许你甚至在输出正文内容之后发送http头（包括cookies）。
; 其代价是输出层减慢一点点速度。
; 你可以在运行期间通过调用输出缓冲函数启用输出缓存。
; 你还可以通过设置"output_buffering=On"来为所有文件启用输出缓存(默认4096)。
; 如果你想指定缓冲区的最大字节数，你可以直接将"On"替换成数字，
; 比如："output_buffering=4096"指定了缓存上限为4096字节。

;output_handler =
; 你可以将所有脚本输出重定向到一个输出处理函数。
; 比如，重定向到"mb_output_handler"函数时，字符编码将被透明地转换为指定的编码。
; 一旦你在这里指定了输出处理程序，"output_buffering"将被自动打开。
; 注意1: 在编写可移植脚本的时候不能依赖这个指令，而应明确的调用ob_start()函数打开输出缓存。
; 使用这个指令可能会导致某些你不熟悉的脚本出错。
; 注意2: 你不能同时使用"mb_output_handler"和"ob_iconv_handler"
; 你也不能同时使用"ob_gzhandler"和"zlib.output_compression"
; 注意3: 如果启用了zlib输出压缩，"output_handler"必须为空，取而代之，必须启用"zlib.output_handler"。

zlib.output_compression = Off
; 使用zlib库透明地压缩脚本输出结果。
; 该指令的值可以设置为：Off/On/字节数（用来作为压缩缓冲区大小，默认为4KB）
; 如果在php.ini或者apache配置中打开这个功能，当浏览器发送"Accept-Encoding: gzip(deflate)"头时，
; "Content-Encoding: gzip(deflate)"和"Vary: Accept-Encoding"头将加入到应答头当中。
; 你可以在答头输出之前用ini_set()函数在脚本中禁止这个特性，
; 如果你输出一个"Content-Type: image/"这样的应答头，压缩将不会启用(为了防止Netscape的bug)。
; 你可以在输出"Content-Type: image/"之后使用"ini_set('zlib.output_compression', 'On')"重新打开这个特性。
; 注意1: 压缩率会受压缩缓冲区大小的影响，如果你想得到更好的压缩质量，请指定一个较大的压缩缓冲区。
; 注意2: 如果启用了zlib输出压缩，"output_handler"必须为空，取而代之，必须启用"zlib.output_handler"。

;zlib.output_handler =
; 在打开"zlib.output_compression"指令的情况下，除这里以外，你不能另外指定输出处理程序。
; 这个指令和"output_handler"起相同的作用，但是顺序不同。

implicit_flush = Off
; 这个指令告诉PHP输出层在每个输出块之后自动刷新自身数据。默认为 FALSE
; 这等效于在每个print()、echo()、HTML块之后自动调用flush()函数。
; 打开这个选项对程序执行的性能有严重的影响，通常只推荐在调试时使用。
; 在CLI SAPI的执行模式下，该标记默认为 TRUE 。

unserialize_callback_func=
; 如果解序列化程序需要实例化一个未定义类，该这里指定的回调函数将以该未定义类的名字作为参数被调用，
; 以免得到不完整的"__PHP_Incomplete_Class"对象。
; 如果这里没有指定函数，或者指定的函数不包含(或实现)那个未定义的类，将会显示一条警告信息。
; 只有在你真想执行这样一个回调函数的情况下，才需要指定该参数的值。
; 可以通过 php.ini、ini_set() 或 .htaccess 定义"unserialize_callback_func"。
; 若要禁止这个特性，只需置空此设定。

serialize_precision = 100
; 将浮点型和双精度型数据序列化存储时，序列化精度指明了有效位数。
; 默认值能够确保浮点型数据被解序列化程序解码时不会有数据丢失。

allow_call_time_pass_reference = On
;[recommended]->allow_call_time_pass_reference = Off
; 强迫函数调用时按引用传递参数。
; php反对使用这一方法，并可能在将来版本的PHP/Zend里不再支持。
; 鼓励的方法是在函数声明里指定哪些参数按引用传递。
; 我们鼓励你尝试关闭这一选项并确认你的脚本仍能正常工作，以保证你的脚本在将来版本的语言里仍能正常工作。
; （每次使用此特性都会收到一条警告：参数会被按值传递而不是按照引用传递）

;;;;;;;;;;;;;
; 安全模式

safe_mode = Off
; 安全模式

safe_mode_gid = Off
; 安全模式默认情况下在打开文件时会做UID比较检查。
; 如果你想将其放宽到GID比较，可以打开这个参数。

safe_mode_include_dir =
; 在安全模式下，该文件夹和其子文件夹下的文件被包含时，将跳过UID/GID检查。
; （文件夹必须必须在"include_path"中或者用完整路径来包含）
; 从PHP4.2 开始，本指令可以接受和"include_path"指令类似的风格用分号隔开的路径，而不只是一个目录。
; 指定的限制实际上是一个前缀，而非一个目录名，也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls"
; 如果您希望将访问控制在一个指定的目录，那么请在结尾加上一个斜线，例如："/dir/incl/"

safe_mode_exec_dir =
; 在安全模式下，只有该文件夹下的可执行程序才能被允许通过system()和其它执行系统程序的函数执行。
; 这些函数是：escapeshellarg, escapeshellcmd, exec, passthru, proc_close, proc_get_status,
; proc_nice, proc_open, proc_terminate, shell_exec, system ....

safe_mode_allowed_env_vars = PHP_
; 该指令包含用逗号分隔的前缀列表，表示用户在安全模式下仅可以更改在此列出的前缀开头的环境变量的值。
; 因为设置某些环境变量，可能会导致潜在的安全漏洞。
; 默认地，用户将仅能设定以PHP_开头的环境变量，（如: PHP_FOO=BAR）。
; 注意: 如果这一参数值为空，PHP将允许用户更改任意环境变量！

safe_mode_protected_env_vars = LD_LIBRARY_PATH
; 这个指令包含一个用逗号分隔的环境变量列表，在安全模式下，列表中的变量是远端用户不能用putenv()更改的。
; 这些变量甚至在"safe_mode_allowed_env_vars"设置为允许的情况下也会得到保护。

;open_basedir =
; 将PHP允许打开的所有文件都限制在此目录下。无论安全模式是否打开，该参数都将起作用。
; 如果web服务器使用了per-directory或虚拟主机，这个参数将非常有意义。
; 当一个脚本试图用例如fopen()或者gzopen()打开一个指定目录树之外的文件时，将遭到拒绝。
; 所有的符号连接都会被解析，所以不可能通过符号连接来避开此限制。
; 特殊值'.'指定了存放该脚本的目录将被当做基准目录。
; 在Windows中，用分号分隔目录。在任何其它系统中用冒号分隔目录。
; 作为Apache模块时，父目录中的open_basedir路径将自动被继承。
; 用open_basedir指定的限制实际上是前缀，不是目录名。也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls"
; 如果您希望将访问控制在一个指定的目录，那么请在结尾加上一个斜线，例如："/dir/incl/"
; 默认是允许打开所有文件。

disable_functions =
; 这个指令让你可以出于安全原因禁用特定的函数。它接受一个用逗号分隔的函数名列表。
; 无论安全模式是否打开，该参数都将起作用。
; 本指令只能设置在php.ini中。例如你不能将其设置在httpd.conf中

disable_classes =
; 这个指令让你可以出于安全原因禁用特定的类。它接受一个用逗号分隔的类名列表。
; 无论安全模式是否打开，该指令都将起作用。本指令自 PHP 4.3.2 起可用。
; 本指令只能设置在php.ini中。例如你不能将其设置在httpd.conf中

;highlight.string &#