svn: /phpdoc/en/trunk/install/ ini.xml

From: 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>

« previous php.doc.cvs (#4514) next »