![]() ;;;;;;;;;;;;;; ;; 简介 ;; ;;;;;;;;;;;;;; ; 本文并非是对英文版 php.ini 的简单翻译,而是参考了众多资料以后,结合自己的理解,增加了许多内容, ; 包括在原有 php.ini 基础上增加了一些实用模块的配置说明,同时对文档内容的安排进行了调整。 ; 由于作者不喜欢 no-free 的玩意儿,所以删除了除 MySQL 和 PostgreSQL 以外的其他数据库模块配置选项。 ;;;;;;;;;;;;;;;;; ;; 关于php.ini ;; ;;;;;;;;;;;;;;;;; ; 这个文档必须命名为’php.ini’并放置在httpd.conf中的PHPIniDir指令指定的目录中。 ; 最新版本的php.ini能够在下面两个位置查看: ; http://cvs.php.net/viewvc.cgi/php-src/php.ini-recommended?view=co ; http://cvs.php.net/viewvc.cgi/php-src/php.ini-dist?view=co ;;;;;;;;;;;; ;; 语法 ;; ;;;;;;;;;;;; ; 该文档的语法很简单。空白字符和以分号开始的行被简单地忽略。 ; 章节标题(例如: [php])也被简单地忽略,即使将来他们可能有某种意义。 ; ; 配置指令的格式如下: ; directive = value ; 指令名(directive)是大小写敏感的!所以"foo=bar"不同于"FOO=bar"。 ; 值(value)能够是: ; 1. 用引号界定的字符串(如:"foo") ; 2. 一个数字(整数或浮点数,如:0, 1, 34, -1, 33.55) ; 3. 一个PHP常量(如:E_ALL, M_PI) ; 4. 一个INI常量(On, Off, none) ; 5. 一个表达式(如:E_ALL & ~E_NOTICE) ; ; INI文档中的表达式仅使用:位运算符、逻辑非、圆括号: ; | 位或 ; & 位和 ; ~ 位非 ; ! 逻辑非 ; ; 布尔标志用 On 表示打开,用 Off 表示关闭。 ; ; 一个空字符串能够用在等号后不写任何东西表示,或用 none 关键字: ; foo = ; 将foo设为空字符串 ; foo = none ; 将foo设为空字符串 ; foo = "none" ; 将foo设为字符串’none’ ; ; 假如您在指令值中使用动态扩展(PHP扩展或Zend扩展)中的常量, ; 那么您只能在加载这些动态扩展的指令行之后使用这些常量。 ;;;;;;;;;;;;;;;;;; ;; httpd.conf ;; ;;;;;;;;;;;;;;;;;; ; 还能够在httpd.conf中覆盖php.ini的值,以进行更灵活的配置: ; php_value name value ;配置非bool型的指令,将value设为none则清除先前的设定 ; php_flag name on|off ;仅用于配置bool型的指令 ; ; PHP常量(如E_ALL)仅能在php.ini中使用,在httpd.conf中必须使用相应的掩码值。 ; 带"SYS"标志的指令只能在httpd.conf中的全局配置部分使用, ; 带"ini"标志的指令不能在httpd.conf中使用,他们仅能用于php.ini中。 ;========================================================================================== ;;=====================================配置指令详解======================================== ;========================================================================================== ; 以下每个指令的设定值都和 PHP-5.2 内建的默认值相同。 ; 也就是说,假如’php.ini’不存在,或您删掉了某些行,默认值和之相同。 ;;;;;;;;;;;;;; ;; Apache ;; ;;;;;;;;;;;;;; [Apache] ; 仅在将PHP作为Apache模块时才有效。 engine = On ; 是否启用PHP解析引擎。 ; 能够在httpd.conf中基于目录或虚拟主机来打开或关闭PHP解析引擎。 last_modified = Off ; 是否在Last-Modified应答头中放置该PHP脚本的最后修改时间。 xbithack = Off ; 是否不管文档结尾是什么,都作为PHP可执行位组来解析。 child_terminate = Off ; PHP脚本在请求结束后是否允许使用apache_child_terminate()函数终止子进程。 ; 该指令仅在UNIX平台上将PHP安装为Apache1.3的模块时可用。其他情况下皆不存在。 ;;;;;;;;;;;;;;; ;; PHP核心 ;; ;;;;;;;;;;;;;;; [PHP-Core-DateTime] ; 前四个配置选项现在仅用于date_sunrise()和date_sunset()函数。 date.default_latitude = 31.7667 ; 默认纬度 date.default_longitude = 35.2333 ; 默认经度 date.sunrise_zenith = 90.583333 ; 默认日出天顶 date.sunset_zenith = 90.583333 ; 默认日落天顶 date.timezone = ; 未设定TZ环境变量时用于任何日期和时间函数的默认时区。 ; 中国大陆应当使用"PRC" ; 应用时区的优先顺序为: ; 1. 用date_default_timezone_set()函数设定的时区(假如设定了的话) ; 2. TZ 环境变量(假如非空的话) ; 3. 该指令的值(假如设定了的话) ; 4. PHP自己推测(假如操作系统支持) ; 5. 假如以上都不成功,则使用 UTC [PHP-Core-Assert] assert.active = On ; 是否启用assert()断言评估 assert.bail = Off ; 是否在发生失败断言时中止脚本的执行 assert.callback = ; 发生失败断言时执行的回调函数 assert.quiet_eval = Off ; 是否使用安静评估(不显示任何错误信息,相当于error_reporting=0)。 ; 若关闭则在评估断言表达式的时候使用当前的error_reporting指令值。 assert.warning = On ; 是否对每个失败断言都发出警告 [PHP-Core-SafeMode] ; 安全模式是为了解决共享服务器的安全问题而设立的。 ; 但试图在PHP层解决这个问题在结构上是不合理的, ; 正确的做法应当是修改web服务器层和操作系统层。 ; 因此在PHP6中废除了安全模式,并打算使用open_basedir指令取代之。 safe_mode = Off ;SYS ; 是否启用安全模式。 ; 打开时,PHP将检查当前脚本的拥有者是否和被操作的文档的拥有者相同, ; 相同则允许操作,不同则拒绝操作。 safe_mode_gid = Off ;SYS ; 在安全模式下,默认在访问文档时会做UID比较检查。 ; 但有些情况下严格的UID检查反而是不适合的,宽松的GID检查已足够。 ; 假如您想将其放宽到仅做GID比较,能够打开这个参数。 safe_mode_allowed_env_vars = "PHP_" ;SYS ; 在安全模式下,用户仅能够更改的环境变量的前缀列表(逗号分隔)。 ; 允许用户配置某些环境变量,可能会导致潜在的安全漏洞。 ; 注意: 假如这一参数值为空,PHP将允许用户更改任意环境变量! safe_mode_protected_env_vars = "LD_LIBRARY_PATH" ;SYS ; 在安全模式下,用户不能更改的环境变量列表(逗号分隔)。 ; 这些变量即使在safe_mode_allowed_env_vars指令配置为允许的情况下也会得到保护。 safe_mode_exec_dir = "/usr/local/php/bin" ;SYS ; 在安全模式下,只有该目录下的可执行程式才允许被执行系统程式的函数执行。 ; 这些函数是:system, escapeshellarg, escapeshellcmd, exec, passthru, ; proc_close, proc_get_status, proc_nice, proc_open, proc_terminate, shell_exec safe_mode_include_dir = ;SYS ; 在安全模式下,该组目录和其子目录下的文档被包含时,将跳过UID/GID检查。 ; 换句话说,假如此处的值为空,任何UID/GID不符合的文档都不允许被包含。 ; 这里配置的目录必须已存在于include_path指令中或用完整路径来包含。 ; 多个目录之间用冒号(Win下为分号)隔开。 ; 指定的限制实际上是个前缀,而非一个目录名, ; 也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls" ; 假如您希望将访问控制在一个指定的目录,那么请在结尾加上斜线。 sql.safe_mode = Off ;SYS ; 是否使用SQL安全模式。 ; 假如打开,指定默认值的数据库连接函数将会使用这些默认值代替支持的参数。 ; 对于每个不同数据库的连接函数,其默认值请参考相应的手册页面。 [PHP-Core-Safe] allow_url_fopen = On ;ini ; 是否允许打开远程文档 allow_url_include = Off ;SYS ; 是否允许include/require远程文档。 disable_classes = ;ini ; 该指令接受一个用逗号分隔的类名列表,以禁用特定的类。 disable_functions = ;ini ; 该指令接受一个用逗号分隔的函数名列表,以禁用特定的函数。 enable_dl = On ;SYS ; 是否允许使用dl()函数。dl()函数仅在将PHP作为apache模块安装时才有效。 ; 禁用dl()函数主要是出于安全考虑,因为他能够绕过open_basedir指令的限制。 ; 在安全模式下始终禁用dl()函数,而不管此处怎样配置。 expose_php = On ;ini ; 是否暴露PHP被安装在服务器上的事实(在http头中加上其签名)。 ; 他不会有安全上的直接威胁,但他使得客户端知道服务器上安装了PHP。 open_basedir = ;SYS ; 将PHP允许操作的任何文档(包括文档自身)都限制在此组目录列表下。 ; 当一个脚本试图打开一个指定目录树之外的文档时,将遭到拒绝。 ; 任何的符号连接都会被解析,所以不可能通过符号连接来避开此限制。 ; 特别值’.’指定了存放该脚本的目录将被当做基准目录。 ; 但这有些危险,因为脚本的工作目录能够轻易被chdir()改变。 ; 对于共享服务器,在httpd.conf中灵活配置该指令将变得很有用。 ; 在Windows中用分号分隔目录,UNIX系统中用冒号分隔目录。 ; 作为Apache模块时,父目录中的open_basedir路径将自动被继承。 ; 指定的限制实际上是个前缀,而非一个目录名, ; 也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls", ; 假如您希望将访问控制在一个指定的目录,那么请在结尾加上一个斜线。 ; 默认是允许打开任何文档。 [PHP-Core-Error] error_reporting = E_ALL & ~E_NOTICE ; 错误报告级别是位字段的叠加,推荐使用 E_ALL | E_STRICT ; 1 E_ERROR 致命的运行时错误 ; 2 E_WARNING 运行时警告(非致命性错误) ; 4 E_PARSE 编译时解析错误 ; 8 E_NOTICE 运行时提醒(经常是bug,也可能是有意的) ; 16 E_CORE_ERROR PHP启动时初始化过程中的致命错误 ; 32 E_CORE_WARNING PHP启动时初始化过程中的警告(非致命性错) ; 64 E_COMPILE_ERROR 编译时致命性错 ; 128 E_COMPILE_WARNING 编译时警告(非致命性错) ; 256 E_USER_ERROR 用户自定义的致命错误 ; 512 E_USER_WARNING 用户自定义的警告(非致命性错误) ; 1024 E_USER_NOTICE 用户自定义的提醒(经常是bug,也可能是有意的) ; 2048 E_STRICT 编码标准化警告(建议怎样修改以向前兼容) ; 4096 E_RECOVERABLE_ERROR 接近致命的运行时错误,若未被捕获则视同E_ERROR ; 6143 E_ALL 除E_STRICT外的任何错误(PHP6中为8191,即包含任何) track_errors = Off ; 是否在变量$php_errormsg中保存最近一个错误或警告消息。 display_errors = On ; 是否将错误信息作为输出的一部分显示。 ; 在最终发布的web站点上,强烈建议您关掉这个特性,并使用错误日志代替(参看下面)。 ; 在最终发布的web站点打开这个特性可能暴露一些安全信息, ; 例如您的web服务上的文档路径、数据库规划或别的信息。 display_startup_errors = Off ; 是否显示PHP启动时的错误。 ; 即使display_errors指令被打开,关闭此参数也将不显示PHP启动时的错误。 ; 建议您关掉这个特性,除非您必须要用于调试中。 report_memleaks = On ; 是否报告内存泄漏。这个参数只在以调试方式编译的PHP中起作用, ; 并且必须在error_reporting指令中包含 E_WARNING report_zend_debug = On ; 尚无说明文档 html_errors = On ; 是否在出错信息中使用HTML标记。 ; 注意: 不要在发布的站点上使用这个特性! docref_root = ;"http://localhost/phpmanual/" docref_ext = ;".html" ; 假如打开了html_errors指令,PHP将会在出错信息上显示超连接, ; 直接链接到一个说明这个错误或导致这个错误的函数的页面。 ; 您能够从http://www.php.net/docs.php下载php手册, ; 并将docref_root指令指向您本地的手册所在的URL目录。 ; 您还必须配置docref_ext指令来指定文档的扩展名(必须含有’.’)。 ; 注意: 不要在发布的站点上使用这个特性。 error_prepend_string = ;"" ; 用于错误信息前输出的字符串 error_append_string = ;"" ; 用于错误信息后输出的字符串 xmlrpc_errors = Off xmlrpc_error_number = 0 ; 尚无文档 [PHP-Core-Logging] define_syslog_variables = Off ; 是否定义各种系统日志变量,如:$LOG_PID, $LOG_CRON 等等。 ; 关掉他以提高效率的好主意。 ; 您能够在运行时调用define_syslog_variables()函数来定义这些变量。 error_log = ; 将错误日志记录到哪个文档中。该文档必须对Web服务器用户可写。 ; syslog 表示记录到系统日志中(NT下的事件日志, Unix下的syslog(3)) ; 假如此处未配置任何值,则错误将被记录到Web服务器的错误日志中。 log_errors = Off ; 是否在日志文档里记录错误,具体在哪里记录取决于error_log指令。 ; 强烈建议您在最终发布的web站点时使用日志记录错误而不是直接输出, ; 这样能够让您既知道那里出了问题,又不会暴露敏感信息。 log_errors_max_len = 1024 ; 配置错误日志中附加的和错误信息相关联的错误源的最大长度。 ; 这里配置的值对显示的和记录的错误连同$php_errormsg都有效。 ; 设为 0 能够允许无限长度。 ignore_repeated_errors = Off ; 记录错误日志时是否忽略重复的错误信息。 ; 错误信息必须出现在同一文档的同一行才被被视为重复。 ignore_repeated_source = Off ; 是否在忽略重复的错误信息时忽略重复的错误源。 [PHP-Core-Mail] ; 要使邮件函数可用,PHP必须在编译时能够访问sendmail程式。 ; 假如使用其他的邮件程式,如qmail或postfix,确保使用了相应的sendmail包装。 ; PHP首先会在系统的PATH环境变量中搜索sendmail,接着按以下顺序搜索: ; /usr/bin:/usr/sbin:/usr/etc:/etc:/usr/ucblib:/usr/lib ; 强烈建议在PATH中能够找到sendmail。 ; 另外,编译PHP的用户必须能够访问sendmail程式。 SMTP = "localhost" ; mail()函数中用来发送邮件的SMTP服务器的主机名称或IP地址。仅用于win32。 smtp_port = 25 ; SMTP服务器的端口号。仅用于win32。 sendmail_from = ; 发送邮件时使用的"From:"头中的邮件地址。仅用于win32 ; 该选项还同时配置了"Return-Path:"头。 sendmail_path = "-t -i" ;SYS ; 仅用于unix,也可支持参数(默认的是’sendmail -t -i’) ; sendmail程式的路径,通常为"/usr/sbin/sendmail或/usr/lib/sendmail"。 ; configure脚本会尝试找到该程式并设定为默认值,但是假如失败的话,能够在这里设定。 ; 不使用sendmail的系统应将此指令设定为sendmail替代程式(假如有的话)。 ; 例如,Qmail用户通常能够设为"/var/qmail/bin/sendmail"或"/var/qmail/bin/qmail-inject"。 ; qmail-inject 无需任何选项就能正确处理邮件。 mail.force_extra_parameters = ; 作为额外的参数传递给sendmail库的强制指定的参数附加值。 ; 这些参数总是会替换掉mail()的第5个参数,即使在安全模式下也是如此。 [PHP-Core-ResourceLimit] default_socket_timeout = 60 ; 默认socket超时(秒) max_execution_time = 30 ; 每个脚本最大允许执行时间(秒),0 表示没有限制。 ; 这个参数有助于阻止劣质脚本无休止的占用服务器资源。 ; 该指令仅影响脚本本身的运行时间,任何其他花费在脚本运行之外的时间, ; 如用system()/sleep()函数的使用、数据库查询、文档上传等,都不包括在内。 ; 在安全模式下,您不能用ini_set()在运行时改变这个配置。 memory_limit = 16M ; 一个脚本所能够申请到的最大内存字节数(能够使用K和M作为单位)。 ; 这有助于防止劣质脚本消耗完服务器上的任何内存。 ; 要能够使用该指令必须在编译时使用"--enable-memory-limit"配置选项。 ; 假如要取消内存限制,则必须将其设为 -1 。 ; 配置了该指令后,memory_get_usage()函数将变为可用。 max_input_time = -1 ; 每个脚本解析输入数据(POST, GET, upload)的最大允许时间(秒)。 ; -1 表示不限制。 post_max_size = 8M ; 允许的POST数据最大字节长度。此设定也影响到文档上传。 ; 假如POST数据超出限制,那么$_POST和$_FILES将会为空。 ; 要上传大文档,该值必须大于upload_max_filesize指令的值。 ; 假如启用了内存限制,那么该值应当小于memory_limit指令的值。 realpath_cache_size = 16K ;SYS ; 指定PHP使用的realpath(规范化的绝对路径名)缓冲区大小。 ; 在PHP打开大量文档的系统上应当增大该值以提高性能。 realpath_cache_ttl = 120 ;SYS ; realpath缓冲区中信息的有效期(秒)。 ; 对文档很少变动的系统,能够增大该值以提高性能。 [PHP-Core-FileUpLoad] file_uploads = On ;SYS ; 是否允许HTTP文档上传。 ; 参见upload_max_filesize, upload_tmp_dir, post_max_size指令 upload_max_filesize = 2M ; 允许上传的文档的最大尺寸。 upload_tmp_dir = ;SYS ; 文档上传时存放文档的临时目录(必须是PHP进程用户可写的目录)。 ; 假如未指定则PHP使用系统默认的临时目录。 [PHP-Core-MagicQuotes] ; PHP6将取消魔术引号,相当于下列指令全部为 Off magic_quotes_gpc = On ; 是否对输入的GET/POST/Cookie数据使用自动字符串转义( ’ " \ NULL )。 ; 这里的配置将自动影响 $_GEST $_POST $_COOKIE 数组的值。 ; 若将本指令和magic_quotes_sybase指令同时打开,则仅将单引号(’)转义为(’’), ; 其他特别字符将不被转义,即( " \ NULL )将保持原样!! ; 建议关闭此特性,并使用自定义的过滤函数。 magic_quotes_runtime = Off ; 是否对运行时从外部资源产生的数据使用自动字符串转义( ’ " \ NULL )。 ; 若打开本指令,则大多数函数从外部资源(数据库,文本文档等)返回数据都将被转义。 ; 例如:用SQL查询得到的数据,用exec()函数得到的数据,等等 ; 若将本指令和magic_quotes_sybase指令同时打开,则仅将单引号(’)转义为(’’), ; 其他特别字符将不被转义,即( " \ NULL )将保持原样!! ; 建议关闭此特性,并视具体情况使用自定义的过滤函数。 magic_quotes_sybase = Off ; 是否采用Sybase形式的自动字符串转义(用 ’’ 表示 ’) [PHP-Core-HighLight] highlight.bg = "#FFFFFF" highlight.comment = "#FF8000" highlight.default = "#0000BB" highlight.html = "#000000" highlight.keyword = "#007700" highlight.string = "#DD0000" ; 语法高亮模式的色彩(通常用于显示 .phps 文档)。 ; 只要能被接受的东西就能正常工作。 [PHP-Core-Langue] short_open_tag = On ; 是否允许使用""短标识。否则必须使用""长标识。 ; 除非您的php程式仅在受控环境下运行,且只供自己使用,否则请不要使用短标记。 ; 假如要和XML结合使用PHP,能够选择关闭此选项以方便直接嵌入"", ; 不然您必须用PHP来输出: ; 本指令也会影响到缩写形式"",这也会影响到缩写形式"0时自动垃圾回收将会失效,具体参见下面有关垃圾搜集的部分。 session.name = "PHPSESSID" ;用在cookie里的会话ID标识名,只能包含字母和数字。 session.auto_start = Off ; 在客户访问任何页面时都自动初始化会话,默认禁止。 ; 因为类定义必须在会话启动之前被载入,所以若打开这个选项,您就不能在会话中存放对象。 session.serialize_handler = "php" ; 用来序列化/解序列化数据的处理器,php是标准序列化/解序列化处理器。 ; 另外还能够使用"php_binary"。当启用了WDDX支持以后,将只能使用"wddx"。 session.gc_probability = 1 session.gc_divisor = 100 ; 定义在每次初始化会话时,启动垃圾回收程式的概率。 ; 这个收集概率计算公式如下:session.gc_probability/session.gc_divisor ; 对会话页面访问越频繁,概率就应当越小。建议值为1/1000~5000。 session.gc_maxlifetime = 1440 ; 超过此参数所指的秒数后,保存的数据将被视为’垃圾’并由垃圾回收程式清理。 ; 判断标准是最后访问数据的时间(对于FAT文档系统是最后刷新数据的时间)。 ; 假如多个脚本共享同一个session.save_path目录但session.gc_maxlifetime不同, ; 那么将以任何session.gc_maxlifetime指令中的最小值为准。 ; 假如使用多层子目录来存储数据文档,垃圾回收程式不会自动启动。 ; 您必须使用一个您自己编写的shell脚本、cron项或其他办法来执行垃圾搜集。 ; 比如,下面的脚本相当于配置了"session.gc_maxlifetime=1440" (24分钟): ; cd /path/to/sessions; find -cmin +24 | xargs rm session.referer_check = ; 假如请求头中的"Referer"字段不包含此处指定的字符串则会话ID将被视为无效。 ; 注意:假如请求头中根本不存在"Referer"字段的话,会话ID将仍将被视为有效。 ; 默认为空,即不做检查(全部视为有效)。 session.entropy_file = ;"/dev/urandom" ; 附加的用于创建会话ID的外部高熵值资源(文档), ; 例如UNIX系统上的"/dev/random"或"/dev/urandom" session.entropy_length = 0 ; 从高熵值资源中读取的字节数(建议值:16)。 session.use_cookies = On ; 是否使用cookie在客户端保存会话ID session.use_only_cookies = Off ; 是否仅仅使用cookie在客户端保存会话ID ; 打开这个选项能够避免使用URL传递会话带来的安全问题。 ; 但是禁用Cookie的客户端将使会话无法工作。 session.cookie_lifetime = 0 ; 传递会话ID的Cookie有效期(秒),0 表示仅在浏览器打开期间有效。 session.cookie_path = "/" ; 传递会话ID的Cookie作用路径。 session.cookie_domain = ; 传递会话ID的Cookie作用域。 ; 默认为空表示表示根据cookie规范生成的主机名。 session.cookie_secure = Off ; 是否仅仅通过安全连接(https)发送cookie。 session.cookie_httponly = Off ; 是否在cookie中添加httpOnly标志(仅允许HTTP协议访问), ; 这将导致客户端脚本(JavaScript等)无法访问该cookie。 ; 打开该指令能够有效预防通过XSS攻击劫持会话ID。 session.cache_limiter = "nocache" ; 设为{nocache|private|public}以指定会话页面的缓存控制模式, ; 或设为空以阻止在http应答头中发送禁用缓存的命令。 session.cache_expire = 180 ; 指定会话页面在客户端cache中的有效期限(分钟) ; session.cache_limiter=nocache时,此处配置无效。 session.use_trans_sid = Off ; 是否使用明码在URL中显示SID(会话ID)。 ; 默认是禁止的,因为他会给您的用户带来安全危险: ; 1- 用户可能将包含有效sid的URL通过email/irc/QQ/MSN...途径告诉给其他人。 ; 2- 包含有效sid的URL可能会被保存在公用电脑上。 ; 3- 用户可能保存带有固定不变sid的URL在他们的收藏夹或浏览历史纪录里面。 ; 基于URL的会话管理总是比基于Cookie的会话管理有更多的风险,所以应当禁用。 session.bug_compat_42 = On session.bug_compat_warn = On ; PHP4.2之前的版本有一个未注明的"BUG": ; 即使在register_globals=Off的情况下也允许初始化全局session变量, ; 假如您在PHP4.3之后的版本中使用这个特性,会显示一条警告。 ; 建议关闭该"BUG"并显示警告。 session.hash_function = 0 ; 生成SID的散列算法。SHA-1的安全性更高一些 ; 0: MD5 (128 bits) ; 1: SHA-1 (160 bits) ; 建议使用SHA-1。 session.hash_bits_per_character = 4 ; 指定在SID字符串中的每个字符内保存多少bit, ; 这些二进制数是hash函数的运算结果。 ; 4: 0-9, a-f ; 5: 0-9, a-v ; 6: 0-9, a-z, A-Z, "-", "," ; 建议值为 5 url_rewriter.tags = "a=href,area=href,frame=src,form=,fieldset=" ; 此指令属于PHP核心部分,并不属于Session模块。 ; 指定重写哪些HTML标签来包含SID(仅当session.use_trans_sid=On时有效) ; form和fieldset比较特别: ; 假如您包含他们,URL重写器将添加一个隐藏的"",他包含了本应当额外追加到URL上的信息。 ; 假如要符合XHTML标准,请去掉form项并在表单字段前后加上标记。 ; 注意:任何合法的项都需要一个等号(即使后面没有值)。 ; 推荐值为"a=href,area=href,frame=src,input=src,form=fakeentry"。 ;;;;;;;;;;;;;;;; ;; 其他模块 ;; ;;;;;;;;;;;;;;;; [APC] ; Alternative PHP Cache 用于缓存和优化PHP中间代码 apc.cache_by_default = On ;SYS ; 是否默认对任何文档启用缓冲。 ; 若设为Off并和以加号开头的apc.filters指令一起用,则文档仅在匹配过滤器时才被缓存。 apc.enable_cli = Off ;SYS ; 是否为CLI版本启用APC功能,仅用于测试和调试目的才打开此指令。 apc.enabled = On ; 是否启用APC,假如APC被静态编译进PHP又想禁用他,这是唯一的办法。 apc.file_update_protection = 2 ;SYS ; 当您在一个运行中的服务器上修改文档时,您应当执行原子操作。 ; 也就是先写进一个临时文档,然后将该文档重命名(mv)到最终的名字。 ; 文本编辑器连同 cp, tar 等程式却并不是这样操作的,从而导致有可能缓冲了残缺的文档。 ; 默认值 2 表示在访问文档时假如发现修改时间距离访问时间小于 2 秒则不做缓冲。 ; 那个不幸的访问者可能得到残缺的内容,但是这种坏影响却不会通过缓存扩大化。 ; 假如您能确保任何的更新操作都是原子操作,那么能够用 0 关闭此特性。 ; 假如您的系统由于大量的IO操作导致更新缓慢,您就需要增大此值。 apc.filters = ;SYS ; 一个以逗号分隔的POSIX扩展正则表达式列表。 ; 假如源文档名和任意一个模式匹配,则该文档不被缓存。 ; 注意,用来匹配的文档名是传递给include/require的文档名,而不是绝对路径。 ; 假如正则表达式的第一个字符是"+"则意味着任何匹配表达式的文档会被缓存, ; 假如第一个字符是"-"则任何匹配项都不会被缓存。"-"是默认值,能够省略掉。 apc.ttl = 0 ;SYS ; 缓存条目在缓冲区中允许逗留的秒数。0 表示永不超时。建议值为7200~36000。 ; 设为 0 意味着缓冲区有可能被旧的缓存条目填满,从而导致无法缓存新条目。 apc.user_ttl = 0 ;SYS ; 类似于apc.ttl,只是针对每个用户而言,建议值为7200~36000。 ; 设为 0 意味着缓冲区有可能被旧的缓存条目填满,从而导致无法缓存新条目。 apc.gc_ttl = 3600 ;SYS ; 缓存条目在垃圾回收表中能够存在的秒数。 ; 此值提供了一个安全措施,即使一个服务器进程在执行缓存的源文档时崩溃, ; 而且该源文档已被修改,为旧版本分配的内存也不会被回收,直到达到此TTL值为止。 ; 设为零将禁用此特性。 apc.include_once_override = Off ;SYS ; 关于该指令现在尚无说明文档,参见:http://pecl.php.net/bugs/bug.php?id=8754 ; 请保持为Off,否则可能导致意想不到的结果。 apc.max_file_size = 1M ;SYS ; 禁止大于此尺寸的文档被缓存。 apc.mmap_file_mask = ;SYS ; 假如使用--enable-mmap(默认启用)为APC编译了MMAP支持, ; 这里的值就是传递给mmap模块的mktemp风格的文档掩码(建议值为"/tmp/apc.XXXXXX")。 ; 该掩码用于决定内存映射区域是否要被file-backed或shared memory backed。 ; 对于直接的file-backed内存映射,要配置成"/tmp/apc.XXXXXX"的样子(恰好6个X)。 ; 要使用POSIX风格的shm_open/mmap就需要配置成"/apc.shm.XXXXXX"的样子。 ; 您还能够设为"/dev/zero"来为匿名映射的内存使用内核的"/dev/zero"接口。 ; 不定义此指令则表示强制使用匿名映射。 apc.num_files_hint = 1000 ;SYS ; Web服务器上可能被包含或被请求的不同源文档的大致数量(建议值为1024~4096)。 ; 假如您不能确定,则设为 0 ;此设定主要用于拥有数千个源文档的站点。 apc.optimization = 0 ; 优化级别(建议值为 0 ) 。 ; 正整数值表示启用优化器,值越高则使用越激进的优化。 ; 更高的值可能有很有限的速度提升,但现在尚在试验中。 apc.report_autofilter = Off ;SYS ; 是否记录任何由于early/late binding原因而自动未被缓存的脚本。 apc.shm_segments = 1 ;SYS ; 为编译器缓冲区分配的共享内存块数量(建议值为1)。 ; 假如APC耗尽了共享内存,并且已将apc.shm_size指令设为系统允许的最大值, ; 您能够尝试增大此值。 apc.shm_size = 30 ;SYS ; 每个共享内存块的大小(以MB为单位,建议值为128~256)。 ; 有些系统(包括大多数BSD变种)默认的共享内存块大小很少。 apc.slam_defense = 0 ;SYS(反对使用该指令,建议该用apc.write_lock指令) ; 在很繁忙的服务器上,无论是启动服务还是修改文档, ; 都可能由于多个进程企图同时缓存一个文档而导致竞争条件。 ; 这个指令用于配置进程在处理未被缓存的文档时跳过缓存步骤的百分率。 ; 比如设为75表示在碰到未被缓存的文档时有75%的概率不进行缓存,从而减少碰撞几率。 ; 鼓励设为 0 来禁用这个特性。 apc.stat = On ;SYS ; 是否启用脚本更新检查。 ; 改变这个指令值要很小心。 ; 默认值 On 表示APC在每次请求脚本时都检查脚本是否被更新, ; 假如被更新则自动重新编译和缓存编译后的内容。但这样做对性能有不利影响。 ; 假如设为 Off 则表示不进行检查,从而使性能得到大幅提高。 ; 但是为了使更新的内容生效,您必须重启Web服务器。 ; 这个指令对于include/require的文档同样有效。但是需要注意的是, ; 假如您使用的是相对路径,APC就必须在每一次include/require时都进行检查以定位文档。 ; 而使用绝对路径则能够跳过检查,所以鼓励您使用绝对路径进行include/require操作。 apc.user_entries_hint = 100 ;SYS ; 类似于num_files_hint指令,只是针对每个不同用户而言。 ; 假如您不能确定,则设为 0 。 apc.write_lock = On ;SYS ; 是否启用写入锁。 ; 在很繁忙的服务器上,无论是启动服务还是修改文档, ; 都可能由于多个进程企图同时缓存一个文档而导致竞争条件。 ; 启用该指令能够避免竞争条件的出现。 apc.rfc1867 = Off ;SYS ; 打开该指令后,对于每个恰好在file字段之前含有APC_UPLOAD_PROGRESS字段的上传文档, ; APC都将自动创建一个upload_的用户缓存条目(就是APC_UPLOAD_PROGRESS字段值)。 [bcmath] ; 为任意精度数学计算提供了二进制计算器(Binary Calculator), ; 他支持任意大小和精度的数字,以字符串形式描述。 bcmath.scale = 0 ; 用于任何bcmath函数的10十进制数的个数 [GD] gd.jpeg_ignore_warning = Off ; 是否忽略jpeg解码器的警告信息(比如无法识别图片格式)。 ; 有image/jpeg和image/pjpeg两种MIME类型,GD库只能识别前一种传统格式。 ; 参见:http://twpug.net/modules/newbb/viewtopic.php?topic_id=1867&forum=14 ; http://bugs.php.net/bug.php?id=29878 ; http://www.faqs.org/faqs/jpeg-faq/part1/section-11.html [Filter] ; 对来源不可靠的数据进行确认和过滤,本扩展模块是实验性的。 filter.default = "unsafe_raw" ; 使用指定的过滤器过滤$_GET,$_POST,$_COOKIE,$_REQUEST数据, ; 原始数据能够通过input_get()函数访问。 ; "unsafe_raw"表示不做任何过滤。 filter.default_flags = ; filter_data()函数的默认标志。 [mbstring] ;多字节字符串模块支持 mbstring.language = "neutral" ; 默认的NLS(本地语言配置),可配置值如下: ; 默认值"neutral"表示中立,相当于未知。 ; "zh-cn"或"Simplified Chinese"表示简体中文 ; "zh-tw"或"Traditional Chinese"表示繁体中文 ; "uni"或"universal"表示Unicode ; 该指令自动定义了随后的mbstring.internal_encoding指令默认值, ; 并且mbstring.internal_encoding指令必须放置在该指令之后。 mbstring.internal_encoding = ; 本指令必须放置在mbstring.language指令之后。 ; 默认的内部编码,未配置时取决于mbstring.language指令的值: ; "neutral" 对应 "ISO-8859-1" ; "zh-cn" 对应 "EUC-CN" (等价于"GB2312") ; "zh-tw" 对应 "EUC-TW" (等价于"BIG5") ; "uni" 对应 "UTF-8" ; 提醒:对于简体中文还能够强制配置为"CP936" (等价于"GBK") ; 注意:可能 SJIS, BIG5, GBK 不适合作为内部编码,但是"GB2312"肯定没问题。 ; 建议手动强制指定 mbstring.encoding_translation = Off ; 是否对进入的HTTP请求按照mbstring.internal_encoding指令进行透明的编码转换, ; 也就是自动检测输入字符的编码并将其透明的转化为内部编码。 ; 可移植的库或程式千万不要依赖于自动编码转换。 mbstring.http_input = "pass" ; 默认的HTTP输入编码,"pass"表示跳过(不做转换) ; "aotu"的含义和mbstring.detect_order指令中的解释相同。 ; 能够配置为一个单独的值,也能够配置为一个逗号分隔的列表。 mbstring.http_output = "pass" ; 默认的HTTP输出编码,"pass"表示跳过(不做转换) ; "aotu"的含义和mbstring.detect_order指令中的解释相同。 ; 能够配置为一个单独的值,也能够配置为一个逗号分隔的列表。 ; 必须将output_handler指令配置为"mb_output_handler"才能够。 mbstring.detect_order = ; 默认的编码检测顺序,"pass"表示跳过(不做转换)。 ; 默认值("auto")随mbstring.language指令的不同而变化: ; "neutral"和"universal" 对应 "ASCII, UTF-8" ; "Simplified Chinese" 对应 "ASCII, UTF-8, EUC-CN, CP936" ; "Traditional Chinese" 对应 "ASCII, UTF-8, EUC-TW, BIG-5" ; 建议在可控环境下手动强制指定一个单一值 mbstring.func_overload = 0 ;SYS ; 自动使用 mb_* 函数重载相应的单字节字符串函数。 ; 比如:mail(), ereg() 将被自动替换为mb_send_mail(), mb_ereg() ; 可用 0,1,2,4 进行位组合。比如7表示替换任何。具体替换说明如下: ; 0: 无替换 ; 1: mail() → mb_send_mail() ; 2: strlen() → mb_strlen() ; substr() → mb_substr() ; strpos() → mb_strpos() ; strrpos() → mb_strrpos() ; strtolower() → mb_strtolower() ; strtoupper() → mb_strtoupper() ; substr_count() → mb_substr_count() ; 4: ereg() → mb_ereg() ; eregi() → mb_eregi() ; ereg_replace() → mb_ereg_replace() ; eregi_replace() → mb_eregi_replace() ; split() → mb_split() mbstring.script_encoding = ; 脚本所使用的编码 mbstring.strict_detection = Off ; 是否使用严谨的编码检测 mbstring.substitute_character = ; 当某个字符无法解码时,就是用这个字符替代。 ; 若设为一个整数则表示对应的Unicode值,不配置任何值表示不显示这个错误字符。 ; 建议设为"□" mbstring.strict_encoding = Off ;默认值未知 ; enable strict encoding detection. ; 对于这个指令尚无说明文档(也未出现在phpinfo()的输出中) [Mcrypt] ; 一个mcrypt库的接口,该库支持许多种块加密算法。 ; 不建议使用该模块,因为毛病太多,建议在数据库层进行加密。 mcrypt.algorithms_dir = ; 默认的加密算法模块所在目录。通常是"/usr/local/lib/libmcrypt"。 ; 现在尚无周详说明文档,此处的解释可能是错误的。 mcrypt.modes_dir = ; 默认的加密模式模块所在目录。通常是"/usr/local/lib/libmcrypt"。 ; 现在尚无说明文档,此处的解释可能是错误的。 [Memcache] ; 一个高性能的分布式的内存对象缓存系统,通过在内存里维护一个统一的巨大的hash表, ; 他能够用来存储各种格式的数据,包括图像、视频、文档连同数据库检索的结果等。 memcache.allow_failover = On ; 是否在碰到错误时透明地向其他服务器进行故障转移。 memcache.chunk_size = 8192 ; 数据将按照此值设定的块大小进行转移。此值越小所需的额外网络传输越多。 ; 假如发现无法解释的速度降低,能够尝试将此值增加到32768。 memcache.default_port = 11211 ; 连接到memcached服务器时使用的默认TCP端口。 memcache.max_failover_attempts = 20 ; ???? [Zlib] ; 该模块允许PHP透明的读取和写入gzip(.gz)压缩文档。 zlib.output_compression = Off ; 是否使用zlib库透明地压缩脚本输出结果。 ; 该指令的值能够配置为:Off、On、字节数(压缩缓冲区大小,默认为4096)。 ; 假如打开该指令,当浏览器发送"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_compression_level = -1 ; 压缩级别,可用值为 0~9 ,0表示不压缩。值越高效果越好,但CPU占用越多,建议值为1~5。 ; 默认值 -1 表示使用zlib内部的默认值(6)。 zlib.output_handler = ; 在打开zlib.output_compression指令的情况下,您只能在这里指定输出处理器。 ; 能够使用的处理器有"zlib.inflate"(解压)或"zlib.deflate"(压缩)。 ; 假如启用该指令则必须将output_handler指令设为空。 [dbx] ; 一个数据库抽象层,为不同数据库提供了统一的接口。现在支持: ; FrontBase,SQL Server,MySQL,ODBC,PostgreSQL,Sybase-CT,Oracle 8,SQLite dbx.colnames_case = "unchanged" ;SYS ; 字段名能够按照"unchanged"或"uppercase","lowercase"方式返回。 [MySQLi] ; MySQLi模块只能和4.1.3以上版本的MySQL一起工作。 mysqli.max_links = -1 ;SYS ; 每个进程中允许的最大连接数(持久和非持久)。-1 代表无限制 mysqli.default_port = 3306 ; mysqli_connect()连接到MySQL数据库时使用的默认TCP端口。 ; 假如没有在这里指定默认值,将按如下顺序寻找: ; (1)$MYSQL_TCP_PORT环境变量 ; (2)/etc/services文档中的mysql-tcp项(unix) ; (3)编译时指定的MYSQL_PORT常量 ; 注意:Win32下,只使用MYSQL_PORT常量。 mysqli.default_socket = ; mysqli_connect()连接到本机MySQL服务器时所使用的默认套接字名。 ; 若未指定则使用内置的MqSQL默认值。 mysqli.default_host = ; mysqli_connect()连接到MySQL数据库时使用的默认主机。安全模式下无效。 mysqli.default_user = ; mysqli_connect()连接到MySQL数据库时使用的默认用户名。安全模式下无效。 mysqli.default_pw = ; mysqli_connect()连接到MySQL数据库时使用的默认密码。安全模式下无效。 ; 在配置文档中保存密码是个坏主意,任何使用PHP权限的用户都能够运行 ; ’echo cfg_get_var("mysql.default_password")’来显示密码! ; 而且任何对该配置文档有读权限的用户也能看到密码。 mysqli.reconnect = Off ;SYS ; 是否允许重新连接 [PostgresSQL] ;PostgresSQL模块建议和8.0以上版本一起工作。 pgsql.allow_persistent = On ;SYS ; 是否允许持久连接 pgsql.max_persistent = -1 ;SYS ; 每个进程中允许的最大持久连接数。-1 代表无限制。 pgsql.max_links = -1 ;SYS ; 每个进程中允许的最大连接数(持久和非持久)。-1 代表无限制。 pgsql.auto_reset_persistent = Off ;SYS ; 自动复位在pg_pconnect()上中断了的持久连接,检测需要一些额外开销。 pgsql.ignore_notice = Off ; 是否忽略PostgreSQL后端的提醒消息。 ; 记录后端的提醒消息需要一些很小的额外开销。 pgsql.log_notice = Off ; 是否在日志中记录PostgreSQL后端的提醒消息。 ; 仅在pgsql.ignore_notice=Off时,才能够记录。 |
喜欢本文,那就收藏到: |