<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/configuration.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'configuration.file.per-user.php',
    1 => '.user.ini 文件',
    2 => '.user.ini 文件',
  ),
  'up' => 
  array (
    0 => 'configuration.php',
    1 => '运行时配置',
  ),
  'prev' => 
  array (
    0 => 'configuration.file.php',
    1 => '配置文件',
  ),
  'next' => 
  array (
    0 => 'configuration.changes.modes.php',
    1 => '配置可被设定范围',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'install/ini.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="configuration.file.per-user" class="sect1">
  <h2 class="title">.user.ini 文件</h2>

  <p class="simpara">
   PHP 支持基于每个目录的 INI 文件配置。此类文件
   <em>仅</em>被 CGI／FastCGI SAPI 处理。此功能使得 PECL 的 htscanner
   扩展作废。如果你的 PHP 以模块化运行在 Apache 里，则用 <var class="filename">.htaccess</var> 文件有同样效果。
  </p>

  <p class="simpara">
   除了主 <var class="filename">php.ini</var> 之外，PHP 还会在每个目录下扫描 INI
   文件，从被执行的 PHP 文件所在目录开始一直上升到 web
   根目录（<var class="varname"><a href="reserved.variables.server.php" class="classname">$_SERVER['DOCUMENT_ROOT']</a></var>
   所指定的）。如果被执行的 PHP 文件在 web 根目录之外，则只扫描该目录。
  </p>
  <p class="simpara">
   在 .user.ini 风格的 INI 文件中只有具有 <strong><code><a href="info.constants.php#constant.ini-perdir">INI_PERDIR</a></code></strong>
   和 <strong><code><a href="info.constants.php#constant.ini-user">INI_USER</a></code></strong> 模式的 INI
   设置可被识别。
  </p>

  <p class="simpara">
   两个新的 INI 指令，
   <a href="ini.core.php#ini.user-ini.filename" class="link">user_ini.filename</a> 和
   <a href="ini.core.php#ini.user-ini.cache-ttl" class="link">user_ini.cache_ttl</a>
   控制着用户 INI 文件的使用。
  </p>

  <p class="simpara">
   <a href="ini.core.php#ini.user-ini.filename" class="link">user_ini.filename</a> 设定了 PHP
   会在每个目录下搜寻的文件名；如果设定为空字符串则 PHP
   不会搜寻。默认值是 <code class="literal">.user.ini</code>。
  </p>

  <p class="simpara">
   <a href="ini.core.php#ini.user-ini.cache-ttl" class="link">user_ini.cache_ttl</a> 控制着重新读取用户
   INI 文件的间隔时间。默认是 300 秒（5 分钟）。
  </p>
 </div><?php manual_footer($setup); ?>