php.ini 核心配置选项说明

php.ini核心配置选项说明

转载：http://php.net/manual/zh/ini.core.php

该列表只包含核心的php.ini配置选项。扩展的配置选项在各个扩展的文档页面分别被描述。有关 session 的选项可以在sessions 页面找到。

Httpd 选项

Httpd 选项 名称 默认值 可修改范围 更新记录

async_send	"0"	PHP_INI_ALL

语言选项

语言和杂类配置选项 名称 默认值 可修改范围 更新记录

short_open_tag	"1"	PHP_INI_PERDIR	在 PHP <= 4.0.0 时是 PHP_INI_ALL。
asp_tags	"0"	PHP_INI_PERDIR	在 PHP <= 4.0.0 时是 PHP_INI_ALL。
precision	"14"	PHP_INI_ALL
y2k_compliance	"1"	PHP_INI_ALL
allow_call_time_pass_reference	"1"	PHP_INI_PERDIR	在 PHP <= 4.0.0 时是 PHP_INI_ALL。
expose_php	"1"	仅可在php.ini中配置。
zend.ze1_compatibility_mode	"0"	PHP_INI_ALL	从 PHP 5.0.0 起可用。

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

short_open_tagboolean

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

Note:

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

asp_tagsboolean

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

Note:

ASP 风格标志的支持是 3.0.4 版新加的。

precisioninteger

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

y2k_complianceboolean

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

allow_call_time_pass_referenceboolean

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

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

参见引用的解释。

expose_phpboolean

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

zend.ze1_compatibility_modeboolean

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

参见从 PHP 4 移植到 PHP 5。

资源限制

资源限制 名称 默认值 可修改范围 更新记录

memory_limit	"8M"	PHP_INI_ALL

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

memory_limitinteger

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

自 4.3.2 起，当激活了 memory_limit，PHP 函数memory_get_usage()便可以使用了。

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

参见max_execution_time。

性能调整

性能调整 名称 默认值 可修改范围 更新记录

realpath_cache_size	"16K"	PHP_INI_SYSTEM	自 PHP 5.1.0 起可用。
realpath_cache_ttl	"120"	PHP_INI_SYSTEM	自 PHP 5.1.0 起可用。

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

realpath_cache_sizeinteger

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

realpath_cache_ttlinteger

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

数据处理

数据处理配置选项 名称 默认值 可修改范围 更新记录

track_vars	"On"	PHP_INI_??
arg_separator.output	"&"	PHP_INI_ALL	从 PHP 4.0.5 起可用。
arg_separator.input	"&"	PHP_INI_PERDIR	从 PHP 4.0.5 起可用。
variables_order	"EGPCS"	PHP_INI_PERDIR	在 PHP <= 5.0.5 时是 PHP_INI_ALL。
auto_globals_jit	"1"	PHP_INI_PERDIR	从 PHP 5.0.0 起可用。
register_globals	"0"	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。
register_argc_argv	"1"	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。
register_long_arrays	"1"	PHP_INI_PERDIR	从 PHP 5.0.0 起可用。
post_max_size	"8M"	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.0.3 起可用。
gpc_order	"GPC"	PHP_INI_ALL
auto_prepend_file	NULL	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。
auto_append_file	NULL	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。
default_mimetype	"text/html"	PHP_INI_ALL
default_charset	""	PHP_INI_ALL
always_populate_raw_post_data	"0"	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.1.0 起可用。
allow_webdav_methods	"0"	PHP_INI_PERDIR

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

track_varsboolean

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

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

arg_separator.outputstring

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

arg_separator.inputstring

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

Note:

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

variables_orderstring

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

参见register_globals。

request_orderstring

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$_REQUESTcontents.

auto_globals_jitboolean

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

要使此选项有效，PHP 配置选项register_globals,register_long_arrays, 和register_argc_argv必须禁用。

register_globalsboolean

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

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

相关信息请阅读安全一章中的使用 register_globals。

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

Note:

register_globals受variables_order选项的影响。

register_argc_argvboolean

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

