Check translation for faq (#1016)

* Fix faq: critical translation errors and Chinese typos - using.xml: 区分大小写→不区分大小写 (opposite meaning), update shorthand notation usage - mailinglist.xml: remove stray 'å' character, <literal>→<emphasis> for emphasis - com.xml: fix &true; → &true; entity references, <xref>→<link> to match EN - obtaining.xml: 组和→组合 typo - passwords.xml: 将会窃取→将被窃取 (missing passive voice) - html.xml: add missing <example><title> wrapper for Javascript example * Fix faq/installation.xml: sync with EN, remove outdated content - Remove obsolete MacOS parenthetical - Remove extra Windows threading paragraph - php.ini-dist → php.ini-development - ereg → preg_match (ereg removed in PHP 7) - php4 → php5 in paths, php4ts.dll → php5ts.dll - Add missing php_ini_loaded_file reference - Remove Win98/Me autoexec.bat section - Remove obsolete Windows system directory paragraph - Simplify Windows PATH instructions to match EN - Remove PHP 4 handler from multiviews example * Fix faq/com.xml: replace Unicode smart quotes with ASCII quotes The linkend attributes used Unicode right double quotation marks (U+201D) instead of ASCII double quotes, causing XML parse failures in CI. * Update com.xml 将中文句式中的英文引号修改为中文引号 --------- Co-authored-by: mowangjuanzi <mowangjuanzi@petalmail.com>
2026-03-23 22:52:08 +01:00 · 2026-03-17 11:02:00 +01:00
parent db997b882f
commit ecf1e5b1cc
7 changed files with 29 additions and 55 deletions
--- a/faq/com.xml
+++ b/faq/com.xml
@@ -91,8 +91,7 @@
      <answer>
        <para>完全和运行本地对象一样。只须将远端服务器的 IP 作为第二个变量传递给 COM 的构造函数即可。</para>
        <para>确认在 &php.ini; 中设定了 
-        <xref linkend="ini.com.allow-dcom" />
-        <literal>=</literal>&amp;true;。</para>
+        <link linkend="ini.com.allow-dcom">com.allow_dcom</link><literal>=</literal>&true;。</para>
      </answer>
    </qandaentry>
    <qandaentry xml:id="faq.com.q9">
@@ -100,9 +99,8 @@
        <para>我得到一个“DCOM is disabled in C:\path...\scriptname.php on line 6”信息，应该怎么办？</para>
      </question>
      <answer>
-        <para>编辑 &php.ini; 并设定 
-        <xref linkend="ini.com.allow-dcom" />
-        <literal>=</literal>&amp;true;。</para>
+        <para>编辑 &php.ini; 并设定
+        <link linkend="ini.com.allow-dcom">com.allow_dcom</link><literal>=</literal>&true;。</para>
      </answer>
    </qandaentry>
    <qandaentry xml:id="faq.com.q10">
--- a/faq/html.xml
+++ b/faq/html.xml
@@ -206,7 +206,9 @@ variable = document.forms[0].elements['var[]'];
        <para>由于 Javascript （通常情况下）是客户端技术，而 PHP （通常情况下）是服务器端技术，而且 HTTP 是一种“无状态”协议，因此两种语言之间不能直接共享变量。</para>
        <para>但是，有可能在二者之间传递变量。一种实现的方法是用 PHP 生成 Javascript 代码，并让浏览器自动刷新，将特定的变量传递回 PHP 脚本。以下例子显示了如何这样做——让 PHP 代码取得显示屏幕的高度和宽度，通常只能在客户端这么做。</para>
        <para>
-          <programlisting role="php">
+          <example>
+           <title>用 PHP 生成 Javascript</title>
+           <programlisting role="php">
 <![CDATA[
 <?php
 if (isset($_GET['width']) AND isset($_GET['height'])) {
@@ -227,6 +229,7 @@ if (isset($_GET['width']) AND isset($_GET['height'])) {
 ?>
 ]]>
 </programlisting>
+          </example>
        </para>
      </answer>
    </qandaentry>
--- a/faq/installation.xml
+++ b/faq/installation.xml
@@ -5,7 +5,7 @@
  <title>安装常见问题</title>
  <titleabbrev>安装</titleabbrev>

-  <para>本章包括了安装 PHP 的常见问题。PHP 可以用于几乎任何操作系统（可能除了 OS X 之前的 MacOS 之外），以及几乎任何 web 服务器。</para>
+  <para>本章包括了安装 PHP 的常见问题。PHP 可以用于几乎任何操作系统，以及几乎任何 web 服务器。</para>
  <para>要安装 PHP，请按照
  <link linkend="install">安装与配置</link>一章中的指示进行。</para>
  <qandaset>
@@ -16,7 +16,6 @@
      <answer>
        <para>PHP 是粘合剂。它将几十种第三方的库粘合到一起来创建很酷的 web 应用，并通过很直观且易于学习的语言界面使其看上去好像一个整体。PHP 的灵活与强大依赖于底层平台的稳定与耐用。起码需要将一个可运作的操作系统，一个可运作的 web 服务器以及可运作的第三方库粘合起来。其中任何一方不运作了，PHP 都需要有方法来识别出问题并且快速解决。如果没有完全独立的执行线程，完全独立的内存单元和稳定的空间对付每个请求，那底层架构就太复杂以至于不稳定因素更容易进入到 PHP 系统中。</para>
        <para>如果必须要用线程化的 MPM，看看 FastCGI 配置，使 PHP 运行于自己独立的内存空间中。</para>
-        <para>最后需要指出，不使用线程化 MPM 的警告在 Windows 系统中没那么强烈，因为 Windows 中的大多数库都理应在多线程下安全运行。</para>
      </answer>
    </qandaentry>
    <qandaentry xml:id="faq.installation.phpini">
@@ -29,7 +28,7 @@
        <filename>&lt;install-path&gt;/lib</filename>。很多人会在编译时通过 
        <link linkend="configure.with-config-file-path">--with-config-file-path</link>标记来改变路径。例如可以将路径设为： 
        <programlisting role="shell">--with-config-file-path=/etc</programlisting>然后从发行包中将 
-        <filename>php.ini-dist</filename>拷贝为 
+        <filename>php.ini-development</filename>拷贝为 
        <filename>/etc/php.ini</filename>并编辑它来作出想要的修改。</para>
        <programlisting role="shell">--with-config-file-scan-dir=PATH</programlisting>
        <para>Windows 中 &php.ini; 文件的默认路径在 Windows 目录下。如果使用的是 Apache 服务器，则会首先在 Apache 的安装目录中寻找 &php.ini;，例如 
@@ -75,7 +74,7 @@
          </listitem>
        </itemizedlist></para>
        <para>如果你的脚本使用了正则表达式函数（
-        <function>ereg</function>等），应该确认在编译 PHP 和 Apache 时使用了同一个正则表达式包。在 PHP 和 Apache 1.3.x 中应该自动就是这样。</para>
+        <function>preg_match</function> 等），应该确认在编译 PHP 和 Apache 时使用了同一个正则表达式包。在 PHP 和 Apache 1.3.x 中应该自动就是这样。</para>
      </answer>
    </qandaentry>
    <qandaentry xml:id="faq.installation.processing">
@@ -133,7 +132,7 @@ AddType application/x-httpd-php .php
    <qandaentry xml:id="faq.installation.undefinedsyms">
      <question>
        <para>某些操作系统：我已经在不出错的情况下安装了 PHP，但当我试着启动 Apache 时得到了一个未定义符号错误： 
-        <programlisting role="shell">[mybox:user /src/php4] root# apachectl configtest apachectl: /usr/local/apache/bin/httpd Undefined symbols: _compress _uncompress</programlisting></para>
+        <programlisting role="shell">[mybox:user /src/php5] root# apachectl configtest apachectl: /usr/local/apache/bin/httpd Undefined symbols: _compress _uncompress</programlisting></para>
      </question>
      <answer>
        <para>这实际上和 PHP 没有关系，而和 MySQL 的客户端库有关。有的需要 
@@ -155,7 +154,7 @@ AddType application/x-httpd-php .php
          <listitem>
            <simpara>文件权限问题，你的 PHP 脚本，
            <filename>php.exe</filename>，
-            <filename>php4ts.dll</filename>，&php.ini; 或任何你要加载的 PHP 扩展库是匿名 internet 用户 
+            <filename>php5ts.dll</filename>，&php.ini; 或任何你要加载的 PHP 扩展库是匿名 internet 用户 
            <literal>ISUR_&lt;machinename&gt;</literal>无权访问的。</simpara>
          </listitem>
          <listitem>
@@ -201,6 +200,7 @@ AddType application/x-httpd-php .php
        <function>phpinfo</function>，在接近开头的位置有一项叫做 
        <literal>Configuration File (php.ini)</literal>。这里将告诉你 PHP 在哪里找到了 &php.ini; 并且是否使用了。如果只显示一个目录则 没有使用任何 &php.ini; 文件，你应将你的 &php.ini; 文件放到该目录中。如果 &php.ini; 包括在该路径中则它已被应用了。</para>
        <para>如果 &php.ini; 被使用了并且你是以模块方式运行 PHP 的，确保在修改了 &php.ini; 之后重新启动你的 web server。</para>
+        <para>参见 <function>php_ini_loaded_file</function>。</para>
      </answer>
    </qandaentry>
    <qandaentry xml:id="faq.installation.addtopath">
@@ -209,19 +209,19 @@ AddType application/x-httpd-php .php
        <varname>PATH</varname>中去？</para>
      </question>
      <answer>
-        <para>在 Windows NT，2000，XP 和 2003 下： 
+        <para>在 Windows 下：
        <itemizedlist>
          <listitem>
-            <para>进入控制面板并打开“系统”图标（开始 -&gt; 设置 -&gt; 控制面板 -&gt; 系统，Windows XP/2003 中是：开始 -&gt; 控制面板 -&gt; 系统）</para>
+            <para>进入控制面板并打开”系统”图标（开始 → 控制面板）</para>
          </listitem>
          <listitem>
-            <para>选择“高级”标签页</para>
+            <para>选择”高级”标签页</para>
          </listitem>
          <listitem>
-            <para>点击“环境变量”按钮</para>
+            <para>点击”环境变量”按钮</para>
          </listitem>
          <listitem>
-            <para>在“系统变量”栏中</para>
+            <para>在”系统变量”栏中</para>
          </listitem>
          <listitem>
            <para>找到 Path 这一项（可能需要向下滚动才能找到）</para>
@@ -230,38 +230,17 @@ AddType application/x-httpd-php .php
            <para>鼠标双击 Path 这一项</para>
          </listitem>
          <listitem>
-            <para>在最后加入你的 PHP 目录，包括前面的“;”（例如：
+            <para>在最后加入你的 PHP 目录，包括前面的”;”（例如：
            <literal>;C:\php</literal>）</para>
          </listitem>
          <listitem>
-            <para>点击“确定”并重新启动电脑</para>
-          </listitem>
-        </itemizedlist></para>
-        <para>在 Windows 98/Me 中需要编辑 
-        <filename>autoexec.bat</filename>文件： 
-        <itemizedlist>
-          <listitem>
-            <para>打开记事本（开始 -&gt; 运行，然后输入 notepad 并点确定）</para>
-          </listitem>
-          <listitem>
-            <para>打开 
-            <filename>C:\autoexec.bat</filename>文件</para>
-          </listitem>
-          <listitem>
-            <para>找到这么一行：PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;..... 并在最后加上 
-            <literal>;C:\php</literal></para>
-          </listitem>
-          <listitem>
-            <para>保存文件并重新启动电脑</para>
+            <para>点击”确定”</para>
          </listitem>
        </itemizedlist></para>
        <note>
-          <simpara>记住在上述修改之后重新启动，以确保对 
-          <varname>PATH</varname>的改变生效。</simpara>
+          <simpara>记住在上述修改之后重新启动，以确保对
+          <varname>PATH</varname> 的改变生效。</simpara>
        </note>
-        <para>PHP 手册过去提倡把文件拷贝到 Windows 系统目录中去，这是因为该目录（
-        <filename>C:\Windows</filename>，
-        <filename>C:\WINNT</filename>，等等）默认就在系统路径中。但是把文件拷贝到 Windows 系统目录中这一方式早已不被提倡，还可能造成问题。</para>
      </answer>
    </qandaentry>

@@ -310,11 +289,6 @@ AddType application/x-httpd-php .php
        <literal>AddType application/x-httpd-php .php</literal>替换为： 
        <programlisting role="apache-conf">
          <![CDATA[
-# PHP 4
-AddHandler php-script php
-AddType text/html php
-
-# PHP 5
 AddHandler php5-script php
 AddType text/html php
 ]]>
--- a/faq/mailinglist.xml
+++ b/faq/mailinglist.xml
@@ -99,12 +99,12 @@
     </para>
     <para>
      在您发帖到列表之前，请查看此 FAQ 和手册，看看是否可以在那里找到帮助。如果找不到任何内容，请尝试邮件列表档案（见上文）。 如果在安装或配置 PHP
-      å时遇到问题，请通读所有包含的文档和 README 文件。如果仍然找不到任何有帮助信息，非常欢迎使用适当的邮件列表。
+      时遇到问题，请通读所有包含的文档和 README 文件。如果仍然找不到任何有帮助信息，非常欢迎使用适当的邮件列表。
     </para>
     <para>
      为了确保收到最佳答复（并减少让其他开发人员感到沮丧的可能性），请务必将问题发布到适当的列表中。例如，如果您安装 PHP 时遇到困难，应该将问题发送到
      <literal>php-install</literal> 邮件列表。需要注意的是：有些列表具有相似的名称但用途却完全不同；有关 Windows 上的 PHP 脚本的问题应直接访问
-      Windows PHP 用户列表，<literal>而不是</literal> Windows 内部列表。
+      Windows PHP 用户列表，<emphasis>而不是</emphasis> Windows 内部列表。
     </para>
      <para>
       在提问之前，可能需要阅读有关<link xlink:href="&url.smart.questions;">如何以聪明的方式提问</link>的文章，因为这对每个人来说都是一个好主意。
--- a/faq/obtaining.xml
+++ b/faq/obtaining.xml
@@ -30,7 +30,7 @@
    </question>
    <answer>
     <para>
-      我们只为 Windows 系统提供了预编译的可执行文件，因为我们没法为每个主流的 Linux/Unix 平台编译每一种扩展库组和的
+      我们只为 Windows 系统提供了预编译的可执行文件，因为我们没法为每个主流的 Linux/Unix 平台编译每一种扩展库组合的
      PHP。同样注意，如今很多 Linux 的发行版本已经内置了 PHP。Windows 可执行文件可以从我们的
      <link xlink:href="&url.php.downloads;">下载</link>页面下载，至于 Linux 可执行文件，请访问你的 Linux 发布商的站点。
     </para>
--- a/faq/passwords.xml
+++ b/faq/passwords.xml
@@ -19,7 +19,7 @@
    </question>
    <answer>
     <simpara>
-      设计任何接受用户密码的应用或服务时，密码散列是必须考虑到的最基本的安全问题之一。如果没有散列处理，泄露了存储的数据，任何存储的密码都将会窃取。如果用户使用不唯一的密码，那么不仅会危害应用或服务，还会危害其他服务上的用户账户。
+      设计任何接受用户密码的应用或服务时，密码散列是必须考虑到的最基本的安全问题之一。如果没有散列处理，泄露了存储的数据，任何存储的密码都将被窃取。如果用户使用不唯一的密码，那么不仅会危害应用或服务，还会危害其他服务上的用户账户。
     </simpara>
     <simpara>
      对用户密码应用散列算法，然后再存储，这样任何攻击者几乎不可能确定原始密码，同时仍然能够在未来将生成的散列值与原始密码进行比较。
--- a/faq/using.xml
+++ b/faq/using.xml
@@ -325,13 +325,12 @@ foreach ($headers as $name => $content) {
      </question>
      <answer>
        <para>
-          可用的选择有 K（对应 Kilobytes），M（对应 Megabytes）和 G（对应 Gigabytes），区分大小写。其余的都认为是字节。
+          可用的选择有 K（对应 Kilobytes），M（对应 Megabytes）和 G（对应 Gigabytes），不区分大小写。其余的都认为是字节。
          <literal>1M</literal>等于一个 Megabyte，即 
          <literal>1048576</literal> 字节。
          <literal>1K</literal> 等于一个 Kilobyte，即 
-          <literal>1024</literal> 字节。不能在 &php.ini; 之外使用这些符号，最好用整数的 
-          <type>int</type> 字节值。参见 
-          <function>ini_get</function> 文档中的转换示例。要注意，数字类型为
+          <literal>1024</literal> 字节。这些缩写符号可以在 &php.ini; 和
+          <function>ini_set</function> 函数中使用。要注意，数字类型为
          <type>int</type> 会自动取整，这意味着
          <literal>0.5M</literal> 与 <literal>0</literal> 是等价的。
        </para>