[phpdoc-zh] r224 committed - 标题：[PHPDOC-ZH] [翻译] 函数参考/杂项函数

1 view

Skip to first unread message

phpd...@googlecode.com

unread,

Dec 8, 2011, 4:10:10 AM12/8/11

to phpd...@googlegroups.com

Revision: 224
Author: ice....@gmail.com
Date: Thu Dec 8 01:09:32 2011
Log: 标题：[PHPDOC-ZH] [翻译] 函数参考/杂项函数
http://code.google.com/p/phpdoc-zh/source/detail?r=224

Added:
/trunk/xml/reference/misc
/trunk/xml/reference/misc/book.xml
/trunk/xml/reference/misc/constants.xml
/trunk/xml/reference/misc/functions
/trunk/xml/reference/misc/functions/connection-aborted.xml
/trunk/xml/reference/misc/functions/connection-status.xml
/trunk/xml/reference/misc/functions/connection-timeout.xml
/trunk/xml/reference/misc/functions/constant.xml
/trunk/xml/reference/misc/functions/define.xml
/trunk/xml/reference/misc/functions/defined.xml
/trunk/xml/reference/misc/functions/die.xml
/trunk/xml/reference/misc/functions/eval.xml
/trunk/xml/reference/misc/functions/exit.xml
/trunk/xml/reference/misc/functions/get-browser.xml
/trunk/xml/reference/misc/functions/halt-compiler.xml
/trunk/xml/reference/misc/functions/highlight-file.xml
/trunk/xml/reference/misc/functions/highlight-string.xml
/trunk/xml/reference/misc/functions/ignore-user-abort.xml
/trunk/xml/reference/misc/functions/php-check-syntax.xml
/trunk/xml/reference/misc/functions/php-strip-whitespace.xml
/trunk/xml/reference/misc/functions/sleep.xml
/trunk/xml/reference/misc/functions/sys-getloadavg.xml
/trunk/xml/reference/misc/functions/time-nanosleep.xml
/trunk/xml/reference/misc/functions/time-sleep-until.xml
/trunk/xml/reference/misc/functions/uniqid.xml
/trunk/xml/reference/misc/functions/usleep.xml
/trunk/xml/reference/misc/ini.xml
/trunk/xml/reference/misc/reference.xml