register_long_arraysboolean

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

post_max_sizeinteger

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

gpc_orderstring

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

Note:

本选项不能用于 PHP 4。用variables_order替代之。

auto_prepend_filestring

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

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

auto_append_filestring

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

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

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

default_mimetypestring

default_charsetstring

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

always_populate_raw_post_databoolean

总是产生$HTTP_RAW_POST_DATA变量包含有原始的 POST 数据。否则，此变量仅在碰到未识别 MIME 类型的数据时产生。不过，访问原始 POST 数据的更好方法是php://input。$HTTP_RAW_POST_DATA对于enctype="multipart/form-data"表单数据不可用。

allow_webdav_methodsboolean

允许在 PHP 脚本中处理 WebDAV 的 HTTP 请求（例如 PROPFIND，PROPPATCH，MOVE，COPY 等）。此选项在 PHP 4.3.2 以后便不存在了。如果要取得这些请求的 POST 数据，也要设定always_populate_raw_post_data。

参见magic_quotes_gpc，magic-quotes-runtime和magic_quotes_sybase。

路径和目录

路径和目录配置选项 名称 默认值 可修改范围 更新记录

include_path	".;/path/to/php/pear"	PHP_INI_ALL
doc_root	NULL	PHP_INI_SYSTEM
user_dir	NULL	PHP_INI_SYSTEM
extension_dir	"/path/to/php"	PHP_INI_SYSTEM
extension	NULL	仅限于php.ini
cgi.fix_pathinfo	"1"	PHP_INI_ALL	从 PHP 4.3.0 起可用
cgi.force_redirect	"1"	PHP_INI_ALL	从 PHP 4.2.0 起可用
cgi.redirect_status_env	NULL	PHP_INI_ALL	从 PHP 4.2.0 起可用
fastcgi.impersonate	"0"	PHP_INI_ALL	从 PHP 4.3.0 起可用
cgi.rfc2616_headers	"0"	PHP_INI_ALL	从 PHP 4.3.0 起可用

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

include_pathstring

指定一组目录用于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_rootstring

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

user_dirstring

在用户目录之下使用PHP文件的基本目录名，例如public_html。

extension_dirstring

PHP 用来寻找动态连接扩展库的目录。参见enable_dl和dl()。

extensionstring

当 PHP 启动时所加载的动态连接扩展库。

cgi.fix_pathinfoboolean

对 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_redirectboolean

在大多数 web 服务器中以 CGI 方式运行 PHP 时很有必要用 cgi.force_redirect 提供安全。PHP 默认其为 On。可以将其关闭，但风险自担。

Note:

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

cgi.redirect_status_envstring

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

Note:

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

fastcgi.impersonatestring

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

cgi.rfc2616_headersint

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

文件上传

文件上传配置选项 名称 默认值 可修改范围 更新记录

file_uploads	"1"	PHP_INI_SYSTEM	在 PHP <= 4.2.3 时是 PHP_INI_ALL。从 PHP 4.0.3 起可用。
upload_tmp_dir	NULL	PHP_INI_SYSTEM
upload_max_filesize	"2M"	PHP_INI_PERDIR	在 PHP <= 4.2.3 时是 PHP_INI_ALL。

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

file_uploadsboolean

是否允许 HTTP文件上传。参见upload_max_filesize，upload_tmp_dir和post_max_size指令。

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

upload_tmp_dirstring

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

upload_max_filesizeinteger

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

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

普通 SQL

普通 SQL 配置选项 名称 默认值 可修改范围 更新记录

sql.safe_mode	"0"	PHP_INI_SYSTEM

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

sql.safe_modeboolean

调试器配置选项

Caution

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

debugger.hoststring

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

debugger.portstring

调试器所用的端口号。

debugger.enabledboolean

是否启用调试器。

扩展库分类List of php.ini sections

---

[edit] Last updated: Fri, 19 Aug 2011

add a noteUser Contributed Notesphp.ini 核心配置选项说明

JL09-Sep-2011 04:46

