欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

php-5.2下php.ini 中文版配置说明第1/3页

程序员文章站 2022-07-10 23:50:00
;;;;;;;;;;;; ;; 语法 ;; ; 该文件的语法非常简单。空白字符和以分号开始的行被简单地忽略。 ; 章节标题(例如: [php])也被简单地忽略,即使将来它们...
;;;;;;;;;;;;
;; 语法 ;;

; 该文件的语法非常简单。空白字符和以分号开始的行被简单地忽略。
; 章节标题(例如: [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中的全局配置部分使用。

;[2007-4-9日更新,增加了更多关于php6的信息,并根据php-5.2.2修正和添加了一些信息]
;=============================================
;;==========配置指令详解===========================
;=============================================
; 以下每个指令的设定值都与 php-5.2.2 内建的默认值相同。
; 也就是说,如果'php.ini'不存在,或者你删掉了某些行,默认值与之相同。

;;;;;;;;;;;;;;
;; apache ;;

[apache]
; 仅在将php作为apache模块时才有效。

child_terminate = off
; php脚本在请求结束后是否允许使用apache_child_terminate()函数终止子进程。
; 该指令仅在unix平台上将php安装为apache1.3的模块时可用。其他情况下皆不存在。

engine = on
; 是否启用php解析引擎。
; 提示:可以在httpd.conf中基于目录或者虚拟主机来打开或者关闭php解析引擎。

last_modified = off
; 是否在last-modified应答头中放置该php脚本的最后修改时间。

xbithack = off
; 是否不管文件结尾是什么,都作为php可执行位组来解析。



;; 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的安全防护。
; 此部分指令在php6中已经全部被删除。

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"
; 如果您希望将访问控制在一个指定的目录,那么请在结尾加上斜线。


[php-core-safe]

allow_url_fopen = on
;sys
; 是否允许打开远程文件

allow_url_include = off
;sys
; 是否允许include/require远程文件。

disable_classes =
;sys
; 该指令接受一个用逗号分隔的类名列表,以禁用特定的类。

disable_functions =
;sys
; 该指令接受一个用逗号分隔的函数名列表,以禁用特定的函数。

enable_dl = on
;sys
; 是否允许使用dl()函数。dl()函数仅在将php作为apache模块安装时才有效。
; 禁用dl()函数主要是出于安全考虑,因为它可以绕过open_basedir指令的限制。
; 在安全模式下始终禁用dl()函数,而不管此处如何设置。
; php6中删除了该指令,相当于设为off。

expose_php = on
;sys
; 是否暴露php被安装在服务器上的事实(在http头中加上其签名)。
; 它不会有安全上的直接威胁,但它使得客户端知道服务器上安装了php。

open_basedir =
;sys
; 将php允许操作的所有文件(包括文件自身)都限制在此组目录列表下。
; 当一个脚本试图打开一个指定目录树之外的文件时,将遭到拒绝。
; 所有的符号连接都会被解析,所以不可能通过符号连接来避开此限制。
; 特殊值'.'指定了存放该脚本的目录将被当做基准目录。
; 但这有些危险,因为脚本的工作目录可以轻易被chdir()改变。
; 对于共享服务器,在httpd.conf中灵活设置该指令将变得非常有用。
; 在windows中用分号分隔目录,unix系统中用冒号分隔目录。
; 作为apache模块时,父目录中的open_basedir路径将自动被继承。
; 指定的限制实际上是一个前缀,而非一个目录名,
; 也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls",
; 如果您希望将访问控制在一个指定的目录,那么请在结尾加上一个斜线。
; 默认是允许打开所有文件。

sql.safe_mode = off
;sys
; 是否使用sql安全模式。
; 如果打开,指定默认值的数据库连接函数将会使用这些默认值代替支持的参数。
; 对于每个不同数据库的连接函数,其默认值请参考相应的手册页面。


[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 = ;"<font color=#f00>"
; 用于错误信息前输出的字符串
error_append_string = ;"</font>"
; 用于错误信息后输出的字符串

xmlrpc_errors = off
;sys
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
; 是否在忽略重复的错误信息时忽略重复的错误源。

1