PHP 8.4.1 Released!

php.ini 配置段列表

这个列表包含 php.ini section,可以根据每个主机或路径进行设置以配置 PHP 环境。这些 section 是可选的。

这些 section 并不直接影响 PHP。它们用于将其他 php.ini 指令分组,并使其在特定主机或路径上生效。

这些 section 仅在 CGI/FastCGI 模式下使用,不能设置 extensionzend_extension 指令。

配置段
名字 可修改范围 更新日志
[HOST=] INI_SYSTEM  
[PATH=] INI_SYSTEM  

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

[HOST=<host>]

该 section 允许定义一组在指定主机上生效的 php.ini 指令。

示例 #1 dev. 域名激活完整的屏幕错误报告

[HOST=dev.site.com]
error_reporting = E_ALL
display_errors = On

[PATH=<path>]

该 section 允许定义一组脚本从指定路径运行时生效的 php.ini 指令。

示例 #2 受保护的区域添加安全脚本

[PATH=/home/site/public/secure]
auto_prepend_file=security.php

添加备注

用户贡献的备注 8 notes

up
8
public at grik dot net
15 years ago
In [HOST=...] one should use only the 1st server name from the list of server names.

I.E. if you have
server_name example.com, example2.com;
and will use www.example.com in a browser,
use [HOST=example.com] in php.ini for both addresses.

PHP looks not at the HOST request header (as I expected), but at the SERVER_NAME parameter (which by default is the 1st from the list of names, no matter what the HOST is).
up
3
robinhook at mail dot com
6 years ago
Sorry for the note. I've read some bad tutorials.
The correct syntax is : directive = 'value'
not a thing like : php_value[directive] = "somevalue"
up
3
robinhook at mail dot com
6 years ago
this HOST and PATH sections doesn't seems to work in php.ini under apache 2.4 with php-fpm 7.1.16 for directive php_value or php_admin_value open_basedir or include_path.
phpinfo() says "none" in master and local values.
up
1
dasloch at absatzen dot de
4 years ago
Note that you cannot usefully set syslog.* in [PATH=] (and probably [HOST=]) sections, since the syslogger is initialized only once per php-fpm worker process, and not per request.
up
1
crash at lubyte dot de
14 years ago
If you have a system which uses separated PHP inis for loading extensions (Debian, Fedora and most other distributions do so), [PATH=] or [HOST=] will prevent loading extensions defined in those ini files (extension= and zend_extension=).

I had some headache, when I added a hosts.ini to /etc/php5/cgi/conf.d (Debians default), where I wanted to define some defaults for a host name. The manual says extension= and zend_extension= aren't allowed in [HOST=] and [PATH=] (see above). I figured out that you can easily fix that with adding [PHP] after your definitions.

For example hosts.ini:
[HOST=dev.example.com]
display_errors = on

[PHP]

this will change the section back to [PHP] where extension= and zend_extension= is allowed.
up
1
leo
13 years ago
Just developed the probably first php.ini hack to add commands which will only be parsed before PHP 5.3 when using mod_php.

<?php

# Disable eAccelerator by default
eaccelerator.enable = 0

# Now, to prevent incompatibilities with Zend Optimizer+, we
# want to enable eAccelerator only in PHP 5.2 or lower.
[HOST=*]
eaccelerator.enable = 1

?>

What is happening here? In PHP 5.3, php.ini sections to set up PHP on a per host basis have been introduced:

http://www.php.net/manual/en/ini.sections.php

These sections only work in CGI/FastCGI mode, however there still seems to be a difference in how the php.ini file is parsed in PHP 5.2 and PHP 5.3 when using mod_php: PHP 5.3 ignores everything below the line [HOST=*], whereas PHP 5.2 does not.

In the above example, PHP 5.3 only reads "eaccelerator.enable = 0" and then stops at the invalid command [HOST=*]. However, PHP 5.2 seems to ignore the invalid command and parses the whole configuration file, ending up with "eaccelerator.enable = 1".
up
-1
z dot himdi at bita dot nl
13 years ago
On Windows IIS 7 server I noticed that [PATH=] was not listened to. [HOST=] however worked.
up
-1
robert dot johnson at icap dot com
14 years ago
Adding PATH= applies only to the named path and does not include sub-directories, you have to add a PATH= value for each sub-directory.

Also some settings have no effect even though phpinfo recognises and displays the per-folder value as the 'local' value, and the default as the 'master' value.

'fastcgi.impersonate' always uses the master setting.
To Top