If you need to use a path in your include_path that has a space in it - I found that I could make it work (in windows anyway) by setting a path like this
L:\Information Technology\Resources\lib\
in the include path like this listed below

include_path = ".;L:\Information" " Technology\Resources\lib\"

AntonioK10-Mar-2011 01:29

Note that there is no way to disable eval() work by using disable_functions directive, because eval() is a language construct and not a function.

Many people advise to disable such potentially-insecure functions like system(), exec(), passthru(), eval() and so on in php.ini when not running in safe mode, but eval() would still work even it listed in disable_functions.

rlammers at linuxmail dot org09-Jan-2011 12:23

This is a possible solution for a problem which seems to be a php-ini-problem but is not.

If a $_POST is used with large fields e.g. textarea's with more than 120kb characters php returns a blank screen, even if the max_post_size is 8M.

This problem may be caused by an apache-module SecFilter.

Adding the following lines to the .htaccess solves the problem.
SecFilterEngine Off
SecFilterScanPOST Off

I know this is not a php-issue, but i'm still posting it here since it looks like it is a php-problem and I did not find any sites or forums offering this solution.

amolitor at molitor-design dot com10-Feb-2010 11:23

Amusingly, the include_path logically includes the current directory of the running file as the last entry all the time anyways, so part of the business about shoving "." into the include_path is spurious -- it's "there" on the end all the time, at least in the 5.2.12 source (see main/fopen_wrappers.c around line 503).

This one had me goin' for a while.

libkhorse at gmail dot com06-Aug-2009 07:14

For 'short_open_tag',
though it is marked as PHP_INI_ALL in changable column,
you should note the CHANGE_LOG column also:

PHP_INI_ALL in PHP <= 4.0.0.
PHP_INI_PERDIR in PHP < 5.3.0

So as of 4.0, it will not work if you wanna use
ini_set('short_open_tag') to change it's value on the fly.

mrok at mrok dot com22-Mar-2009 04:29

Note that on some Unix systems (i.e. PHP 5.1.6 on Centos 5.2) include_path in php.ini should NOT be quoted.

For example, instead of

include_path='.:/usr/share/php'

use

include_path=.:/usr/share/php

Using quotes does not cause any error message, but all of your require_once() directives will fail (indicating that file could not be opened) - unless full path to target file is provided.

info at adaniels dot nl10-Feb-2009 04:12

When display_errors is off, PHP will send an HTTP 500 result header on a fatal error. This is usefull when working with AJAX applications.

the_tevildo at yahoo dot com19-Nov-2008 04:54

A handy trick to pick up parse errors in test_file.php if you can't set display_errors in php.ini or use .htaccess:

<?php
error_reporting(E_ALL);
ini_set('display_errors',true);
include('./test_file.php');
?>

senf_glas at hotmail dot com09-Apr-2008 11:31

"post_max_size"

"[..]This can be tracked in various ways, e.g. by passing the $_GET variable to the script processing the data, i.e. <form action="edit.php?processed=1">, and then checking if $_GET['processed'] is set."

using PHP 4.4.8 it seems that only the $_POST array will be empty in case of the file is largen than post_max_size.
so above mentioned method does not work in my case.
i need to use $_POST['processed'] instead of $_GET['processed']

Jeff11-Mar-2008 02:17

If you are having trouble getting the auto_prepend_file to work with the command line interface make sure that you have set it in the cli specific php.ini and that the read permission is set correctly for that php.ini file.

gilthans dot NO dot SPAM at gmail dot com03-Dec-2007 06:52

If you want to display the upload limit without knowing the server configuration, this may be useful:
<?php
functionlet_to_num($v){//This function transforms the php.ini notation for numbers (like '2M') to an integer (2*1024*1024 in this case)
$l=substr($v, -1);
$ret=substr($v,0, -1);
switch(strtoupper($l)){
case'P':
$ret*=1024;
case'T':
$ret*=1024;
case'G':
$ret*=1024;
case'M':
$ret*=1024;
case'K':
$ret*=1024;
break;
}
return$ret;
}
$max_upload_size=min(let_to_num(ini_get('post_max_size')),let_to_num(ini_get('upload_max_filesize')));

