php.ini 配置详细选项
2024-05-04 22:56:02
供稿：网友
php.ini 配置详细选项
-----------------------------------------------------
php.ini 或 php3.ini 是 php 在启动时会读取的配置文件。该文件的存放路径
为 /usr/local/lib/。在 php 3.x 版的配置文件为 php3.ini；而在 php 4.x
版改为 php.ini。若 php 安装成服务器的模块，则在 web 服务器启动执行时
会读取，之后就不再读取，因此改动配置的话要重新启动 web 服务器。若使用
独立 php cgi 方式，则每次都读一次。
要看目前的系统配置，可以用 phpinfo() 看到。以下为选项配置
php_value name value
配置变量名称和值。本选项需 php 4.x 版之后才能使用。
php_flag name on|off
配置标志布尔变量选项。本选项需 php 4.x 版之后才能使用。
php_admin_value name value
配置 apache 的配置文件变量。原来在 .htaccess 的配置改到这个选项配置。
本选项需 php 4.x 版之后才能使用。
php_admin_flag name on|off
配置布尔变量当标志。本选项需 php 4.x 版之后才能使用。
asp_tags boolean
配置 php 程序是否解析以 asp script 语法 <% %> 的标记 (tag)。本选项在
php 3.0.4 之后才可使用。更多的细节可以参考 嵌入方法 的部份。
auto_append_file string
配置本选项可以让指定的文件附加在原 php 程序后面自动执行。若 php 程序
中有用到 exit() 函数，则指定的文件不会执行。参数 string 即为指定自动
执行的文件。
auto_prepend_file string
配置本选项可以让指定的文件在原 php 程序之前自动执行。参数 string 即为
指定自动执行的文件。
cgi_ext string
本选项配置 cgi 程序的扩展名。
display_errors boolean
本选项配置是否要将执行的错误信息显示在用户的浏览器上。
doc_root string
配置服务器的文件及 php 文件放置的根目录。
engine boolean
本选项需要使用apache的模块方式使用 php。可配置是否要使用 php 引擎。在
httpd.conf 中加入 php3_engine on/off 亦可配置某目录或某虚拟网站是否要
用 php 解析器。
error_log string
本选项用来配置错误记录文件。在 unix 系统上参数 string 即为文件名。
windows nt 会将记录记在事件检视器的日志之中。windows 95/98 则不支持系
统记录。
error_reporting integer
本选项用来配置系统记录的等级。参数 integer 即为等级的级数标志，可以加
在一起，默认值为 7，见下表
级数 说明
1 一般的错误
2 一般的警告
4 解析错误
8 非关键的警告
open_basedir string
本选项用来配置提供 php 存取的最底层目录。从该指定目录之下的文件或目录
，php 程序才能存取。使用本选项主要是为了系统安全性的考虑。参数 string
即为要限制的最底层目录节点。值得注意的是在 unix 系统中，若该节点之下
的文件或目录有符号链结 (symbolic link)，则可能会让使用本选项的目的打
折，因此在目录的设计上考虑，也是 webmaster 的重要任务。默认值是所有文
件均可存取。在 php 3.0.7 版之后，可以配置多个底层目录。
gpc_order string
配置 get/post/cookie 三种模块的顺序及规则。参数 string 即为要配置的规
则，例如：配置成 "gp" 表示忽视 cookie，并在存取方法 (method) 相同时，
以 post 取代 get。
ignore_user_abort string
默认值为 off。用来配置当传输未完成时，用户端断线是要继续处理。
include_path string
为 php 程序中 require、include 及 fopen_with_path 等函数的文件搜寻路
径。在 unix 或 windows 中的斜线方向不同。
log_errors boolean
指定程序错误时是否要记录在 log 文件中。
magic_quotes_gpc boolean
配置 get/post/cookie 三种模块的特殊字符，包含单引号、双引号、反斜线、
及空字符 (nul) 是否要自动加入反斜线当溢出字符。
magic_quotes_runtime boolean
配置返回资料是否自动加入反斜线当溢出字符。
magic_quotes_sybase boolean
配置 sybase 资料中单引号要自动加上反斜线当溢出字符。
max_execution_time integer
配置程序最久执行时间。单位是秒。
memory_limit integer
配置程序最多使用多少内存。
short_open_tag boolean
配置是否使用短的 php 标记 (<? ?>)。若不使用，则必须要用 <?php 作为程
序的开头，若要使程序合乎 xml 的标准则要关闭本功能。
track_errors boolean
打开本选项可使最后的错误信息跟着全局变量 $php_errormsg。
track_vars boolean
打开本选项可让用户输入的字符串自动解析到变量之中，而不用自己处理。
upload_tmp_dir string
指定上传文件临时路径。
user_dir string
指定用户根目录的路径。
warn_plus_overloading boolean
若打开本选项，字符串间就只能用英文的句号 (.) 链接，而不能用加号 (+)
链接字符串。
smtp string
在 windows 系列操作系统中，用来指定 smtp 服务器，供 mail 函数使用。参
数 string 为 smtp 服务器名字。
sendmail_from string
配置 "from: " 字符串供 windows 系列操作系统使用 mail 函数。
sendmail_path string
配置 sendmail 程序的放置路径。例如 /usr/sbin/sendmail。
safe_mode boolean
配置 php 在安全模式下执行。
safe_mode_exec_dir string
配置安全模式程序执行的路径。
debugger.host string
指定远端调试的服务器名称，可以是 ip 或 domain name。
debugger.port string
配置远端调试服务器的端口 (port)。
debugger.enabled boolean
配置是否可以为调试模式。
enable_dl boolean
本选项要使用apache模块 (apache module) 的方式才有效。用来配置 php 的
dl() 函数可否作用。当系统处于安全模式 (safe-mode) 时，本选项 enable
也无法使用 dl() 函数。
extension_dir string
配置动态函数的路径。
extension string
php 启动时所要载入的动态扩充功能。
mysql.allow_persistent boolean
配置是否允许 mysql 数据库持续连接 (persistent connections)，会影响
mysql_pconnect() 函数。
mysql.max_persistent integer
配置每个处理程序最多保持几个 mysql 持续连接。
mysql.max_links integer
配置每个处理程序最多开几个 mysql 连接，包括持续连接。
msql.allow_persistent boolean
配置是否允许 msql 数据库持续连接 (persistent connections)，会影响
msql_pconnect() 函数。
msql.max_persistent integer
配置每个处理程序最多保持几个 msql 持续连接。
msql.max_links integer
配置每个处理程序最多开几个 msql 连接，包括持续连接。
pgsql.allow_persistent boolean
配置是否允许 postgres 数据库持续连接 (persistent connections)，会影响
pg_pconnect() 函数。
pgsql.max_persistent integer
配置每个处理程序最多保持几个 postgres 持续连接。
pgsql.max_links integer
配置每个处理程序最多开几个 postgres 连接，包括持续连接。
sybase.allow_persistent boolean
配置是否允许 sybase 数据库持续连接 (persistent connections)，会影响
sybase_pconnect() 函数。
sybase.max_persistent integer
配置每个处理程序最多保持几个 sybase 持续连接。
sybase.max_links integer
配置每个处理程序最多开几个 sybase 连接，包括持续连接。
sybct.allow_persistent boolean
配置是否允许 sybase-ct 数据库持续连接 (persistent connections)，默认
值是打开的。
sybct.max_persistent integer
配置每个处理程序最多保持几个 sybase-ct 持续连接。默认值为 -1 表示无限
制。
sybct.max_links integer
配置每个处理程序最多开几个 sybase-ct 连接，包括持续连接。默认值为
-1，表示没有限制。
sybct.min_server_severity integer
配置 sybase-ct 服务器错误报告的最少笔数。默认值为 10。
sybct.min_client_severity integer
配置 sybase-ct 客户端错误报告的最少笔数。默认值为 10。
sybct.login_timeout integer
配置 sybase-ct 最久可以使用的登入时间。默认值为 1 分钟。
sybct.timeout integer
配置 sybase-ct 的 query 操作时间限制。默认值为无限制。
sybct.hostname string
配置 sybase-ct 可连接机器名称。默认值不设限
ifx.allow_persistent boolean
配置是否允许 informix 数据库持续连接 (persistent connections)，会影响
ifx_pconnect() 函数。
ifx.max_persistent integer
配置每个处理程序最多保持几个 informix 持续连接。
ifx.max_links integer
配置每个处理程序最多开几个 informix 连接，包括持续连接。
ifx.default_host string
配置 informix 默认连接的服务器名称，供 ifx_connect() 或
ifx_pconnect() 函数使用。
ifx.default_user string
配置 informix 默认连接的用户帐号，供 ifx_connect() 或 ifx_pconnect()
函数使用。
ifx.default_password string
配置 informix 默认连接的用户密码，供 ifx_connect() 或 ifx_pconnect()
函数使用。
ifx.blobinfile boolean
配置 informix 长位类模式，0 表在内存；1 表在文件中。亦可以在 php 程序
中使用 ifx_blobinfile_mode() 函数来修改。
ifx.textasvarchar boolean
配置 informix 文字模式默认值，0 表返回 blob 的代码；1 表返回 varchar
字符串。亦可在 php 程序中使用 ifx_textasvarchar() 函数来修改配置。
ifx.byteasvarchar boolean
配置 informix 位组模式默认值，0 表返回 blob 的代码；1 表返回 varchar
字符串。亦可在 php 程序中使用 ifx_byteasvarchar() 来修改配置。
ifx.charasvarchar boolean
配置 informix 返回字符串的字尾空格是否要自动去除。
ifx.nullformat boolean
配置 null 字段的返回方式，true 表示返回字符串 null，false 表格返回字
符串 ""。亦可在 php 程序中以 ifx_nullformat() 修改。
bcmath.scale integer
配置 bc 高精确度函数库的小数点位数。
browscap string
配置浏览器的开文件能力名。
uodbc.default_db string
配置 odbc 默认连接的数据库名称，供 odbc_connect() 或 odbc_pconnect()
函数使用。
uodbc.default_user string
配置 odbc 默认连接的用户帐号，供 odbc_connect() 或 odbc_pconnect() 函
数使用。
uodbc.default_pw string
配置 odbc 默认连接的用户密码，供 odbc_connect() 或 odbc_pconnect() 函
数使用。
uodbc.allow_persistent boolean
配置是否允许 odbc 数据库持续连接 (persistent connections)，会影响
odbc_pconnect() 函数。
uodbc.max_persistent integer
配置每个处理程序最多保持几个 odbc 持续连接。
uodbc.max_links integer
配置每个处理程序最多开几个 odbc 连接，包括持续连接。
以下和 session 有关的配置值，都在 php 4.x 以上的版本方支持。在
php.ini 的配置文件中。
session.save_handler
定义 session 储存资料的文件名称。默认值为 files。
session.save_path
定义 session 储存资料的文件路径。默认值为 /tmp。
session.name
配置 session 所使用的 cookie 名称。默认值为 phpsessid。
session.auto_start
配置 session 是否自动打开。默认值为 0 (否)。
session.lifetime
配置 cookie 送到浏览器后的保存时间，单位为秒。默认值为 0，表示直到浏
览器关闭。
session.serialize_handler
定义连续/解连续资料的标头，本功能只有 wddx 模块或 php 内部使用。默认
值为 php。
session.gc_probability
配置每笔要求回应时的废物蒐集 (gc, garbage collection) 处理机率。默认
值为 1。
session.gc_maxlifetime
配置废物被清除前的存活秒数。
session.extern_referer_check
决定参照到客户端的 session 代码是否要删除。有时在安全或其它考虑时，会
配置不删除。默认值为 0。
session.entropy_file
配置 session 代码建立时，使用外部高熵值资源或文件来建立，例如 unix 系
统上的 /dev/random 或 /dev/urandom。
session.entropy_length
配置 session 从高熵值资源读取的位组数。默认值为 0。
session.use_cookies
配置是否要将 session 变成 cookie 存在用户端。默认值为 1，表是打开本功
能。
