转自 https://blog.csdn.net/seoyundu/article/details/101147041
中文翻译php.ini配置文件
1 [PHP 5.0.4 php.ini-dist] 2 3 ;;;;;;;;;; 4 ;; 警告 ;; 5 ;;;;;;;;;; 6 ; 这是PHP新安装时的默认设置。默认设置适合于开发但是不适合正式应用。 7 ; 出于安全方面考虑,请在发布正式应用程序时使用php.ini-recommended 8 ; 并且参考如下页面:http://php.net/manual/en/security.php 9 10 ;;;;;;;;;;;;;;;;;;; 11 ;; 关于 php.ini ;; 12 ;;;;;;;;;;;;;;;;;;; 13 ; 这个文件控制了PHP许多方面的性能和行为。 为了让PHP正确读取这个文件, 14 ; 它必须被命名为\'php.ini\'。PHP将按照如下顺序依次查找该文件: 15 ; 1.当前工作目录;2.环境变量PHPRC指明的路径;3.编译时指定的路径。 16 ; 在windows下,编译时的路径是Windows的安装目录(C:WINDOWS等)。 17 ; 在命令行模式下,php.ini的查找路径可以用 -c 参数指定。 18 ; 19 ; 该文件的语法非常简单。空白字符(" ","t",...)和用分号(";")开始的行被简单地忽略。 20 ; 章节标题(例如 : [php])也被简单地忽略,即使将来它们可能有某种意义。 21 ; 22 ; 设置格式如下: 23 ; directive = value 24 ; 指令标识符(directive) 是大小写敏感的! "foo=bar" 不同于 "FOO = bar"。 25 ; 值(value)可以是: 26 ; 1.一个字符串、2.一个数字、3.一个 PHP常量(如:E_ALL, M_PI)、 27 ; 4.一个INI常量(On, Off, True, False, Yes, No, None)、 28 ; 5.一个表达式(如:E_ALL & ~E_NOTICE)、 29 ; 6.用引号括起来的字符串("foo"). 30 ; 31 ; INI文件中的表达式仅限于使用位运算符/逻辑非/小括号。 32 ; | 位或 33 ; & 位与 34 ; ~ 位非 35 ; ! 逻辑非 36 ; 37 ; 布尔标志可用 1, On, True, Yes 打开,亦可用 0, Off, False, No 关闭。 38 ; 39 ; 一个空字符串可以用在等号后不写任何东西表示,或者用 none 关键字,举例如下: 40 ; foo = 将foo置为空字符串 41 ; foo = none 将foo置为空字符串 42 ; foo = "none" 将foo置为字符串\'none\' 43 ; 44 ; 如果你在值设置中使用常量,而这些常量属于动态扩展(PHP扩展或Zend扩展) 45 ; 那么你只能在调入这些动态扩展的行之后使用这些常量。 46 ; 47 ; 所有在 php.ini-dist 文件里设定的值与内建的默认值相同。 48 ; 也就是说,如果 php.ini 不存在,或者你删掉了某些行,默认值与之相同。 49 ;;;;;;;;;;;;;;; 50 ;;; 语言选项 ;; 51 ;;;;;;;;;;;;;;; 52 53 engine = On 54 ; 使PHP脚本语言引擎在Apache下有效。 55 56 zend.ze1_compatibility_mode = Off 57 ; 允许使用兼容Zend引擎1(PHP 4.x)的模式 58 59 short_open_tag = On 60 ; 允许 "" 短标识,否则只有""和""才能被识别。 61 ; 注意:除非你的php程序只供自己使用,否则请不要使用短标记。 62 ; 如果要和XML结合使用PHP,你可以选择禁用此选项以方便直接嵌入使用 , 63 ; 不然你必须用PHP来输出: 64 ; 本指令也会影响到缩写形式 65 asp_tags = Off 66 ; 是否允许ASP风格的标记"<% %>",这也会影响到缩写形式:<%= $value %> 67 68 precision = 12 69 ;[recommended]->precision = 14 70 ; 浮点型数据显示的有效位数 71 72 y2k_compliance = On 73 ; 强制打开2000年适应 (可能在非Y2K适应的浏览器中导致问题) 74 75 output_buffering = Off 76 ;[recommended]->output_buffering = 4096 77 ; 输出缓存允许你甚至在输出正文内容之后发送http头(包括cookies)。 78 ; 其代价是输出层减慢一点点速度。 79 ; 你可以在运行期间通过调用输出缓冲函数启用输出缓存。 80 ; 你还可以通过设置"output_buffering=On"来为所有文件启用输出缓存(默认4096)。 81 ; 如果你想指定缓冲区的最大字节数,你可以直接将"On"替换成数字, 82 ; 比如:"output_buffering=4096"指定了缓存上限为4096字节。 83 84 ;output_handler = 85 ; 你可以将所有脚本输出重定向到一个输出处理函数。 86 ; 比如,重定向到"mb_output_handler"函数时,字符编码将被透明地转换为指定的编码。 87 ; 一旦你在这里指定了输出处理程序,"output_buffering"将被自动打开。 88 ; 注意1: 在编写可移植脚本的时候不能依赖这个指令,而应明确的调用ob_start()函数打开输出缓存。 89 ; 使用这个指令可能会导致某些你不熟悉的脚本出错。 90 ; 注意2: 你不能同时使用"mb_output_handler"和"ob_iconv_handler" 91 ; 你也不能同时使用"ob_gzhandler"和"zlib.output_compression" 92 ; 注意3: 如果启用了zlib输出压缩,"output_handler"必须为空,取而代之,必须启用"zlib.output_handler"。 93 94 zlib.output_compression = Off 95 ; 使用zlib库透明地压缩脚本输出结果。 96 ; 该指令的值可以设置为:Off/On/字节数(用来作为压缩缓冲区大小,默认为4KB) 97 ; 如果在php.ini或者apache配置中打开这个功能,当浏览器发送"Accept-Encoding: gzip(deflate)"头时, 98 ; "Content-Encoding: gzip(deflate)"和"Vary: Accept-Encoding"头将加入到应答头当中。 99 ; 你可以在答头输出之前用ini_set()函数在脚本中禁止这个特性, 100 ; 如果你输出一个"Content-Type: image/"这样的应答头,压缩将不会启用(为了防止Netscape的bug)。 101 ; 你可以在输出"Content-Type: image/"之后使用"ini_set(\'zlib.output_compression\', \'On\')"重新打开这个特性。 102 ; 注意1: 压缩率会受压缩缓冲区大小的影响,如果你想得到更好的压缩质量,请指定一个较大的压缩缓冲区。 103 ; 注意2: 如果启用了zlib输出压缩,"output_handler"必须为空,取而代之,必须启用"zlib.output_handler"。 104 105 ;zlib.output_handler = 106 ; 在打开"zlib.output_compression"指令的情况下,除这里以外,你不能另外指定输出处理程序。 107 ; 这个指令和"output_handler"起相同的作用,但是顺序不同。 108 109 implicit_flush = Off 110 ; 这个指令告诉PHP输出层在每个输出块之后自动刷新自身数据。默认为 FALSE 111 ; 这等效于在每个print()、echo()、HTML块之后自动调用flush()函数。 112 ; 打开这个选项对程序执行的性能有严重的影响,通常只推荐在调试时使用。 113 ; 在CLI SAPI的执行模式下,该标记默认为 TRUE 。 114 115 unserialize_callback_func= 116 ; 如果解序列化程序需要实例化一个未定义类,该这里指定的回调函数将以该未定义类的名字作为参数被调用, 117 ; 以免得到不完整的"__PHP_Incomplete_Class"对象。 118 ; 如果这里没有指定函数,或者指定的函数不包含(或实现)那个未定义的类,将会显示一条警告信息。 119 ; 只有在你真想执行这样一个回调函数的情况下,才需要指定该参数的值。 120 ; 可以通过 php.ini、ini_set() 或 .htaccess 定义"unserialize_callback_func"。 121 ; 若要禁止这个特性,只需置空此设定。 122 123 serialize_precision = 100 124 ; 将浮点型和双精度型数据序列化存储时,序列化精度指明了有效位数。 125 ; 默认值能够确保浮点型数据被解序列化程序解码时不会有数据丢失。 126 127 allow_call_time_pass_reference = On 128 ;[recommended]->allow_call_time_pass_reference = Off 129 ; 强迫函数调用时按引用传递参数。 130 ; php反对使用这一方法,并可能在将来版本的PHP/Zend里不再支持。 131 ; 鼓励的方法是在函数声明里指定哪些参数按引用传递。 132 ; 我们鼓励你尝试关闭这一选项并确认你的脚本仍能正常工作,以保证你的脚本在将来版本的语言里仍能正常工作。 133 ; (每次使用此特性都会收到一条警告:参数会被按值传递而不是按照引用传递) 134 135 ;;;;;;;;;;;;; 136 ; 安全模式 137 138 safe_mode = Off 139 ; 安全模式 140 141 safe_mode_gid = Off 142 ; 安全模式默认情况下在打开文件时会做UID比较检查。 143 ; 如果你想将其放宽到GID比较,可以打开这个参数。 144 145 safe_mode_include_dir = 146 ; 在安全模式下,该文件夹和其子文件夹下的文件被包含时,将跳过UID/GID检查。 147 ; (文件夹必须必须在"include_path"中或者用完整路径来包含) 148 ; 从PHP4.2 开始,本指令可以接受和"include_path"指令类似的风格用分号隔开的路径,而不只是一个目录。 149 ; 指定的限制实际上是一个前缀,而非一个目录名,也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls" 150 ; 如果您希望将访问控制在一个指定的目录,那么请在结尾加上一个斜线,例如:"/dir/incl/" 151 152 safe_mode_exec_dir = 153 ; 在安全模式下,只有该文件夹下的可执行程序才能被允许通过system()和其它执行系统程序的函数执行。 154 ; 这些函数是:escapeshellarg, escapeshellcmd, exec, passthru, proc_close, proc_get_status, 155 ; proc_nice, proc_open, proc_terminate, shell_exec, system .... 156 157 safe_mode_allowed_env_vars = PHP_ 158 ; 该指令包含用逗号分隔的前缀列表,表示用户在安全模式下仅可以更改在此列出的前缀开头的环境变量的值。 159 ; 因为设置某些环境变量,可能会导致潜在的安全漏洞。 160 ; 默认地,用户将仅能设定以PHP_开头的环境变量,(如: PHP_FOO=BAR)。 161 ; 注意: 如果这一参数值为空,PHP将允许用户更改任意环境变量! 162 163 safe_mode_protected_env_vars = LD_LIBRARY_PATH 164 ; 这个指令包含一个用逗号分隔的环境变量列表,在安全模式下,列表中的变量是远端用户不能用putenv()更改的。 165 ; 这些变量甚至在"safe_mode_allowed_env_vars"设置为允许的情况下也会得到保护。 166 167 ;open_basedir = 168 ; 将PHP允许打开的所有文件都限制在此目录下。无论安全模式是否打开,该参数都将起作用。 169 ; 如果web服务器使用了per-directory或虚拟主机,这个参数将非常有意义。 170 ; 当一个脚本试图用例如fopen()或者gzopen()打开一个指定目录树之外的文件时,将遭到拒绝。 171 ; 所有的符号连接都会被解析,所以不可能通过符号连接来避开此限制。 172 ; 特殊值\'.\'指定了存放该脚本的目录将被当做基准目录。 173 ; 在Windows中,用分号分隔目录。在任何其它系统中用冒号分隔目录。 174 ; 作为Apache模块时,父目录中的open_basedir路径将自动被继承。 175 ; 用open_basedir指定的限制实际上是前缀,不是目录名。也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls" 176 ; 如果您希望将访问控制在一个指定的目录,那么请在结尾加上一个斜线,例如:"/dir/incl/" 177 ; 默认是允许打开所有文件。 178 179 disable_functions = 180 ; 这个指令让你可以出于安全原因禁用特定的函数。它接受一个用逗号分隔的函数名列表。 181 ; 无论安全模式是否打开,该参数都将起作用。 182 ; 本指令只能设置在php.ini中。例如你不能将其设置在httpd.conf中 183 184 disable_classes = 185 ; 这个指令让你可以出于安全原因禁用特定的类。它接受一个用逗号分隔的类名列表。 186 ; 无论安全模式是否打开,该指令都将起作用。本指令自 PHP 4.3.2 起可用。 187 ; 本指令只能设置在php.ini中。例如你不能将其设置在httpd.conf中 188 189 ;highlight.string = #DD0000 190 ;highlight.comment = #FF9900 191 ;highlight.keyword = #007700 192 ;highlight.bg = #FFFFFF 193 ;highlight.default = #0000BB 194 ;highlight.html = #000000 195 ; 语法高亮模式的色彩。 196 ; 只要能被接受的东西就能正常工作。 197 198 ;;;;;;;;; 199 ; 杂项 200 201 expose_php = On 202 ; 决定PHP是否暴露它被安装在服务器上的事实(比如出现在http头中) 203 ; 它不会有安全上的威胁, 但它使得检查你的服务器上是否安装了PHP成为了可能。 204 ;;;;;;;;;;;;;; 205 ;; 资源限制 ;; 206 ;;;;;;;;;;;;;; 207 208 max_execution_time = 30 209 ; 每个脚本最大允许执行时间, 按秒计。默认为30秒。 210 ; 这个参数有助于阻止劣质脚本无休止的占用服务器资源。 211 ; 注: "max_execution_time"仅影响脚本本身的运行时间。 212 ; 任何其它花费在脚本运行之外的时间,如用system()/sleep()函数的使用、数据库查询、文件上传等,都不包括在内。 213 ; 在安全模式下,你不能用ini_set()在运行时改变这个设置。 214 215 max_input_time = 60 216 ; 每个脚本接收输入数据的最大允许时间(POST, GET, upload), 按秒计 217 218 memory_limit = 8M 219 ; 设定一个脚本所能够申请到的最大内存字节数。 220 ; 这有助于防止劣质脚本消耗完服务器上的所有内存。 221 ; 要使用此指令必须在编译的时候激活。 222 ; 因此 configure 一行中应该包括:--enable-memory-limit 223 ; 如果不需要任何内存上的限制,必须将其设为 -1 224 ; 自php4.3.2 起,当设置了memory_limit后,memory_get_usage()函数将变为可用 225 226 ;;;;;;;;;;;;;;;;;;;; 227 ;; 出错处理和日志 ;; 228 ;;;;;;;;;;;;;;;;;;;; 229 230 error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT 231 ;[recommended]->error_reporting = E_ALL 232 ; 显示所有的错误,除了提醒和编码标准化警告。 233 ; 错误报告是位字段。可以将数字加起来得到想要的错误报告等级。 234 ; E_ALL - 所有的错误和警告(不包括 E_STRICT) 235 ; E_ERROR - 致命性的运行时错误 236 ; E_WARNING - 运行时警告(非致命性错误) 237 ; E_PARSE - 编译时解析错误 238 ; E_NOTICE - 运行时提醒(这些经常是你代码中的bug引起的,也可能是有意的行为造成的。) 239 ; E_STRICT - 编码标准化警告,允许PHP建议如何修改代码以确保最佳的互操作性向前兼容性。 240 ; E_CORE_ERROR - PHP启动时初始化过程中的致命错误 241 ; E_CORE_WARNING - PHP启动时初始化过程中的警告(非致命性错) 242 ; E_COMPILE_ERROR - 编译时致命性错 243 ; E_COMPILE_WARNING - 编译时警告(非致命性错) 244 ; E_USER_ERROR - 用户自定义的错误消息 245 ; E_USER_WARNING - 用户自定义的警告消息 246 ; E_USER_NOTICE - 用户自定义的提醒消息 247 ; 例子: 248 ;error_reporting = E_ALL & ~E_NOTICE ; 显示所有的错误,除了提醒 249 ;error_reporting = E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR ; 仅显示错误 250 251 display_errors = On 252 ;[recommended]->display_errors = Off 253 ; 作为输出的一部分显示出错误信息 254 ; 在最终发布的web站点上,强烈建议你关掉这个特性,并使用错误日志代替(参看下面)。 255 ; 在最终发布的web站点打开这个特性可能暴露一些安全信息, 256 ; 例如你的web服务上的文件路径、数据库规划或别的信息。 257 258 display_startup_errors = Off 259 ; 即使"display_errors"特性被打开,关闭此参数也将不显示PHP启动时的错误。 260 ; 强烈建议你关掉这个特性,除非你必须要用于调试中。 261 262 log_errors = Off 263 ;[recommended]->log_errors = On 264 ; 在日志文件里记录错误(服务器指定的日志,stderr标准错误输出,或error_log(下面的)) 265 ; 正如上面说明的那样,强烈建议你在最终发布的web站点时用日志记录错误而不是直接输出。 266 267 log_errors_max_len = 1024 268 ; 设置错误日志文件的最大长度。 269 ; 设为 0 可以允许无限长度。 270 271 ignore_repeated_errors = Off 272 ; 忽略重复的错误信息 273 ; 如果关闭这个参数,错误信息必须出现在同一个文件的同一行才被忽略。 274 ; 如果打开这个参数,则没有这个限制。 275 276 ignore_repeated_source = Off 277 ; 忽略重复的错误源 278 ; 忽略重复的错误信息时忽略重复的错误源 279 ; 如果打开这个参数,将不会记录不同的出错文件和对应行的错误信息。 280 281 report_memleaks = On 282 ; 报告内存泄漏 283 ; 如果关闭该参数,将不记录或者显示内存泄漏 284 ; 这个参数只在调试编译中起作用,并且必须在错误报告中包含 E_WARNING 285 286 track_errors = Off 287 ; 保存最近一个错误/警告消息于变量$php_errormsg (boolean)中 288 289 ;html_errors = Off 290 ; 禁用出错信息中的HTML标记 291 ; 注意: 不要在发布的程序中使用这个特性。 292 293 ;docref_root = "/phpmanual/" 294 ;docref_ext = .html 295 ; 如果打开了html_errors参数,PHP将会在出错信息上显示超连接, 296 ; 直接链接到一个说明这个错误或者导致这个错误的函数的页面。 297 ; 你可以从http://www.php.net/docs.php下载php手册,并设置docref_root参数,将他指向你本地的手册所在目录。 298 ; 你还必须设置"docref_ext"来指定文件的扩展名。 299 ; 注意: 不要在发布的程序中使用这个特性。 300 301 ;error_prepend_string = "" 302 ; 用于错误信息前输出的字符串 303 304 ;error_append_string = "" 305 ; 用于错误信息后输出的字符串 306 307 ;error_log = filename 308 ; 将错误日志记录到哪个文件中。 309 ; 如果设为"syslog", 错误日志将被记录到系统日志中(NT下的事件日志, Unix下的syslog(3)) 310 311 ;;;;;;;;;;;;;; 312 ;; 数据处理 ;; 313 ;;;;;;;;;;;;;; 314 315 ;arg_separator.output = "&" 316 ; PHP所产生的URL中来分隔参数的分隔符。默认值是"&" 317 318 ;arg_separator.input = ";&" 319 ; PHP解析URL中的变量时使用的分隔符列表,默认值是"&" 320 ; 注意: 字符串中的任何字符都将被看着分割符 321 322 variables_order = "EGPCS" 323 ;[recommended]->variables_order = "GPCS" 324 ; PHP注册 GET, POST, Cookie, Environment, Built-in 变量的顺序。 325 ; (以 G, P, C, E, S 表示,通常以 EGPCS 或 GPC 或 ES 的方式引用)。 326 ; 按从左到右记录,新值覆盖旧值。 327 ; 举例说,将其设为"GP",会导致 PHP 完全忽略环境变量、cookies 、server, 328 ; 并用 GET 方法的变量覆盖 POST 方法的同名变量 329 330 register_globals = Off 331 ; 是否将这些 EGPCS 变量注册为全局变量。自 PHP 4.2.0 开始,本指令默认为 off 332 ; 例如,如果打开这个特性,那么URL:http://www.example.com/test.php?id=3 将产生 $id 333 ; 或者从 $_SERVER[\'DOCUMENT_ROOT\'] 得到 $DOCUMENT_ROOT 。 334 ; 如果你不想让脚本中的全局变量和用户输入的数据搞混的话,请关闭它。 335 ; 推荐使用PHP的预定义变量来替代,例如超全局变量:$_ENV,$_GET,$_POST,$_COOKIE 和 $_SERVER 336 ; 请注意, register_globals不能在运行时设定(ini_set()),尽管在主机允许时可以用 .htaccess 来设置 337 ; 一个 .htaccess 项目的例子:php_flag register_globals on 338 ; 注: register_globals 受 variables_order 指令的影响。 339 340 register_long_arrays = On 341 ;[recommended]->register_long_arrays = Off 342 ; 是否启用旧式的长式数组(HTTP_*_VARS),推荐关闭该特性以获得更好的性能。 343 344 register_argc_argv = On 345 ;[recommended]->register_argc_argv = Off 346 ; 是否声明 argv和argc 变量(其中包含用GET方法传来的数据) 347 ; 【argv为变量数组,argc为变量数组中元素个数】 348 ; 若你不想使用这两个变量,应当关掉它以提高性能。 349 350 post_max_size = 8M 351 ; PHP接受的POST数据最大长度。此设定也影响到文件上传。 352 ; 要上传大文件,该值必须大于"upload_max_filesize" 353 ; 如果配置脚本中激活了内存限制,"memory_limit"也会影响文件上传。 354 ; 一般说来,"memory_limit"应该比"post_max_size"要大。 355 356 ;;;;;;;;;;;;;;;;;;;;;;;;;;; 357 ; 魔术引号(自动字符串转义) 358 359 magic_quotes_gpc = On 360 ;[recommended]->magic_quotes_gpc = Off 361 ; 在输入的GET/POST/Cookie数据里使用自动字符串转义【比如,值 (It\'s "HP!") 会自动转换成 (It\'s "HP!")】 362 ; 这里的设置自动影响$_GEST,$_POST,$_COOKIE数组的值。如果打开,值 (It\'s "HP!") 会自动转换成 (It\'s "PHP!")。 363 ; (个人意见:关闭此特性, 因为它在处理双字节汉字的时候可能会破坏某些繁体字和特殊字符) 364 365 magic_quotes_runtime = Off 366 ; 对运行时从外部资源产生的数据使用自动字符串转义 367 ; 例如:用SQL查询得到的数据,用exec()函数得到的数据,等等 368 369 magic_quotes_sybase = Off 370 ; 采用 Sybase形式的自动字符串转义( 用 \'\' 表示 \' 而不用 \' ) 371 372 auto_prepend_file = 373 ; 指定在主文件之前自动解析的文件名。 374 ; 该文件就像调用了include()函数一样被包含进来,因此会使用"include_path" 375 376 auto_append_file = 377 ; 指定在主文件之后自动解析的文件名。 378 ; 该文件就像调用了include()函数一样被包含进来,因此会使用"include_path" 379 ; 注: 如果脚本通过 exit() 终止,则自动后缀不会发生。 380 381 default_mimetype = "text/html" 382 ;default_charset = "iso-8859-1" 383 ; PHP总是默认地在"
全部评论
请发表评论