echo"Maximum upload file size is ".($max_upload_size/(1024*1024))."MB.";
?>
Do note however that this limit is not completely reliable; there are other factors which need to be taken into account, such as any other $_POST data and their size, the memory limit, and the script time limit. This does, however, give some rough limit, and helps you avoid "Doh!" problems where you can't figure out why your file won't upload. :)

stepheneliotdewey at GmailDotCom26-Jun-2007 11:03

While the manual says that the file specified by auto_prepend_file is included as if it were called by include(), in fact the file is included as if it were called by require().

In other words, if PHP cannot find the file that you specify with auto_prepend_file, it will throw a fatal error.

lanny at freemail dot hu25-Dec-2006 11:05

register_long_arrays has a very odd behavior (at least in PHP 5.2):

With register_long_arrays=Off the $GLOBALS array will not contain [_SERVER] and [_REQUEST]. They are accessible as superglobals ($_SERVER, $_REQUEST), but they disappear from the $GLOBALS array!

ludicruz at yahoo dot com19-Dec-2006 06:38

to make sure that all requests use SSL you can use this in a file that is set for auto_prepend_file. This ensures that all requests are SSL

<?php
if(empty($_SERVER['HTTPS']) ||strtolower($_SERVER['HTTPS']) !='on')
header("Location: https://{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}") and exit();
?>

xangelusx at hotmail dot com24-Jul-2006 02:28

I wish the documentation was more clear as to whether the arg_separator.output character is automatically encoded when PHP outputs it. In other words, is "&" valid or do I need to specify the encoded character "&"? It would make sense to specify only "&" and hope that it is encoded as needed. That way the value could be read by other functions and encoded only when output to HTML, rather than having to test whether it is already encoded and decode it when necessary (for header redirection for example)

leo at korfu dot cz29-May-2006 10:45

"If the size of post data is greater than post_max_size..."

It seems that a more elegant way is comparison between post_max_size and $_SERVER['CONTENT_LENGTH']. Please note that the latter includes not only size of uploaded file plus post data but also multipart sequences. Leo

csg at DEL_THISdiatom dot de02-Sep-2005 09:55

Starting with PHP 4.4.0 (at least PHP version 4.3.10 did have old, documented behaviour) interpretation of value of "session.save_path" did change in conjunction with "save_mode" and "open_basedir" enabled.

Documented (http://de.php.net/manual/en/ref.session.php#ini.session.save-path):
Values of "session.save_path" should or may be **without** ending slash.
For instance:
<?php
// Valid only *before* PHP 4.4.0:
ini_set("session.save_path","/var/httpd/kunde/phptmp");
?>will mean:
The directory "/var/httpd/kunde/phptmp/" will be used to write data and therefore must be writable by the web server.

Starting with PHP 4.4.0 the server complains that "/var/httpd/kunde/" is not writable.
Solution: Add an ending slash in call of ini_set (or probably whereever you set "session.save_path"), e.g.:
<?php
// Note the slash on ".....phptmp/":
ini_set("session.save_path","/var/httpd/kunde/phptmp/");
?>

Hope, that does help someone.

Manu27-Jul-2005 12:02

Warning, if you change upload_max_filesize, please note that both post_max_size and memory_limit directives may have to change too.

david dot tulloh at infaze dot com dot au27-Jun-2005 01:19

I did a little experimentation on the behaviour of auto_prepend_file as the order of access wasn't clear to me from the documentation.

1. Apache checks to see if the target file exists.
2. The prepend file is called
3. The target file is called

This means that you can use auto_prepend_file to change the target file before you access it however you can't generate new files.

Joe09-Jun-2005 08:05

Please be mindful, that if you plan on re-configuring / recompiling to add --enable-memory-limit support, you may need to run a 'make clean' before you run 'make'. Otherwise, you may end up with a phpinfo() that shows up with --enable-memory-limit as a configure parameter, but the memory_get_usage() function will still force a fatal error.