svn: /phpdoc/en/trunk/install/ ini.xml
| From: | Gwynne Raskind | Date: | Sun, 26 Jul 2009 10:50:53 +0000 |
| Subject: | svn: /phpdoc/en/trunk/install/ ini.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-4514@lists.php.net to get a copy of this message | ||
gwynne Sun, 26 Jul 2009 10:50:53 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=286357
Log:
cheap documentation for the .user.ini functionality
Changed paths:
U phpdoc/en/trunk/install/ini.xml
Modified: phpdoc/en/trunk/install/ini.xml
===================================================================
--- phpdoc/en/trunk/install/ini.xml 2009-07-26 10:17:04 UTC (rev 286356)
+++ phpdoc/en/trunk/install/ini.xml 2009-07-26 10:50:53 UTC (rev 286357)
@@ -120,6 +120,50 @@
":/new/dir"</literal>.
</para>
</sect1>
+
+ <sect1 xml:id="configuration.file.per-user">
+ <title>.user.ini files</title>
+
+ <simpara>
+ Since PHP 5.3.0, PHP includes support for .htaccess-style INI files on a
+ per-directory basis. These files are processed <emphasis>only</emphasis> by
+ the CGI/FastCGI SAPI. This functionality obsoletes the PECL htscanner
+ extension. If you are using Apache, use &htaccess; files for the same
+ effect.
+ </simpara>
+
+ <simpara>
+ In addition to the main &php.ini; file, PHP scans for INI files in each
+ directory, starting with the directory of the requested PHP file, and
+ working its way up to the current document root (as set in
+ <varname>$_SERVER['DOCUMENT_ROOT']</varname>). Only INI settings with the
+ modes <constant>PHP_INI_PERDIR</constant> and
+ <constant>PHP_INI_USER</constant> will be recognized in .user.ini-style INI
+ files.
+ </simpara>
+
+ <simpara>
+ Two new INI directives,
+ <literal>user_ini.filename</literal> and
+ <literal>user_ini.cache_ttl</literal>
+ <!--
+ <link linkend="ini.user-ini.filename">user_ini.filename</link> and
+ <link linkend="ini.user-ini.cache-ttl">user_ini.cache_ttl</link>
+ -->
+ control the use of user INI files.
+ </simpara>
+
+ <simpara>
+ <literal>user_ini.filename</literal> sets the name of the file PHP looks for
+ in each directory; if set to an empty string, PHP doesn't scan at all. The
+ default is <literal>.user.ini</literal>.
+ </simpara>
+
+ <simpara>
+ <literal>user_ini.cache_ttl</literal> controls how often user INI files are
+ re-read. The default is 300 seconds (5 minutes).
+ </simpara>
+ </sect1>
<sect1 xml:id="configuration.changes.modes">
<title>Where a configuration setting may be set</title>