svn: /phpdoc/zh/trunk/reference/errorfunc/ ini.xml

daijie                                   Fri, 28 Dec 2018 09:34:44 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=346441

Log:
Sync with EN

Changed paths:
    U   phpdoc/zh/trunk/reference/errorfunc/ini.xml

Modified: phpdoc/zh/trunk/reference/errorfunc/ini.xml
===================================================================
--- phpdoc/zh/trunk/reference/errorfunc/ini.xml	2018-12-28 00:45:52 UTC (rev 346440)
+++ phpdoc/zh/trunk/reference/errorfunc/ini.xml	2018-12-28 09:34:44 UTC (rev 346441)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 323642 Maintainer: HonestQiao Status: ready -->
+<!-- EN-Revision: 346421 Maintainer: HonestQiao Status: ready -->
 <!-- Reviewed: no Maintainer: HonestQiao -->
 <section xml:id="errorfunc.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.runtime;
@@ -120,6 +120,24 @@
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
+    <row>
+     <entry><link linkend="ini.syslog.facility">syslog.facility</link></entry>
+     <entry>"LOG_USER"</entry>
+     <entry>PHP_INI_SYSTEM</entry>
+     <entry>Available as of PHP 7.3.0.</entry>
+    </row>
+    <row>
+     <entry><link linkend="ini.syslog.filter">syslog.filter</link></entry>
+     <entry>"no-ctrl"</entry>
+     <entry>PHP_INI_ALL</entry>
+     <entry>Available as of PHP 7.3.0.</entry>
+    </row>
+    <row>
+     <entry><link linkend="ini.syslog.ident">syslog.ident</link></entry>
+     <entry>"php"</entry>
+     <entry>PHP_INI_SYSTEM</entry>
+     <entry>Available as of PHP 7.3.0.</entry>
+    </row>
     </tbody>
    </tgroup>
   </table>
@@ -143,9 +161,17 @@
       <link linkend="ini.display-errors">display_errors</link> 了解详情。
      </para>
      <para>
-      在PHP 4和PHP 5之中，其默认值为 <constant>E_ALL</constant>
+      在 PHP5.3 及以上版本中，默认值为 <constant>E_ALL</constant> &amp;
+      ~<constant>E_NOTICE</constant> &amp;
+      ~<constant>E_STRICT</constant> &amp;
+      ~<constant>E_DEPRECATED</constant>。
+      该设置不会显示 <constant>E_NOTICE</constant>、 <constant>E_STRICT</constant>
+      、<constant>E_DEPRECATED</constant> 级错误提示。在开发时可以把它们显示出来。
+     在 PHP 5.3.0 以前版本中，默认值是 <constant>E_ALL</constant> &amp;
+      ~<constant>E_NOTICE</constant> &amp;
+      ~<constant>E_STRICT</constant>。
+      在 PHP 4 中，默认值是 <constant>E_ALL</constant>
       &amp; ~<constant>E_NOTICE</constant>。
-      该设置表示除了 <constant>E_NOTICE</constant> 其他都显示的错误级别。在开发过程中很有必要显示它们。
      </para>
      <note>
       <para>在开发阶段启用 <constant>E_NOTICE</constant> 会有一些好处。出于调试的目的：通知信息会对代码中可能出现的bug给出警告。例如，使用未预先分配和定义的值，就会给出警告。它对于查找拼写错误非常有用，并且可以节省调试的时间。通知信息也会警告你使用更好的代码风格。例如，<literal>$arr[item]</literal> 最好写成
@@ -423,6 +449,56 @@
     </listitem>
    </varlistentry>

+   <varlistentry xml:id="ini.syslog.facility">
+    <term>
+     <parameter>syslog.facility</parameter>
+     <type>string</type>
+    </term>
+    <listitem>
+     <para>
+       指定记录日志信息的程序类型，仅在 <link linkend="ini.error-log">error_log</link> 设置为 "syslog" 时有效。
+     </para>
+    </listitem>
+   </varlistentry>
+
+   <varlistentry xml:id="ini.syslog.filter">
+    <term>
+     <parameter>syslog.filter</parameter>
+     <type>string</type>
+    </term>
+    <listitem>
+     <para>
+      Specifies the filter type to filter the logged messages. Allowed
+      characters are passed unmodified; all others are written in their
+      hexadecimal representation prefixed with <literal>\x</literal>. There are
+      three supported filter types:
+      <itemizedlist>
+       <listitem>
+        <simpara><literal>all</literal> – all characters</simpara>
+       </listitem>
+       <listitem>
+        <simpara><literal>no-ctrl</literal> – all characters except control characters</simpara>
+       </listitem>
+       <listitem>
+        <simpara><literal>ascii</literal> – all printable ASCII characters and <literal>NL</literal></simpara>
+       </listitem>
+      </itemizedlist>
+      仅在 <link linkend="ini.error-log">error_log</link> 为 "syslog" 时有效。
+     </para>
+    </listitem>
+   </varlistentry>
+
+   <varlistentry xml:id="ini.syslog.ident">
+    <term>
+     <parameter>syslog.ident</parameter>
+     <type>string</type>
+    </term>
+    <listitem>
+     <para>
+       设置每条日志消息前缀的识别字符串（ident string），仅在 <link linkend="ini.error-log">error_log</link> 为 "syslog" 时有效。
+     </para>
+    </listitem>
+   </varlistentry>
   </variablelist>
  </para>
 </section>