archived-doc-zh/reference/info/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3f1dbc451b313fb1ec8058f24c1beccf55fce316 Maintainer: daijie Status: ready -->
<!-- CREDITS: Luffy, mowangjuanzi -->
<appendix xml:id="info.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.constants;
 &extension.constants.core;
 <variablelist xml:id="constant.credits.constants" role="constant_list">
  <title>预定义 <function xmlns="http://docbook.org/ns/docbook">phpcredits</function> 常量</title>
  <varlistentry xml:id="constant.credits-group">
   <term>
    <constant>CREDITS_GROUP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     核心开发者名单
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-general">
   <term>
    <constant>CREDITS_GENERAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     总的贡献：语言设计和理念，PHP 作者 和 SAPI 模块。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-sapi">
   <term>
    <constant>CREDITS_SAPI</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 的服务器 API 模块列表，以及它们的作者。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-modules">
   <term>
    <constant>CREDITS_MODULES</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 扩展的列表，以及它们的作者。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-docs">
   <term>
    <constant>CREDITS_DOCS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     文档组的贡献。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-fullpage">
   <term>
    <constant>CREDITS_FULLPAGE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     通常与其他标志组合使用。通过其他标志指示了完整独立的 HTML 页面，用于打印包含信息。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-qa">
   <term>
    <constant>CREDITS_QA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     质量保证团队的贡献。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.credits-all">
   <term>
    <constant>CREDITS_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     所有的贡献者，等于使用 <literal>CREDITS_DOCS
     | CREDITS_GENERAL | CREDITS_GROUP | CREDITS_MODULES | CREDITS_QA
     | CREDITS_FULLPAGE</literal>。
     它以合适的标签产生了完整的独立 HTML 页面。这是默认的值。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="constant.info.constants" role="constant_list">
  <title><function xmlns="http://docbook.org/ns/docbook">phpinfo</function> 常量</title>
  <varlistentry xml:id="constant.info-general">
   <term>
    <constant>INFO_GENERAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     配置行，&php.ini; 的位置、构建日期，Web 服务器、操作系统及其他。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-credits">
   <term>
    <constant>INFO_CREDITS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 贡献者。参见 <function xmlns="http://docbook.org/ns/docbook">phpcredits</function>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-configuration">
   <term>
    <constant>INFO_CONFIGURATION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     当前 PHP 指令的本地（Local）和主（Master）值。参见 <function xmlns="http://docbook.org/ns/docbook">ini_get</function>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-modules">
   <term>
    <constant>INFO_MODULES</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     已加载的模块和各自的设置。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-environment">
   <term>
    <constant>INFO_ENVIRONMENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     环境变量信息在 <varname xmlns="http://docbook.org/ns/docbook">$_ENV</varname> 中亦有效。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-variables">
   <term>
    <constant>INFO_VARIABLES</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     显示所有 <literal xmlns="http://docbook.org/ns/docbook">EGPCS</literal> （环境变量、GET、POST、Cookie、Server）中的<link xmlns="http://docbook.org/ns/docbook" linkend="language.variables.predefined">预定义变量</link>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-license">
   <term>
    <constant>INFO_LICENSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 版权信息。参见 <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.php.license;">license faq</link>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.info-all">
   <term>
    <constant>INFO_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     显示以上所有。这是默认值。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="constant.ini-mode" role="constant_list">
  <title>INI 模式常量</title>
  <varlistentry xml:id="constant.ini-user">
   <term>
    <constant>INI_USER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     可以在用户脚本（如使用 <function xmlns="http://docbook.org/ns/docbook">ini_set</function>）或 <link xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.windows">Windows
     注册表</link>中设置条目。可以在 &user-ini; 中设置条目
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.ini-perdir">
   <term>
    <constant>INI_PERDIR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     可以在 &php.ini;、&htaccess;、&httpd.conf; 或 &user-ini; 中设置条目
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.ini-system">
   <term>
    <constant>INI_SYSTEM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     可以在 &php.ini; 或 &httpd.conf; 中设置条目
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.ini-all">
   <term>
    <constant>INI_ALL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     条目可以设置在任何地方
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <simpara>
  断言常量，这些值用于设置 <function>assert_options</function> 中的断言标记。
 </simpara>
 <variablelist xml:id="constant.assert.constants" role="constant_list">
  <title><function xmlns="http://docbook.org/ns/docbook">assert</function> 常量</title>
  <varlistentry xml:id="constant.assert-active">
   <term>
    <constant>ASSERT_ACTIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     启用 <function xmlns="http://docbook.org/ns/docbook">assert</function>。
    </para>
    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-callback">
   <term>
    <constant>ASSERT_CALLBACK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     失败断言的回调函数。
    </para>
    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-bail">
   <term>
    <constant>ASSERT_BAIL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     断言失败时中止执行。
    </para>
    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-exception">
   <term>
    <constant>ASSERT_EXCEPTION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     为每个失败的断言抛出 <classname>AssertionError</classname>。
    </para>
    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-warning">
   <term>
    <constant>ASSERT_WARNING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     为每个失败的断言产生一条 PHP 警告。
    </para>
    &warn.deprecated.feature-8-3-0;
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.assert-quiet-eval">
   <term>
    <constant>ASSERT_QUIET_EVAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <para>
     在执行断言表达式时禁用 <literal xmlns="http://docbook.org/ns/docbook">error_reporting</literal>。
     &warn.feature.removed-8-0-0;
    </para>
   </listitem>
  </varlistentry>
 </variablelist>

 <simpara>
  以下常量仅在主机操作系统是 Windows的情况下有效，能得到不同版本信息，能够检测利用一些功能。
 </simpara>
 <variablelist xml:id="constant.windows.constants" role="constant_list">
  <title>Windows 特定常量</title>
  <varlistentry xml:id="constant.php-windows-version-major">
   <term>
    <constant>PHP_WINDOWS_VERSION_MAJOR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     windows 主版本，可以是 <literal xmlns="http://docbook.org/ns/docbook">4</literal>（NT4/Me/98/95）、<literal xmlns="http://docbook.org/ns/docbook">5</literal>（XP/2003
     R2/2003/2000）或 <literal xmlns="http://docbook.org/ns/docbook">6</literal>（Vista/2008/7/8/8.1）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-minor">
   <term>
    <constant>PHP_WINDOWS_VERSION_MINOR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Windows 副版本号，可以是 <literal xmlns="http://docbook.org/ns/docbook">0</literal> (Vista/2008/2000/NT4/95)、<literal xmlns="http://docbook.org/ns/docbook">1</literal> (XP)、<literal xmlns="http://docbook.org/ns/docbook">2</literal> (2003
     R2/2003/XP x64)、<literal xmlns="http://docbook.org/ns/docbook">10</literal>（98）或 <literal xmlns="http://docbook.org/ns/docbook">90</literal>（ME）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-build">
   <term>
    <constant>PHP_WINDOWS_VERSION_BUILD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Windows 内部版本号（例如 Windows Vista SP1 是 build 6001）
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-platform">
   <term>
    <constant>PHP_WINDOWS_VERSION_PLATFORM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PHP 当前运行的平台， Windows Vista/XP/2000/NT4、Server 2008/2003 的值是 <literal xmlns="http://docbook.org/ns/docbook">2</literal>，Windows ME/98/95 下值是 <literal xmlns="http://docbook.org/ns/docbook">1</literal>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-sp-major">
   <term>
    <constant>PHP_WINDOWS_VERSION_SP_MAJOR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     安装的 service pack 主版本号，没有安装是 <literal xmlns="http://docbook.org/ns/docbook">0</literal>。例如
     Windows XP service pack 3 上这个值是 <literal xmlns="http://docbook.org/ns/docbook">3</literal>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-sp-minor">
   <term>
    <constant>PHP_WINDOWS_VERSION_SP_MINOR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     安装的 service pack 副版本号，如果没有安装则是 <literal xmlns="http://docbook.org/ns/docbook">0</literal>。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-suitemask">
   <term>
    <constant>PHP_WINDOWS_VERSION_SUITEMASK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     suitemask 是位掩码，用来判断 Windows 是否安装了各种功能，参阅下表获取可能的位阈值。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-version-producttype">
   <term>
    <constant>PHP_WINDOWS_VERSION_PRODUCTTYPE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     包含用于确定 <literal>PHP_WINDOWS_NT_<replaceable>*</replaceable></literal> 常量的值。该值可能是
     <literal>PHP_WINDOWS_NT_<replaceable>*</replaceable></literal> 常量之一，表示平台类型的值。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-nt-domain-controller">
   <term>
    <constant>PHP_WINDOWS_NT_DOMAIN_CONTROLLER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     这是域控制器
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-nt-server">
   <term>
    <constant>PHP_WINDOWS_NT_SERVER</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     这是一个服务器系统（例如 Server 2008/2003/2000），注意，如果这是一个域控制器，通过 
     <constant xmlns="http://docbook.org/ns/docbook">PHP_WINDOWS_NT_DOMAIN_CONTROLLER</constant> 报告。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.php-windows-nt-workstation">
   <term>
    <constant>PHP_WINDOWS_NT_WORKSTATION</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     这是一个工作站系统（例如 Vista/XP/2000/NT4）
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
 <simpara>
  此功能列表可以通过
  <constant>PHP_WINDOWS_VERSION_SUITEMASK</constant> 位掩码检测。
 </simpara>
 <table>
  <title>Windows suitemask 位字段</title>
  <tgroup cols="3">
   <thead>
    <row>
     <entry>Bits</entry>
     <entry>描述</entry>
    </row>
   </thead>
   <tbody>
    <row>
     <entry><literal>0x00000004</literal></entry>
     <entry>安装的是 Microsoft BackOffice 组件。</entry>
    </row>
    <row>
     <entry><literal>0x00000400</literal></entry>
     <entry>安装的是 Windows Server 2003 网络版。</entry>
    </row>
    <row>
     <entry><literal>0x00004000</literal></entry>
     <entry>安装的是 Windows Server 2003 计算集群版。</entry>
    </row>
    <row>
     <entry><literal>0x00000080</literal></entry>
     <entry>
      安装的是 Windows Server 2008 数据中心版、Windows Server 2003 数据中心版或者 
      Windows 2000 数据中心服务器。
     </entry>
    </row>
    <row>
     <entry><literal>0x00000002</literal></entry>
     <entry>
      安装的是 Windows Server 2008 企业版，Windows Server 2003 企业版，Windows
      2000 高级服务器版或 Windows NT Server 4.0 企业版 。
     </entry>
    </row>
    <row>
     <entry><literal>0x00000040</literal></entry>
     <entry>安装的是 Windows XP 嵌入版。</entry>
    </row>
    <row>
     <entry><literal>0x00000200</literal></entry>
     <entry>
      安装的是 Windows Vista 家庭高级版，Windows Vista 家庭普通版或 Windows XP 家庭版。
     </entry>
    </row>
    <row>
     <entry><literal>0x00000100</literal></entry>
     <entry>
      支持远程桌面，但仅支持交互式会话。系统没有在应用服务器模式运行时则会设置此值。
     </entry>
    </row>
    <row>
     <entry><literal>0x00000001</literal></entry>
     <entry>
      Microsoft 小型商业服务器曾经安装在系统上，但可能已经升级到 Windows 的另外一个版本。
     </entry>
    </row>
    <row>
     <entry><literal>0x00000020</literal></entry>
     <entry>
      Microsoft 小型商业服务器安装时具有有效的限制性客户端许可证。
     </entry>
    </row>
    <row>
     <entry><literal>0x00002000</literal></entry>
     <entry>安装的是 Windows 存储服务器 2003 R2 或 Windows 存储服务器 2003。</entry>
    </row>
    <row>
     <entry><literal>0x00000010</literal></entry>
     <entry>
      安装的是终端服务。该值始终设置。如果设置了该值但未设置 <literal>0x00000100</literal>，则系统运行在应用服务器模式。
     </entry>
    </row>
    <row>
     <entry><literal>0x00008000</literal></entry>
     <entry>已安装 Windows Home Server。</entry>
    </row>
   </tbody>
  </tgroup>
 </table>
</appendix>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->