phpini配置说明.docx
《phpini配置说明.docx》由会员分享，可在线阅读，更多相关《phpini配置说明.docx（26页珍藏版）》请在冰豆网上搜索。
phpini配置说明
php5.2 的 php.ini 中文版文章来源：
网络
l7G$e0zU0;;;;;;;;;;;;;;
_t6AH_R_k.s_v_K0;; 简介 ;;PHPChina开源社区门户_]
{7`5s2b_[%I5g5F8a
;;;;;;;;;;;;;;
;}+g1Y:
J7s3a_S1q0;本文并非是对英文版php.ini的简单翻译，而是参考了众多资料以后，结合自己的理解，增加了许多内容，PHPChina开源社区门户_Y（G!
E_d_y_t%M0j_N
;包括在原有php.ini基础上增加了一些实用模块的配置说明，同时对文件内容的安排进行了调整。
PHPChina开源社区门户T1GD_r_N（cy�v_Q:
}
;由于作者不喜欢no-free的玩意儿，所以删除了除MySQL和PostgreSQL以外的其他数据库模块配置选项。
_B_z_j;\_o0D_@_Z0
9o!
|
\2[
M_C"e_}&I_[1d/k0;;;;;;;;;;;;;;;;;
_O_Y5Y&]�P/l0;;关于php.ini;;
_P_s9E9U_r_I?
_t0;;;;;;;;;;;;;;;;;PHPChina开源社区门户#_+n9u"T_@
;这个文件必须命名为'php.ini'并放置在httpd.conf中的PHPIniDir指令指定的目录中。
PHPChina开源社区门户8[*E_D/I_l_V
;最新版本的php.ini可以在下面两个位置查看：
PHPChina开源社区门户
d_r5T_x_@
;
）`+z_E&A3u_h[$p_y0;开源社区门户!
J_y3D_Q_P:
P）[
_K_}5y_Y_y'i/C0
p
x_f*K_e
_0;;;;;;;;;;;;
QO_P7I_V_d
T_m6J0;; 语法 ;;PHPChina开源社区门户_Z_Q/d）P"\_ad
;;;;;;;;;;;;PHPChina开源社区门户1@$Q;C6n8s*K_e_k__
;该文件的语法非常简单。
空白字符和以分号开始的行被简单地忽略。
PHPChina开源社区门户0T_x7D_s,n
;章节标题（例如:
[php]）也被简单地忽略，即使将来它们可能有某种意义。
PHPChina开源社区门户0G_~_@_l_Q_q
;PHPChina开源社区门户0h.De1k*I.au~_V
;设置指令的格式如下：
PHPChina开源社区门户__9N1K_\
j
;directive=valuePHPChina开源社区门户_r_x_P_l9J__8e/wv"k_I�x
;指令名（directive）是大小写敏感的！
所以"foo=bar"不同于"FOO=bar"。
/S1l!
}_G-|_h4S0;值（value）可以是：
PHPChina开源社区门户U_a_x%L
O_z�t
;1.用引号界定的字符串（如：
"foo"）PHPChina开源社区门户&H6s*K_N_{:
Z_B_U
;2.一个数字（整数或浮点数，如：
0,1,34,-1,33.55）PHPChina开源社区门户"I_B1{?
_`_c_u
;3.一个PHP常量（如：
E_ALL,M_PI）PHPChina开源社区门户_KT_],b_c0n-s_Y
;4.一个INI常量（On,Off,none）
P�Y-^_s_z_`_E-f-q1@0;5.一个表达式（如：
E_ALL&~E_NOTICE）PHPChina开源社区门户
D_|_]/m_^_z
;
*I_V_U8W-f_O0B
?
4l_B�T0;INI文件中的表达式仅使用：
位运算符、逻辑非、圆括号：
_O3g_j_R_r_R~%u_k
K0;|位或
L_j_m_h_q0;&位与
_V）c_wwc.{0;~位非PHPChina开源社区门户_~_N_z3r/E
;!
逻辑非PHPChina开源社区门户_s}5p%m_C/L�P
I#E
;
-j_Y_H_Y_Wy_]0;布尔标志用On表示打开，用Off表示关闭。
PHPChina开源社区门户"a_`1|_m7i_i-Cc�|
;PHPChina开源社区门户O!
D:
I1o1c&\1v8X
;一个空字符串可以用在等号后不写任何东西表示，或者用none关键字：
_E*{_]�Y9@
M_@0;foo= ;将foo设为空字符串
.Q_q_A5ZD$Z_`:
q2D0;foo=none ;将foo设为空字符串PHPChina开源社区门户_K_N+i_K）`-K（x_}
J^'n
;foo="none" ;将foo设为字符串'none'
_-[_I_^_R_a_A0;PHPChina开源社区门户_n_}8O_l7v_s.`_D,Ft3s
;如果你在指令值中使用动态扩展（PHP扩展或Zend扩展）中的常量，
_E*^_N#D_X
H6T_x0;那么你只能在加载这些动态扩展的指令行之后使用这些常量。
PHPChina开源社区门户_{E_?
#e'M9h_X$Z
PHPChina开源社区门户）w5A+m
m'g!
K_Pu9c
PHPChina开源社区门户_x（p_f_E$y!
L
j
;;;;;;;;;;;;;;;;;;PHPChina开源社区门户_X_I）l+N_{"E_~4g.v
;; httpd.conf ;;PHPChina开源社区门户_F_h_p_B9J_y
;;;;;;;;;;;;;;;;;;
_e_K_{_l&X"b9i+~_i0;还可以在httpd.conf中覆盖php.ini的值，以进行更灵活的配置：
PHPChina开源社区门户/_h1WY_|_U:
u（{:
Y
;php_valuenamevalue ;设置非bool型的指令，将value设为none则清除先前的设定
!
A-HX�H
y_L_U[_[0;php_flag nameon|off;仅用于设置bool型的指令PHPChina开源社区门户s7B8f_~d_I
;PHPChina开源社区门户_|6x_W_P_M_T7]0Q5e$}_S
;PHP常量（如E_ALL）仅能在php.ini中使用，在httpd.conf中必须使用相应的掩码值。
!
P|&C_W3K-u0;带"SYS"标志的指令只能在httpd.conf中的全局配置部分使用，PHPChina开源社区门户
I9WT_O_w（Y4q0|a_ox
;带"ini"标志的指令不能在httpd.conf中使用，它们仅能用于php.ini中。
PHPChina开源社区门户5j-H
d:
s$@
PHPChina开源社区门户;vM#AD"T_z7y_A
PHPChina开源社区门户_i_jU!
p+f[_z
;==========================================================================================PHPChina开源社区门户_I_M_T2w_Q
e0h#|_g|_I
;;=====================================配置指令详解========================================
p'WE5\H'N6xR:
[_X_h0;==========================================================================================
.~_h（D-C_|#?
P_?
&p0;以下每个指令的设定值都与PHP-5.2内建的默认值相同。
2V*w5g9l/F.P?
0;也就是说，如果'php.ini'不存在，或者你删掉了某些行，默认值与之相同。
PHPChina开源社区门户3D_W_U_y+N
PHPChina开源社区门户_g4z_J;j_z_C_u.~v
;;;;;;;;;;;;;;PHPChina开源社区门户:
N1Q�e+Z
d+D_J
;; Apache ;;PHPChina开源社区门户_M_P_a
iI8o）N!
i_y0c
;;;;;;;;;;;;;;
:
r_p"e）k,Y'K*L&Q+G0[Apache]PHPChina开源社区门户6vY_C!
[#__l_^1e_X
;仅在将PHP作为Apache模块时才有效。
_V+p_Rhr7A0
_g5O_f6__J4u_p.D|0engine=OnPHPChina开源社区门户3n_r*d
B8H8i_}"?
;n4Z
;是否启用PHP解析引擎。
.O%e_o
}_e"vm0;可以在httpd.conf中基于目录或者虚拟主机来打开或者关闭PHP解析引擎。
PHPChina开源社区门户0w_F（W1N_N-^_W'u_I（r^
PHPChina开源社区门户:
c$C_b_et_A#C0k
last_modified=OffPHPChina开源社区门户_m_]_t_y）}
e_^�R_L
;是否在Last-Modified应答头中放置该PHP脚本的最后修改时间。
PHPChina开源社区门户6y.{_^;r5Hi_k
j
_X-gL9j8@_\_Z0xbithack=OffPHPChina开源社区门户8Z8o5}9{8i0N
;是否不管文件结尾是什么，都作为PHP可执行位组来解析。
!
im_Z9w_R_L0
2G9P3v%m_b_Z_h_B0child_terminate=OffPHPChina开源社区门户3o3W
{.E+X
;PHP脚本在请求结束后是否允许使用apache_child_terminate（）函数终止子进程。
2a2y_S]7j_C_Z6I_X0;该指令仅在UNIX平台上将PHP安装为Apache1.3的模块时可用。
其他情况下皆不存在。
_w_K:
T_]_k_S&o_`K,c0
;q_Q0G*?
J9r
_B0
;Z_I9\（?
R+j]B3d1]0;;;;;;;;;;;;;;;
;\_G_E,V:
^9~/l:
]4t0;; PHP核心 ;;PHPChina开源社区门户_Z_h_h_C_\_t_m
;;;;;;;;;;;;;;;PHPChina开源社区门户8l%A_cE5I${
a
_h�q_M）v6K0[PHP-Core-DateTime]PHPChina开源社区门户%g4L_z_L_{0]@_`'{:
P
;前四个配置选项目前仅用于date_sunrise（）和date_sunset（）函数。
PHPChina开源社区门户_i6V_E,gy"w7A
PHPChina开源社区门户_b7{_A0f_N_i
date.default_latitude=31.7667PHPChina开源社区门户_gj_MSj%i_Y
;默认纬度
7\_\;W_f$L/B_x\_?
.{0
&c.V_s_d:
`_L7}）Z0date.default_longitude=35.2333PHPChina开源社区门户6u]_G_N_L6v_R_P_W7^V
;默认经度
.Y$^_}_NA_W_K0
2p-^5n.J_AO_D0date.sunrise_zenith=90.583333PHPChina开源社区门户_@4g,OJe.?
;默认日出天顶PHPChina开源社区门户_x_^*n_P"x_V.x_X_b_P_n_|
PHPChina开源社区门户2Q9d_nF_C___I-k_U"R
date.sunset_zenith=90.583333PHPChina开源社区门户_K$j_~;X_i"y"^/e
;默认日落天顶
）q_Z_Q'\;s_?
9k_P0
;b%n_C_J+__Q_c0date.timezone=
_N{_I）Gk_U_v0;未设定TZ环境变量时用于所有日期和时间函数的默认时区。
PHPChina开源社区门户_\+W_l_Z!
J7t/E-G_I
;中国大陆应当使用"PRC"
6D4I_u_H3\0;应用时区的优先顺序为：
PHPChina开源社区门户_E}_|+U#}_`�[_d0e6]
;1.用date_default_timezone_set（）函数设定的时区（如果设定了的话）PHPChina开源社区门户_H2s9y_f_s&^_]
;2.TZ环境变量（如果非空的话）PHPChina开源社区门户_T'\Y:
d_Z
;3.该指令的值（如果设定了的话）
_p$P
U
H_J\_so0;4.PHP自己推测（如果操作系统支持）
$r+xY_[_BF|&}0;5.如果以上都不成功，则使用UTC
_F（g_@,r_E6M2N-z0
_V+A�U）A（{.Ko0
Z_C_j*t|5m�~_C_s3n0[PHP-Core-Assert]
j_i:
U,X__�z,A_A0
^9m_w_Z）v0assert.active=On
_{_o_y$I6d%__P"q0;是否启用assert（）断言评估
_r#\N
F_w_J3V-J-b&b+M
J0
/p
sj_O1d�K:
M0assert.bail=OffPHPChina开源社区门户_C%V:
a2]_X_]*J
;是否在发生失败断言时中止脚本的执行
_Q/l_a&d_k0
L-t%B$b_F"B_O0assert.callback=PHPChina开源社区门户_b%d!
p_m_A~
LX
;发生失败断言时执行的回调函数
1g2L_B*Y8Y/~6ca_Q0PHPChina开源社区门户4J_Ds3r:
CB\_~
assert.quiet_eval=Off
/V:
p;e5bC3n__0;是否使用安静评估（不显示任何错误信息，相当于error_reporting=0）。
_x_l
XT:
t\n+R_X7~_j0;若关闭则在评估断言表达式的时候使用当前的error_reporting指令值。
PHPChina开源社区门户_Ug
o_f_R_q_p%I_i$D
PHPChina开源社区门户W#@_V_K_e_S（___
assert.warning=On
+h2n）w（m/`_z_A_v0;是否对每个失败断言都发出警告PHPChina开源社区门户�Q,r_W_l.o$@_c
0L_CD_]Z_G�I_c0PHPChina开源社区门户_G_~*d9j
U.X_b%b
[PHP-Core-SafeMode]
&}）L6_（O
u_C"Ss_X_aG0N6m_~0;安全模式是为了解决共享服务器的安全问题而设立的。
_AA5X*c;X_D
U:
~9N;l0;但试图在PHP层解决这个问题在结构上是不合理的，PHPChina开源社区门户/Q0M_l'S.u
;正确的做法应当是修改web服务器层和操作系统层。
PHPChina开源社区门户_N_PW_}_T!
R
;因此在PHP6中废除了安全模式，并打算使用open_basedir指令取代之。
PHPChina开源社区门户!
^5R_@
fGG_s"V
#^*{2gF_X�J!
XO0safe_mode=OffPHPChina开源社区门户Y'~4~$F_Q）y_d
;SYSPHPChina开源社区门户_k_n0@.X0m-C_[1p
;是否启用安全模式。
PHPChina开源社区门户8G_d_e_f
d_}
;打开时，PHP将检查当前脚本的拥有者是否和被操作的文件的拥有者相同，PHPChina开源社区门户%P
f1F8{5~8e_z
;相同则允许操作，不同则拒绝操作。
_C#r|_y_`2}Z_e0
A'C_S_R.o
@0safe_mode_gid=OffPHPChina开源社区门户_Ok'b�B-j_Rg
;SYSPHPChina开源社区门户_S#C_n�?
_Y_g_U1c
D
;在安全模式下，默认在访问文件时会做UID比较检查。
PHPChina开源社区门户_Ui
]_S
?
;但有些情况下严格的UID检查反而是不适合的，宽松的GID检查已经足够。
PHPChina开源社区门户_G_d%c_P_d_i_q
;如果你想将其放宽到仅做GID比较，可以打开这个参数。
_P_N_Y4^__9O）d6P_A+G0PHPChina开源社区门户6X-H_Nj_J5q7K+R8H）Z）Q
safe_mode_allowed_env_vars="PHP_"PHPChina开源社区门户_k_Q$x_V__
;SYSPHPChina开源社区门户_D_e2d_{_~_D_F_X
;在安全模式下，用户仅可以更改的环境变量的前缀列表（逗号分隔）。
4w_kF_n,[.F0;允许用户设置某些环境变量，可能会导致潜在的安全漏洞。
PHPChina开源社区门户4w/Xe
y_Rc_s*s
;注意:
如果这一参数值为空，PHP将允许用户更改任意环境变量！
（^]"GW*O
F;X0PHPChina开源社区门户5Q_D5s2Y0U_J_[1G
safe_mode_protected_env_vars="LD_LIBRARY_PATH"PHPChina开源社区门户:
}_h;T_e/T_b5I
;SYSPHPChina开源社区门户_t_c_?
1z_t
;在安全模式下，用户不能更改的环境变量列表（逗号分隔）。
PHPChina开源社区门户_lK.E:
jW9j_A5S
;这些变量即使在safe_mode_allowed_env_vars指令设置为允许的情况下也会得到保护。
PHPChina开源社区门户
l_D'kFd
9]_y_Y$Q-@_o_n_|0safe_mode_exec_dir="/usr/local/php/bin"
_O_g
aU_W_B_mt_a_P5K0;SYS
4[_a_c;ZB9r}*@0;在安全模式下，只有该目录下的可执行程序才允许被执行系统程序的函数执行。
_~_g_x_^6f.z5Y0;这些函数是：
system,escapeshellarg,escapeshellcmd,exec,passthru,PHPChina开源社区门户"d.j2U_Lw_Zh
;proc_close,proc_get_status,proc_nice,proc_open,proc_terminate,shell_execPHPChina开源社区门户1I（[_A@_A
PHPChina开源社区门户_j_c6G"f_w
safe_mode_include_dir=PHPChina开源社区门户.C
U%Z8DU_W8T
;SYSPHPChina开源社区门户_]_G4y;]!
a,fl.LJ_s
;在安全模式下，该组目录和其子目录下的文件被包含时，将跳过UID/GID检查。
PHPChina开源社区门户_l.K）H_S7fe*Z_U_[_S7F
;换句话说，如果此处的值为空，任何UID/GID不符合的文件都不允许被包含。
4_"G-x,N2lE:
i!
i_Q0;这里设置的目录必须已经存在于include_path指令中或者用完整路径来包含。
PHPChina开源社区门户2f0g8E_w（z
H_f}
;多个目录之间用冒号（Win下为分号）隔开。
.K2|5a+j_r_a$d0;指定的限制实际上是一个前缀，而非一个目录名，PHPChina开源社区门户.XM_h_e_x_A
;也就是说"/dir/incl"将允许访问"/dir/include"和"/dir/incls"PHPChina开源社区门户_E#A_E_T8k�t!
l_f
;如果您希望将访问控制在一个指定的目录，那么请在结尾加上斜线。
p9h_L_k%|"k
c0PHPChina开源社区门户0f（X_lF_R_?
#[
C
sql.safe_mode=OffPHPChina开源社区门户_cY_{_o.B_q6l_u_\
;SYSPHPChina开源社区门户_|ia_t6z
;是否使用SQL安全模式。
PHPChina开源社区门户_^;x_~_ZX_{
;如果打开，指定默认值的数据库连接函数将会使用这些默认值代替支持的参数。
_x&t_n_^_y0Z0;对于每个不同数据库的连接函数，其默认值请参考相应的手册页面。
PHPChina开源社区门户_Z9sx_o_`1P
PHPChina开源社区门户*dx_G!
|_[p@
PHPChina开源社区门户,H*b_CK_@%`9`_~!
B1q_|
[PHP-Core-Safe]PHPChina开源社区门户_D_O!
T_V_}/x_v,f&@
PHPChina开源社区门户_Q"\_M%l&Q_|_t
allow_url_fopen=On
"~$b'U�q_V_|_[_]0;iniPHPChina开源社区门户_k
N_g4zU,Z
;是否允许打开远程文件
_C（Z_l_t_Y0PHPChina开源社区门户%D9I!
}_V#?
_s.Z
allow_url_include=OffPHPChina开源社区门户G_N:
Q_Pu_B
^
;SYS
_O_q5P^&I'L�\0;是否允许include/require远程文件。
$f3[A;f_w.E0@7t.Z0PHPChina开源社区门户"[_F4s_N4i4o_n4rK
disable_classes=PHPChina开源社区门户_N`_m']_V}_o4]
;ini
H_I.Q'Iq_i0;该指令接受一个用逗号分隔的类名列表，以禁用特定的类。
PHPChina开源社区门户_c0@'L%j_I/T0p_t
_g"oH（[b0disable_functions=PHPChina开源社区门户-^4G_w_W$P7n_y_k1l_W）^
;iniPHPChina开源社区门户
?
0u-D+v_u
;该指令接受一个用逗号分隔的函数名列表，以禁用特定的函数。
_V6[2e5?
_z+__K&F,V'K（n0
_B_A'W_u_GU9t_V,e0enable_dl=On
2j_I&v5x~_H_w,^B0;SYSPHPChina开源社区门户l4N1W2D_S.~
;是否允许使用dl（）函数。
dl（）函数仅在将PHP作为apache模块安装时才有效。
4i_e_a_P$c_o4A_r_v_W:
O/@0;禁用dl（）函数主要是出于安全考虑，因为它可以绕过open_basedir指令的限制。
5vo4U
o_r_d0;
升级会员 