List of php.ini sections
This list includes the php.ini sections you can set to configure your
PHP setup on a per Host or Path basis. These sections are optional.
These sections don't directly affect PHP. They are used to group other
php.ini directives together and to get them to act upon a particular host
or on a particular path.
These sections are used only in CGI/FastCGI mode and they can not set
extension and zend_extension directives.
Directives set in these sections cannot be overridden by
.user.ini files
or at runtime, like those set with
php_admin_value.
Regardless of their order in php.ini,
[PATH=] takes precedence over
[HOST=],
and a deeper path over a shallower one.
With PHP-FPM,
these sections also take precedence over the pool configuration
and FastCGI parameters, including php_admin_value
and PHP_ADMIN_VALUE.
Here's a short explanation of
the configuration directives.
-
[HOST=<host>]
-
This section allows you to define a set of php.ini directives that
will take effect on the named host.
Example #1 Activate full on-screen error reporting for dev. domain
[HOST=dev.site.com]
error_reporting = E_ALL
display_errors = On
-
[PATH=<path>]
-
This section allows you to define a set of php.ini directives that
will take effect when a script runs from the named path.
Example #2 Add security script for protected areas
[PATH=/home/site/public/secure]
auto_prepend_file=security.php
public at grik dot net ¶17 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).
robinhook at mail dot com ¶8 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.
leo ¶15 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
eaccelerator.enable = 0
[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".
crash at lubyte dot de ¶16 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.
dasloch at absatzen dot de ¶6 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.
robinhook at mail dot com ¶8 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"
robert dot johnson at icap dot com ¶16 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.