=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/book.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+
+<book xml:id="book.misc" xmlns="http://docbook.org/ns/docbook">
+ <title>杂项函数</title>
+ <titleabbrev>Misc.</titleabbrev>
+
+ <preface xml:id="intro.misc">
+ &reftitle.intro;
+ <para>
+ 因为这些函数不适合其他章节，所以放置于此。
+ </para>
+ </preface>
+
+
+ &reference.misc.setup;
+ &reference.misc.constants;
+ &reference.misc.reference;
+
+</book>
+
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/constants.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<appendix xml:id="misc.constants" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &extension.constants;
+ <variablelist>
+ <varlistentry>
+ <term>
+ <constant>CONNECTION_ABORTED</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>CONNECTION_NORMAL</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>CONNECTION_TIMEOUT</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>__COMPILER_HALT_OFFSET__</constant>
+ (<type>integer</type>)
+ </term>
+ <listitem>
+ <simpara>
+ 在PHP 5.1中加入。
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+</appendix>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/connection-aborted.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.connection-aborted"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>connection_aborted</refname>
+ <refpurpose>检查客户端是否已经断开</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>connection_aborted</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 检查客户端是否已经断开。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果客户端已经断开则返回1，否则返回0。
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>connection_status</function></member>
+ <member><function>ignore_user_abort</function></member>
+ <member>
+ 查看<link linkend="features.connection-handling">连接处理</link>
+ 了解PHP处理连接的详情。
+ </member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/connection-status.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,63 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.connection-status"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>connection_status</refname>
+ <refpurpose>返回连接的状态位</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>connection_status</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 获得当前连接的状态位。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 获得当前连接的状态位, 可以用于与
+ <literal>CONNECTION_XXX</literal> 定义的常量来确定连接状态。
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>connection_aborted</function></member>
+ <member><function>ignore_user_abort</function></member>
+ <member>
+ 查看<link linkend="features.connection-handling">连接处理</link>
+ 了解PHP处理连接的详情。
+ </member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/connection-timeout.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.connection-timeout"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>connection_timeout</refname>
+ <refpurpose>检查脚本是否已超时</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>connection_timeout</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 检查脚本是否已超时。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果脚本已超时返回 1，否则返回 0。
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <warning>
+ <title>已废弃</title>
+ <simpara>
+ 该函数已被废弃，从PHP4.0.5起不再存在。
+ </simpara>
+ 
+ </warning>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>connection_status</function></member>
+ <member>
+ <link linkend="features.connection-handling">Connection
Handling</link>
+ 关于PHP连接处理的完整描述。
+ </member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/constant.xml Thu Dec 8 01:09:32
2011
@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.constant" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>constant</refname>
+ <refpurpose>返回一个常量的值</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>constant</methodname>
+
<methodparam><type>string</type><parameter>name</parameter></methodparam>
+ </methodsynopsis>
+ <simpara>
+ 通过 <parameter>name</parameter> 返回常量的值。
+ </simpara>
+ <simpara>
+ 当你不知道常量名，却需要获取常量的值时，<function>constant</function> 就
很有用了。也就是常量名储存在一个变量里，或者由函数返回常量名。
+ </simpara>
+ <simpara>
+ 该函数也适用 <link
+ linkend="language.oop5.constants">class constants</link>。
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>name</parameter></term>
+ <listitem>
+ <para>
+ 常量名。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回常量的值。如果常量未定义则返回 &null;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <para>
+ 如果常量未定义，会产生一个 <constant>E_WARNING</constant> 级别的错误。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>constant</function> 的例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+define("MAXSIZE", 100);
+
+echo MAXSIZE;
+echo constant("MAXSIZE"); // same thing as the previous line
+
+
+interface bar {
+ const test = 'foobar!';
+}
+
+class foo {
+ const test = 'foobar!';
+}
+
+$const = 'test';
+
+var_dump(constant('bar::'. $const)); // string(7) "foobar!"
+var_dump(constant('foo::'. $const)); // string(7) "foobar!"
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>define</function></member>
+ <member><function>defined</function></member>
+ <member><link linkend="language.constants">Constants</link> 这一节
</member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/define.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>define</refname>
+ <refpurpose>定义一个常量</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>define</methodname>
+
<methodparam><type>string</type><parameter>name</parameter></methodparam>
+
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+ <methodparam
choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 在运行时定义一个常量。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>name</parameter></term>
+ <listitem>
+ <para>
+ 常量名。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>value</parameter></term>
+ <listitem>
+ <para>
+ 常量的值；仅允许标量和 <type>null</type>。标量的类型是
<type>integer</type>，
+ <type>float</type>，<type>string</type> 或者 <type>boolean</type>。
+ 也能够定义常量值的类型为 <type>resource</type> ，但并不推荐这么
做，可能会导致未知状况的发生。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>case_insensitive</parameter></term>
+ <listitem>
+ <para>
+ 如果设置为 &true;，该常量则大小写不敏感。默认是大小写敏感的。比如，
+ <literal>CONSTANT</literal> 和 <literal>Constant</literal> 代表了不
同的值。
+ </para>
+ <note>
+ <para>
+ 大小写不敏感的常量以小写的方式储存。
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>定义常量</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+define("CONSTANT", "Hello world.");
+echo CONSTANT; // outputs "Hello world."
+echo Constant; // outputs "Constant" and issues a notice.
+
+define("GREETING", "Hello you.", true);
+echo GREETING; // outputs "Hello you."
+echo Greeting; // outputs "Hello you."
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>defined</function></member>
+ <member><function>constant</function></member>
+ <member><link linkend="language.constants">Constants</link>这一节
</member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/defined.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.defined" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>defined</refname>
+ <refpurpose>检查某个名称的常量是否存在</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>defined</methodname>
+
<methodparam><type>string</type><parameter>name</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 检查该名称的常量是否已定义。
+ </para>
+ <note>
+ <para>
+ 如果你要检查一个变量是否存在，请使用 <function>isset</function>。
+ <function>defined</function> 函数仅对 <link
+ linkend="language.constants">constants</link> 有效。如果你要检测一个函
数是否存在，使用 <function>function_exists</function>。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>name</parameter></term>
+ <listitem>
+ <para>
+ 常量的名称。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果该名称的常量已定义，返回 &true;；未定义则返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>检查常量</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Note the use of quotes, this is important. This example is checking
+ * if the string 'TEST' is the name of a constant named TEST */
+if (defined('TEST')) {
+ echo TEST;
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>define</function></member>
+ <member><function>constant</function></member>
+ <member><function>get_defined_constants</function></member>
+ <member><function>function_exists</function></member>
+ <member><link linkend="language.constants">Constants</link>这一节
</member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/die.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.die" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>die</refname>
+ <refpurpose>等同于 <function>exit</function></refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <para>
+ 语法结构等同于 <function>exit</function>.
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/eval.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.eval" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>eval</refname>
+ <refpurpose>把字符串作为PHP代码执行</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>eval</methodname>
+
<methodparam><type>string</type><parameter>code_str</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 把字符串 <parameter>code_str</parameter> 作为PHP代码执行。
+ 除了其他，该函数能够执行储存于数据库文本字段内的PHP代码。
+ </para>
+ <para>
+ 使用 <function>eval</function> 时需注意几个因素：注意字符必须是有效的
PHP代码，包括结尾的分号，以不至于解释器在 <function>eval</function> 之后退
出。并且正确地转义 <parameter>code_str</parameter> 中的东西。你可以使用一
个PHP闭合标签来混合输出HTML和PHP代码。
+ </para>
+ <para>
+ 同时需注意eval中的变量会被保留在之后的主脚本中。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>code_str</parameter></term>
+ <listitem>
+ <para>
+ 需要被执行的字符串 <parameter>code_str</parameter> 不能包含 <link
+ linkend="language.basic-syntax.phpmode">PHP Opening tags</link>。
+ </para>
+ <para>
+ <literal>return</literal> 语句会立即中止当前字符串的执行。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ <function>eval</function> 返回 &null;，除非在执行的代码中
<literal>return</literal> 了一个值，函数返回该值。
+ 如果在执行的代码中有一个解析错误，<function>eval</function> 返回
+ &false;，之后的代码将正常执行。无法使用
<function>set_error_handler</function> 捕获 <function>eval</function> 中的解
析错误。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>eval</function> 例子 - 简单的文本合并</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$string = 'cup';
+$name = 'coffee';
+$str = 'This is a $string with my $name in it.';
+echo $str. "\n";
+eval("\$str = \"$str\";");
+echo $str. "\n";
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+This is a $string with my $name in it.
+This is a cup with my coffee in it.
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+
+ &note.language-construct;
+
+ &tip.ob-capture;
+ <note>
+ <para>
+ 如果在执行的代码中产生了一个致命的错误（fatal error），整个脚本会退出。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>call_user_func</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/exit.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,180 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.exit" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>exit</refname>
+ <refpurpose>输出一个消息并且退出当前脚本</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>void</type><methodname>exit</methodname>
+ <methodparam
choice="opt"><type>string</type><parameter>status</parameter></methodparam>
+ </methodsynopsis>
+ <methodsynopsis>
+ <type>void</type><methodname>exit</methodname>
+ <methodparam><type>int</type><parameter>status</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 中止脚本的执行。
+ 尽管调用了 <function>exit</function>，
+ <link linkend="function.register-shutdown-function">Shutdown函数</link>
+ 以及 <link linkend="language.oop5.decon.destructor">object
destructors</link> 总是会被执行。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>status</parameter></term>
+ <listitem>
+ <para>
+ 如果 <parameter>status</parameter> 是一个字符串，在退出之前该函数会
打印
+ <parameter>status</parameter> 。
+ </para>
+ <para>
+ 如果 <parameter>status</parameter> 是一个 <type>integer</type>，该值
会作为退出状态码，并且不会被打印输出。
+ 退出状态码应该在范围0至254，不应使用被PHP保留的退出状态码255。
+ 状态码0用于成功中止程序。
+ </para>
+ <note>
+ <simpara>
+ PHP >= 4.2.0 当 <parameter>status</parameter> 是一个
<type>integer</type>，不会打印输出。
+ </simpara>
+ </note>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.void;
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>exit</function> 例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+$filename = '/path/to/data-file';
+$file = fopen($filename, 'r')
+ or exit("unable to open file ($filename)");
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title><function>exit</function> 状态码例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+//exit program normally
+exit;
+exit();
+exit(0);
+
+//exit with an error code
+exit(1);
+exit(0376); //octal
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>无论如何，Shutdown函数与析构函数都会被执行</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+class Foo
+{
+ public function __destruct()
+ {
+ echo 'Destruct: ' . __METHOD__ . '()' . PHP_EOL;
+ }
+}
+
+function shutdown()
+{
+ echo 'Shutdown: ' . __FUNCTION__ . '()' . PHP_EOL;
+}
+
+$foo = new Foo();
+register_shutdown_function('shutdown');
+
+exit();
+echo 'This will not be output.';
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+ <![CDATA[
+ Shutdown: shutdown()
+ Destruct: Foo::__destruct()
+ ]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+
+ &note.language-construct;
+
+ <note>
+ <para>
+ 该语法结构等同于 <function>die</function>。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>register_shutdown_function</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/get-browser.xml Thu Dec 8 01:09:32
2011
@@ -0,0 +1,176 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.get-browser"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>get_browser</refname>
+ <refpurpose>获取浏览器具有的功能</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>get_browser</methodname>
+ <methodparam
choice="opt"><type>string</type><parameter>user_agent</parameter></methodparam>
+ <methodparam
choice="opt"><type>bool</type><parameter>return_array</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 通过查找 <filename>browscap.ini</filename> 文件中的浏览器信息，尝试检测
用户的浏览器所具有的功能。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>user_agent</parameter></term>
+ <listitem>
+ <para>
+ 要分析的用户代理。默认使用HTTP头中User-Agent的值，不过，你可以通过传
递该参数改变User-Agent。(比如查找另一个浏览器的信息)
+ </para>
+ <para>
+ 你可以传递一个 &null; 来忽略该参数。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>return_array</parameter></term>
+ <listitem>
+ <para>
+ 如果设置为 &true;，该函数会返回一个 <type>array</type>，而不是
<type>object</type>。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 信息会以包含一系列数据的数组或者对象返回。例如：浏览器的主版本号、次版本
号和ID字符串；框架、JavaScript、cookies等功能是否支持 &true;/&false; 的值。
+ </para>
+ <para>
+ <literal>cookies</literal> 的值仅意味着浏览器是否具有接收cookies的功
能，不代表用户是否已允许启用cookies。
+ 测试的唯一办法，只有通过 <function>setcookie</function> 设置一个
cookie，刷新页面并检测该cookie的值。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.3.2</entry>
+ <entry>
+ 添加了可选参数 <parameter>return_array</parameter>。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>列出所有用户浏览器的信息</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+echo $_SERVER['HTTP_USER_AGENT'] . "\n\n";
+
+$browser = get_browser(null, true);
+print_r($browser);
+?>
+]]>
+ </programlisting>
+ &example.outputs.similar;
+ <screen>
+<![CDATA[
+Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.7) Gecko/20040803
Firefox/0.9.3
+
+Array
+(
+ [browser_name_regex] => ^mozilla/5\.0 (windows; .; windows nt
5\.1; .*rv:.*) gecko/.* firefox/0\.9.*$
+ [browser_name_pattern] => Mozilla/5.0 (Windows; ?; Windows NT 5.1;
*rv:*) Gecko/* Firefox/0.9*
+ [parent] => Firefox 0.9
+ [platform] => WinXP
+ [browser] => Firefox
+ [version] => 0.9
+ [majorver] => 0
+ [minorver] => 9
+ [cssversion] => 2
+ [frames] => 1
+ [iframes] => 1
+ [tables] => 1
+ [cookies] => 1
+ [backgroundsounds] =>
+ [vbscript] =>
+ [javascript] => 1
+ [javaapplets] => 1
+ [activexcontrols] =>
+ [cdf] =>
+ [aol] =>
+ [beta] => 1
+ [win16] =>
+ [crawler] =>
+ [stripper] =>
+ [wap] =>
+ [netclr] =>
+)
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ 为了能让该函数运作，在 &php.ini; 中配置的 <link
+ linkend="ini.browscap">browscap</link> 必须指向
<filename>browscap.ini</filename> 文件的正确位置。
+ </para>
+ <para>
+ <filename>browscap.ini</filename> 并未内置在PHP中，不过你可以在这里找到
最新的 <link
+ xlink:href="&url.browscap.download;">php_browscap.ini</link>。
+ </para>
+ <para>
+ <filename>browscap.ini</filename> 包含的诸多浏览器信息依赖于用户更新该
数据库。该文件的格式不言自明。
+ </para>
+ </note>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/halt-compiler.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.halt-compiler"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>__halt_compiler</refname>
+ <refpurpose>
+ 中断编译器的执行
+ </refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>void</type><methodname>__halt_compiler</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 中断编译器的执行。常用于在PHP脚本内嵌入数据，类似于安装文件。
+ </para>
+ <para>
+ 可以通过常量 <constant>__COMPILER_HALT_OFFSET__</constant> 获取数据开始
字节所在的位置，且该常量仅被定义于使用了__halt_compiler的文件。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.void;
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>A <function>__halt_compiler</function> 例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// open this file
+$fp = fopen(__FILE__, 'r');
+
+// seek file pointer to data
+fseek($fp, __COMPILER_HALT_OFFSET__);
+
+// and output it
+var_dump(stream_get_contents($fp));
+
+// the end of the script execution
+__halt_compiler(); the installation data (eg. tar, gz, PHP, etc.)
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ <function>__halt_compiler</function> 仅能够在最外层使用。
+ </para>
+ </note>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/highlight-file.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,135 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.highlight-file"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>highlight_file</refname>
+ <refpurpose>语法高亮一个文件</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>highlight_file</methodname>
+
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam
choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 使用PHP内置的语法高亮器所定义的颜色，打印输出或者返回
<parameter>filename</parameter> 文件中语法高亮版本的代码。
+ </para>
+ <para>
+ 许多服务器配置了自动高亮 <emphasis>phps</emphasis> 扩展的文件。
+ 比如，访问 <filename>example.phps</filename> 会显示语法高亮后的文件。
+ 添加以下一行代码到 &httpd.conf; 使此生效：
+ </para>
+ <screen>
+<![CDATA[
+AddType application/x-httpd-php-source .phps
+]]>
+ </screen>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ 欲高亮文件的路径。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>return</parameter></term>
+ <listitem>
+ <para>
+ 设置该参数为 &true; 使函数返回高亮后的代码。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果 <parameter>return</parameter> 设置为 &true;，高亮后的代码不会被打
印输出，而是以字符串的形式返回。
+ 高亮成功返回 &true;，否则返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.2.1</entry>
+ <entry>
+ 该函数现在也受 <link
+ linkend="ini.safe-mode">safe_mode</link> 和 <link
+ linkend="ini.open-basedir">open_basedir</link> 的限制和影响。
+ </entry>
+ </row>
+ <row>
+ <entry>4.2.0</entry>
+ <entry>
+ 添加了 <parameter>return</parameter> 的参数。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <caution>
+ <para>
+ 应当注意在使用 <function>highlight_file</function> 时，确认没有在不经意
间泄漏敏感信息，类似密码或者其他任何具有潜在安全风险的信息。
+ </para>
+ </caution>
+ &note.uses-ob;
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>highlight_string</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/highlight-string.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,150 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.highlight-string"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>highlight_string</refname>
+ <refpurpose>字符串的语法高亮</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>highlight_string</methodname>
+ <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam
choice="opt"><type>bool</type><parameter>return</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <simpara>
+ 使用PHP内置的语法高亮器所定义的颜色，打印输出或者返回输出或者返回语法高
亮版本的PHP代码。
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>str</parameter></term>
+ <listitem>
+ <para>
+ 需要高亮的PHP代码，应当包含开始标签。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>return</parameter></term>
+ <listitem>
+ <para>
+ 设置该参数为 &true; 使函数返回高亮后的代码。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果 <parameter>return</parameter> 设置为 &true;，高亮后的代码不会被打
印输出，而是以字符串的形式返回。
+ 高亮成功返回 &true;，否则返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.2.0</entry>
+ <entry>
+ 添加了 <parameter>return</parameter> 的参数。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>highlight_string</function> 例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+highlight_string('<?php phpinfo(); ?>');
+?>
+]]>
+ </programlisting>
+ <para>
+ PHP4中，上例会输出:
+ </para>
+ <screen>
+<![CDATA[
+<code><font color="#000000">
+<font color="#0000BB"><?php phpinfo</font><font color="#007700">();
</font><font color="#0000BB">?></font>
+</font>
+</code>
+]]>
+ </screen>
+ <para>
+ PHP5中，上例会输出:
+ </para>
+ <screen>
+<![CDATA[
+<code><span style="color: #000000">
+<span style="color: #0000BB"><?php phpinfo</span><span style="color:
#007700">(); </span><span style="color: #0000BB">?></span>
+</span>
+</code>
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &note.uses-ob;
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>highlight_file</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/ignore-user-abort.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,133 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.ignore-user-abort"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>ignore_user_abort</refname>
+ <refpurpose>设置客户端断开连接时是否中断脚本的执行</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>ignore_user_abort</methodname>
+ <methodparam
choice="opt"><type>string</type><parameter>value</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 设置客户端断开连接时是否中断脚本的执行
+ </para>
+ <para>
+ PHP以命令行脚本执行时，当脚本终端结束，脚本不会被立即中止，除非设置
<parameter>value</parameter> 为 &true;，否则脚本输出任意字符时会被中止。
</para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>value</parameter></term>
+ <listitem>
+ <para>
+ 如果设置了该值，函数会把 <link
+ linkend="ini.ignore-user-abort">ignore_user_abort</link> ini的值设置
为 <parameter>value</parameter>。
+ 如果未设置该值，函数不会改变设置，仅会返回之前的设置。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 以整型返回之前的设置
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title>一个<function>ignore_user_abort</function>的例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Ignore user aborts and allow the script
+// to run forever
+ignore_user_abort(true);
+set_time_limit(0);
+
+echo 'Testing connection handling in PHP';
+
+// Run a pointless loop that sometime
+// hopefully will make us click away from
+// page or click the "Stop" button.
+while(1)
+{
+ // Did the connection fail?
+ if(connection_status() != CONNECTION_NORMAL)
+ {
+ break;
+ }
+
+ // Sleep for 10 seconds
+ sleep(10);
+}
+
+// If this is reached, then the 'break'
+// was triggered from inside the while loop
+
+// So here we can log, or perform any other tasks
+// we need without actually being dependent on the
+// browser.
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <para>
+ 在PHP尝试发送信息到客户端之前，不会检测到用户是否已中断连接。
+ 仅使用 echo 语句不能确保信息已发送，参见 <function>flush</function> 函
数。
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>connection_aborted</function></member>
+ <member><function>connection_status</function></member>
+ <member>
+ <link linkend="features.connection-handling">Connection
Handling</link>
+ 关于PHP连接处理的完整描述。
+ </member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/php-check-syntax.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,152 @@
+<?xml version='1.0' encoding="utf-8"?>
+
+<refentry xml:id="function.php-check-syntax"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>php_check_syntax</refname>
+ <refpurpose>
+ 检查PHP的语法（并执行）指定的文件
+ </refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>php_check_syntax</methodname>
+
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter
role="reference">error_message</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 对指定的 <parameter>filename</parameter> 进行语法检查，检测脚本的错误。
+ </para>
+ <para>
+ 此函数除了会执行（但不会输出）<parameter>filename</parameter>，其他与
<link linkend="features.commandline">命令行</link>中使用<command>php
-l</command> 相似。
+ </para>
+ <para>
+ 例如，如果函数在文件 <parameter>filename</parameter> 中被定义了，则该函
数在执行<function>php_check_syntax</function>后可用。但是
<parameter>filename</parameter>输出内容不会被输出。
+ </para>
+ <note>
+ 
+ <para>
+ 因为某些技术原因，该函数已被弃用，并且从PHP中移除了。请以<link
linkend="features.commandline">commandline</link>使用 <literal>php -l
somefile.php</literal>取而代之。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ 需要被检测的文件。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>error_message</parameter></term>
+ <listitem>
+ <para>
+ 如果使用了参数 <parameter>error_message</parameter>，它会包含语法检
测出的错误信息。
+ <parameter>error_message</parameter> 以 <link
linkend="language.references">引用</link>方式传递。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 如果语法检测通过返回 &true;，未通过或者文件无法打开则返回 &false;。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.5</entry>
+ <entry>
+ 函数从PHP中移除。
+ </entry>
+ </row>
+ <row>
+ <entry>5.0.3</entry>
+ <entry>
+ <function>php_check_syntax</function>之后调用
<function>exit</function> 会导致一个段错误。
+ </entry>
+ </row>
+ <row>
+ <entry>5.0.1</entry>
+ <entry>
+ <parameter>error_message</parameter> 通过引用传递
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <screen>
+<![CDATA[
+php -l somefile.php
+]]>
+ </screen>
+ </para>
+ &example.outputs.similar;
+ <para>
+ <screen>
+<![CDATA[
+PHP Parse error: unexpected T_STRING in /tmp/somefile.php on line 81
+]]>
+ </screen>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>include</function></member>
+ <member><function>is_readable</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/php-strip-whitespace.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,105 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<refentry xml:id="function.php-strip-whitespace"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+ <refname>php_strip_whitespace</refname>
+ <refpurpose>返回删除注释和空格后的PHP源码</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>string</type><methodname>php_strip_whitespace</methodname>
+
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 返回删除注释和空格后 <parameter>filename</parameter> 的PHP源码。这对实际
代码数量和注释数量的对比很有用。
+ 此函数与 <link linkend="features.commandline">命令行</link> 下执行
<command>php -w</command> 相似。
+ <link linkend="features.commandline">commandline</link>.
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>filename</parameter></term>
+ <listitem>
+ <para>
+ PHP文件的路径。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 在成功时返回过滤后的代码，或者在失败时返回空字符串。
+ </para>
+ <note>
+ <para>
+ 此函数在PHP 5.0.1后以所述方式工作。之前它仅会返回一个空字符串。关于更多
此BUG的信息与其行为，详见BUG报告 <link
xlink:href="&url.php.bugs;29606">#29606</link>。
+ </para>
+ </note>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>php_strip_whitespace</function> 的例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// PHP comment here
+
+/*
+ * Another PHP comment
+ */
+
+echo php_strip_whitespace(__FILE__);
+// Newlines are considered whitespace, and are removed too:
+do_nothing();
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+<?php
+ echo php_strip_whitespace(__FILE__); do_nothing(); ?>
+]]>
+ </screen>
+ <para>
+ 可以注意到PHP的注释已不存在，成为第一个echo语句前的换行和空格。
+ </para>
+ </example>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/sleep.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.sleep" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>sleep</refname>
+ <refpurpose>延缓执行</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>int</type><methodname>sleep</methodname>
+
<methodparam><type>int</type><parameter>seconds</parameter></methodparam>
+ </methodsynopsis>
+ <simpara>
+ 程序延迟执行指定的 <parameter>seconds</parameter> 的秒数。
+ </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>seconds</parameter></term>
+ <listitem>
+ <para>
+ 暂停的秒数。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 成功时返回 0，错误时返回 &false;。
+ </para>
+ <para>
+ 如果函数的调用被一个信号中止，<function>sleep</function> 会返回一个非零
的值。在Windows上，该值总是 <literal>192</literal>（即Windows API常量
<constant>WAIT_IO_COMPLETION</constant>的值）。其他平台上，该返回值是剩余未
sleep的秒数。
+ </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <para>
+ 如果指定的 <parameter>seconds</parameter> 是负数，该函数会产生一个
<constant>E_WARNING</constant> 级别的错误。
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.4</entry>
+ <entry>
+ 在PHP 5.3.4之前，Windows平台下无论 <function>sleep</function> 是否
成功调用，总是会返回一个 &null;。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>sleep</function> 的例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// current time
+echo date('h:i:s') . "\n";
+
+// sleep for 10 seconds
+sleep(10);
+
+// wake up !
+echo date('h:i:s') . "\n";
+
+?>
+]]>
+ </programlisting>
+ <para>
+ 该例子会在休眠10秒后输出。
+ </para>
+ <screen>
+<![CDATA[
+05:31:23
+05:31:33
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>usleep</function></member>
+ <member><function>time_nanosleep</function></member>
+ <member><function>time_sleep_until</function></member>
+ <member><function>set_time_limit</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/sys-getloadavg.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.sys-getloadavg"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>sys_getloadavg</refname>
+ <refpurpose>获取系统的负载（load average）</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>sys_getloadavg</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ 返回三个系统负载（系统运行队列中的进程数）的样本数据，分别是1分钟、5分钟
和15分钟之前。
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回一个包含1分钟、5分钟和15分钟之前采样数据的<type>array</type>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>sys_getloadavg</function> 的例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$load = sys_getloadavg();
+if ($load[0] > 80) {
+ header('HTTP/1.1 503 Too busy, try again later');
+ die('Server too busy. Please try again later.');
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ &note.no-windows;
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/time-nanosleep.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,162 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<refentry xml:id="function.time-nanosleep"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>time_nanosleep</refname>
+ <refpurpose>延缓执行若干秒和纳秒</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>time_nanosleep</methodname>
+
<methodparam><type>int</type><parameter>seconds</parameter></methodparam>
+
<methodparam><type>int</type><parameter>nanoseconds</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 程序延缓执行指定数量的 <parameter>seconds</parameter> 和
<parameter>nanoseconds</parameter>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>seconds</parameter></term>
+ <listitem>
+ <para>
+ 必须是一个非负整数。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>nanoseconds</parameter></term>
+ <listitem>
+ <para>
+ 必须是一个小于1亿的非负整数。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ <para>
+ 如果延迟被中断，一个关联数组会返回，内容为：
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <literal>seconds</literal> - 延迟剩余未执行的秒数
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>nanoseconds</literal> - 延迟剩余未执行的纳秒数
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ 至此之后该函数在Windows平台下可用。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>time_nanosleep</function> 的例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Careful! This won't work as expected if an array is returned
+if (time_nanosleep(0, 500000000)) {
+ echo "Slept for half a second.\n";
+}
+
+// This is better:
+if (time_nanosleep(0, 500000000) === true) {
+ echo "Slept for half a second.\n";
+}
+
+// And this is the best:
+$nano = time_nanosleep(2, 100000);
+
+if ($nano === true) {
+ echo "Slept for 2 seconds, 100 microseconds.\n";
+} elseif ($nano === false) {
+ echo "Sleeping failed.\n";
+} elseif (is_array($nano)) {
+ $seconds = $nano['seconds'];
+ $nanoseconds = $nano['nanoseconds'];
+ echo "Interrupted by a signal.\n";
+ echo "Time remaining: $seconds seconds, $nanoseconds nanoseconds.";
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>sleep</function></member>
+ <member><function>usleep</function></member>
+ <member><function>time_sleep_until</function></member>
+ <member><function>set_time_limit</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/time-sleep-until.xml Thu Dec 8
01:09:32 2011
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.time-sleep-until"
xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>time_sleep_until</refname>
+ <refpurpose>
+ 使脚本睡眠到指定的时间为止。
+ </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>time_sleep_until</methodname>
+
<methodparam><type>float</type><parameter>timestamp</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 使脚本睡眠到指定的
+ <parameter>timestamp</parameter>。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>timestamp</parameter></term>
+ <listitem>
+ <para>
+ 将脚本唤醒的时间戳。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.success;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.3.0</entry>
+ <entry>
+ 自此，函数在Windows平台可用。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+ &reftitle.errors;
+ <para>
+ 如果设定的 <parameter>timestamp</parameter> 为过去的时间，脚本将会产生一
个 <constant>E_WARNING</constant> 级别的错误。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>time_sleep_until</function> 的一个例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+//returns false and generates a warning
+var_dump(time_sleep_until(time()-1));
+
+// may only work on faster computers, will sleep up to 0.2 seconds
+var_dump(time_sleep_until(microtime(true)+0.2));
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <simpara>
+ 所有的信号会被延迟至脚本唤醒以后。
+ </simpara>
+ </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>sleep</function></member>
+ <member><function>usleep</function></member>
+ <member><function>time_nanosleep</function></member>
+ <member><function>set_time_limit</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/uniqid.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,148 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.uniqid" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>uniqid</refname>
+ <refpurpose>生成一个唯一ID</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>string</type><methodname>uniqid</methodname>
+ <methodparam
choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
+ <methodparam
choice="opt"><type>bool</type><parameter>more_entropy</parameter><initializer>false</initializer></methodparam>
+ </methodsynopsis>
+ <para>
+ 获取一个带前缀、基于当前时间微秒数的唯一ID。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>prefix</parameter></term>
+ <listitem>
+ <para>
+ 有用的参数。例如：如果在多台主机上可能在同一微秒生成唯一ID。
+ </para>
+ <para>
+ <parameter>prefix</parameter>为空，则返回的字符串长度为13。
<parameter>more_entropy</parameter> 为
+ &true;，则返回的字符串长度为23。
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>more_entropy</parameter></term>
+ <listitem>
+ <para>
+ 如果设置为 &true;，<function>uniqid</function> 会在返回的字符串结尾
增加额外的煽（使用combined linear congruential generator）。
+ 使得唯一ID更具唯一性。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ 返回字符串形式的唯一ID。
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>uniqid</function> 例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* A uniqid, like: 4b3403665fea6 */
+printf("uniqid(): %s\r\n", uniqid());
+
+/* We can also prefix the uniqid, this the same as
+ * doing:
+ *
+ * $uniqid = $prefix . uniqid();
+ * $uniqid = uniqid($prefix);
+ */
+printf("uniqid('php_'): %s\r\n", uniqid('php_'));
+
+/* We can also activate the more_entropy parameter, which is
+ * required on some systems, like Cygwin. This makes uniqid()
+ * produce a value like: 4b340550242239.64159797
+ */
+printf("uniqid('', true): %s\r\n", uniqid('', true));
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ <parameter>prefix</parameter> 参数设为可选。
+ </entry>
+ </row>
+ <row>
+ <entry>4.3.1</entry>
+ <entry>
+ <parameter>prefix</parameter> 参数的长度限制提升到114个字符。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+ &reftitle.notes;
+ <note>
+ <para>
+ 在Cygwin环境下，为了使此函数能够工
作，<parameter>more_entropy</parameter> 必须设置为 &true;。
+ </para>
+ </note>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/functions/usleep.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,132 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<refentry xml:id="function.usleep" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+ <refname>usleep</refname>
+ <refpurpose>以指定的微秒数延迟执行</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>void</type><methodname>usleep</methodname>
+
<methodparam><type>int</type><parameter>micro_seconds</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ 以指定的微秒数延缓程序的执行。
+ </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>micro_seconds</parameter></term>
+ <listitem>
+ <para>
+ 暂停的时间以微秒计。1微秒（micro second）是百万分之一秒。
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ &return.void;
+ </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ 此函数在Windows系统下可用。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
+ <example>
+ <title><function>usleep</function>例子</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// Current time
+echo date('h:i:s') . "\n";
+
+// wait for 2 seconds
+usleep(2000000);
+
+// back!
+echo date('h:i:s') . "\n";
+
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+11:13:28
+11:13:30
+]]>
+ </screen>
+ </example>
+ </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>sleep</function></member>
+ <member><function>time_nanosleep</function></member>
+ <member><function>time_sleep_until</function></member>
+ <member><function>set_time_limit</function></member>
+ </simplelist>
+ </para>
+ </refsect1>
+
+</refentry>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/ini.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,161 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<section xml:id="misc.configuration" xmlns="http://docbook.org/ns/docbook">
+ &reftitle.runtime;
+ &extension.runtime;
+ <para>
+ <table>
+ <title>杂项配置选项</title>
+ <tgroup cols="4">
+ <thead>
+ <row>
+ <entry>选项名称</entry>
+ <entry>默认值</entry>
+ <entry>可修改范围</entry>
+ <entry>更新记录</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><link
linkend="ini.ignore-user-abort">ignore_user_abort</link></entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry>highlight.string</entry>
+ <entry>"#DD0000"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry>highlight.comment</entry>
+ <entry>"#FF8000"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry>highlight.keyword</entry>
+ <entry>"#007700"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry>highlight.bg</entry>
+ <entry>"#FFFFFF"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry>在PHP 5.4.0.中已移除</entry>
+ </row>
+ <row>
+ <entry>highlight.default</entry>
+ <entry>"#0000BB"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry>highlight.html</entry>
+ <entry>"#000000"</entry>
+ <entry>PHP_INI_ALL</entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry><link linkend="ini.browscap">browscap</link></entry>
+ <entry>NULL</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ &ini.php.constants;
+ </para>
+
+ &ini.descriptions.title;
+
+ <para>
+ <variablelist>
+
+ <varlistentry xml:id="ini.ignore-user-abort">
+ <term>
+ <parameter>ignore_user_abort</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ 默认值为 &false; 。如果设置为 &true; ，在客户端断开连接后，脚本不会
被中止。
+
+ </para>
+ <para>
+ 参见 <function>ignore_user_abort</function>.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry xml:id="ini.syntax-highlighting">
+ <term>
+ <parameter>highlight.bg</parameter>
+ <type>string</type>
+ </term>
+ <term>
+ <parameter>highlight.comment</parameter>
+ <type>string</type>
+ </term>
+ <term>
+ <parameter>highlight.default</parameter>
+ <type>string</type>
+ </term>
+ <term>
+ <parameter>highlight.html</parameter>
+ <type>string</type>
+ </term>
+ <term>
+ <parameter>highlight.keyword</parameter>
+ <type>string</type>
+ </term>
+ <term>
+ <parameter>highlight.string</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ 语法高亮的颜色。可设置为 <font color="??????"> 中任何可接受的
代码。
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry xml:id="ini.browscap">
+ <term>
+ <parameter>browscap</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
+ <para>
+ 浏览器功能文件的位置和文件名 (例如
<filename>browscap.ini</filename>)。参见 <function>get_browser</function>。
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+</section>
+
+
=======================================
--- /dev/null
+++ /trunk/xml/reference/misc/reference.xml Thu Dec 8 01:09:32 2011
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+
+<reference xml:id="ref.misc" xmlns="http://docbook.org/ns/docbook">
+ <title>杂项 &Functions;</title>
+
+ &reference.misc.entities.functions;
+
+</reference>
+
+
+

Reply all

Reply to author

Forward

0 new messages