<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/faq.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'faq.using.php',
    1 => '使用 PHP',
    2 => '使用 PHP',
  ),
  'up' => 
  array (
    0 => 'faq.php',
    1 => 'FAQ',
  ),
  'prev' => 
  array (
    0 => 'faq.build.php',
    1 => '编译问题',
  ),
  'next' => 
  array (
    0 => 'faq.passwords.php',
    1 => '密码散列',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'faq/using.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="faq.using" class="chapter">
  <h1 class="title">使用 PHP</h1>

  
  <p class="para">本节汇集了你在写 PHP 脚本时可能碰到的大多数普通错误。</p>
  

  <div class="qandaset"><ol class="qandaset_questions"><li><a href="#faq.using.parameterorder">
        
          我忘了 PHP 函数的参数顺序，它们是随机的吗？
        
      </a></li><li><a href="#faq.using.anyform">
        
          我想写一个可以处理任何表单来的数据的通用 PHP
          脚本。我怎么知道哪个 POST 方法变量可用呢？
        
      </a></li><li><a href="#faq.using.addslashes">
        
          我需要在所有的单引号（&#039;）前加一个反斜线（\），使它们变成（\&#039;）。我如何能够通过正则表达式来实现？
          我同样希望能够将 &quot; 转换成 \&quot;，将 \ 转换成 \\。
        
      </a></li><li><a href="#faq.using.wrong-order">
        
          当我这样做时，输出显示的次序是错的： 

        

&lt;?php
function myfunc($argument)
{
    echo $argument + 10;
}
$variable = 10;
echo &quot;myfunc($variable) = &quot; . myfunc($variable);
?&gt;

          
          这是怎么回事？
        
      </a></li><li><a href="#faq.using.newlines">
        
          下面代码怎么没有分成两行显示？ 
          

&lt;pre&gt;
&lt;?php echo &quot;This should be the first line.&quot;; ?&gt;
&lt;?php echo &quot;This should show up after the new line above.&quot;; ?&gt;
&lt;/pre&gt;

          
        
      </a></li><li><a href="#faq.using.headers-sent">
        
          我得到消息 &ldquo;Warning: Cannot send session cookie - headers already sent...&rdquo;
          或者 &ldquo;Cannot add header information - headers already sent...&rdquo;。
        
      </a></li><li><a href="#faq.using.header">
        
          我需要直接访问请求报头中的信息，怎么能办到？
        
      </a></li><li><a href="#faq.using.authentication">
        
          当我用 IIS 进行 HTTP 认证时得到 &ldquo;No Input file specified&rdquo; 消息。
        
      </a></li><li><a href="#faq.using.iis.sharing">
        
          Windows：不能访问另一台电脑上用 IIS 共享的文件。
        
      </a></li><li><a href="#faq.using.mixml">
        
          我怎样混合使用 XML 和 PHP？它不认我的 &lt;?xml 标记！
        
      </a></li><li><a href="#faq.using.variables">
        
          哪里可以找到所有可用的 PHP 预定义变量的完整列表？
        
      </a></li><li><a href="#faq.using.freepdf">
        
          怎样才能不用非免费的商业库（例如 PDFLib） 来生成 PDF 文档？我想要个免费的并且不需要再连接别的 PDF 库。
        
      </a></li><li><a href="#faq.using.shorthandbytes">
        
          有些 PHP 选项可以接受缩写的字节值，与仅能接受 
          int 字节值相反。都有哪些缩写字节值？
        
      </a></li></ol></div>
    
    <dl class="qandaentry" id="faq.using.parameterorder">
     
      <dt><strong>
        
          我忘了 PHP 函数的参数顺序，它们是随机的吗？
        
      </strong></dt>  
      <dd class="answer">
        <p class="para">
          PHP 是一个将数百个外部库连接在一起的粘合剂，尽管有时候会有一些混乱。这里有一些简单的经验法则：
        </p>

        <p class="para">
          <a href="book.array.php" class="link">数组函数</a> 参数的顺序为
          &quot;<em>needle, haystack</em>&quot;，
          <a href="book.strings.php" class="link">字符串函数</a> 则相反，顺序为
          &quot;<em>haystack, needle</em>&quot;。
        </p>
      </dd>
    </dl>

    <dl class="qandaentry" id="faq.using.anyform">
      <dt><strong>
        
          我想写一个可以处理任何表单来的数据的通用 PHP
          脚本。我怎么知道哪个 POST 方法变量可用呢？
        
      </strong></dt>
      <dd class="answer">
      <p class="para">
        PHP 提供很多“
        <a href="language.variables.predefined.php" class="link">预定义变量</a>”，例如超全局变量 
        <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST</a></var>。可以遍历 
        <var class="varname"><a href="reserved.variables.post.php" class="classname">$_POST</a></var>变量，因为它是一个和所有通过 POST 方法传递数据相联系的数组。例如，可以用 
        <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a>简单地遍历它，检查 
        <span class="function"><a href="function.empty.php" class="function">empty()</a></span>值，以及将它们输出。 
        <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$empty </span><span style="color: #007700">= </span><span style="color: #0000BB">$post </span><span style="color: #007700">= array();<br />foreach (</span><span style="color: #0000BB">$_POST </span><span style="color: #007700">as </span><span style="color: #0000BB">$varname </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$varvalue</span><span style="color: #007700">) {<br />    if (empty(</span><span style="color: #0000BB">$varvalue</span><span style="color: #007700">)) {<br />        </span><span style="color: #0000BB">$empty</span><span style="color: #007700">[</span><span style="color: #0000BB">$varname</span><span style="color: #007700">] = </span><span style="color: #0000BB">$varvalue</span><span style="color: #007700">;<br />    } else {<br />        </span><span style="color: #0000BB">$post</span><span style="color: #007700">[</span><span style="color: #0000BB">$varname</span><span style="color: #007700">] = </span><span style="color: #0000BB">$varvalue</span><span style="color: #007700">;<br />    }<br />}<br /><br />print </span><span style="color: #DD0000">"&lt;pre&gt;"</span><span style="color: #007700">;<br />if (empty(</span><span style="color: #0000BB">$empty</span><span style="color: #007700">)) {<br />    print </span><span style="color: #DD0000">"None of the POSTed values are empty, posted:\n"</span><span style="color: #007700">;<br />    </span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$post</span><span style="color: #007700">);<br />} else {<br />    print </span><span style="color: #DD0000">"We have " </span><span style="color: #007700">. </span><span style="color: #0000BB">count</span><span style="color: #007700">(</span><span style="color: #0000BB">$empty</span><span style="color: #007700">) . </span><span style="color: #DD0000">" empty values\n"</span><span style="color: #007700">;<br />    print </span><span style="color: #DD0000">"Posted:\n"</span><span style="color: #007700">; </span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$post</span><span style="color: #007700">);<br />    print </span><span style="color: #DD0000">"Empty:\n"</span><span style="color: #007700">;  </span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$empty</span><span style="color: #007700">);<br />    exit;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
          </div>

        </p>

      </dd>
    </dl>


    <dl class="qandaentry" id="faq.using.addslashes">
      <dt><strong>
        
          我需要在所有的单引号（&#039;）前加一个反斜线（\），使它们变成（\&#039;）。我如何能够通过正则表达式来实现？
          我同样希望能够将 &quot; 转换成 \&quot;，将 \ 转换成 \\。
        
      </strong></dt>
      

      <dd class="answer">
        <p class="para">
          假设是针对数据库，请使用数据库自带的转义机制。比如，针对 MySQL 使用
          <span class="function"><a href="function.mysql-real-escape-string.php" class="function">mysql_real_escape_string()</a></span> 函数，针对 PostgreSQL 则使用
          <span class="function"><a href="function.pg-escape-string.php" class="function">pg_escape_string()</a></span> 函数。还有两个标准函数
          <span class="function"><a href="function.addslashes.php" class="function">addslashes()</a></span> 和
          <span class="function"><a href="function.stripslashes.php" class="function">stripslashes()</a></span> 可以在旧的 PHP 版本中实现类似的操作。
        </p>

      </dd>
    </dl>

    <dl class="qandaentry" id="faq.using.wrong-order">
      <dt><strong>
        
          当我这样做时，输出显示的次序是错的： 

        <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">myfunc</span><span style="color: #007700">(</span><span style="color: #0000BB">$argument</span><span style="color: #007700">)<br />{<br />    echo </span><span style="color: #0000BB">$argument </span><span style="color: #007700">+ </span><span style="color: #0000BB">10</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">$variable </span><span style="color: #007700">= </span><span style="color: #0000BB">10</span><span style="color: #007700">;<br />echo </span><span style="color: #DD0000">"myfunc(</span><span style="color: #0000BB">$variable</span><span style="color: #DD0000">) = " </span><span style="color: #007700">. </span><span style="color: #0000BB">myfunc</span><span style="color: #007700">(</span><span style="color: #0000BB">$variable</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
          </div>

          这是怎么回事？
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          要在一个表达式中（例如在上面的例子中和其它字符串连接）使用函数的结果，需要 
          <span class="function"><a href="function.return.php" class="function">return</a></span> 这个值，而不是 
          <span class="function"><a href="function.echo.php" class="function">echo</a></span> 它。</p>
      </dd>
    </dl>

    

    <dl class="qandaentry" id="faq.using.newlines">
      <dt><strong>
        
          下面代码怎么没有分成两行显示？ 
          <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">&lt;pre&gt;<br /><span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo </span><span style="color: #DD0000">"This should be the first line."</span><span style="color: #007700">; </span><span style="color: #0000BB">?&gt;<br />&lt;?php </span><span style="color: #007700">echo </span><span style="color: #DD0000">"This should show up after the new line above."</span><span style="color: #007700">; </span><span style="color: #0000BB">?&gt;<br /></span>&lt;/pre&gt;</span></code></div>
          </div>

        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          在 PHP 中，一段代码的结束标记要么是“?&gt;”要么是“?&gt;\n”（\n 表示换行）。因此在上面的例子中，输出的句子将显示在同一行中，因为
          PHP 忽略了代码结束标记后面的换行。这意味着如果要输出一个换行符，需要在每段
          PHP 代码的结束标记后面多加一个换行。
        </p>
        <p class="para">
          PHP 为什么这么做呢？因为在格式化正常的
          HTML 时，这样通常会更容易。假如输出了换行而你不需要这个换行时，就不得不用一个非常长的行来达到这样的效果，或者让产生的
          HTML 页面的源文件的格式很难读。
        </p>
      </dd>
    </dl>





    <dl class="qandaentry" id="faq.using.headers-sent">
      <dt><strong>
        
          我得到消息 “Warning: Cannot send session cookie - headers already sent...”
          或者 “Cannot add header information - headers already sent...”。
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          函数 
          <span class="function"><a href="function.header.php" class="function">header()</a></span>，
          <span class="function"><a href="function.setcookie.php" class="function">setcookie()</a></span> 和 
          <a href="ref.session.php" class="link">session 函数</a>需要在输出流中添加头信息。但是头信息只能在其它任何输出内容之前发送。在使用这些函数前不能有任何（如 HTML）的输出。函数 
          <span class="function"><a href="function.headers-sent.php" class="function">headers_sent()</a></span> 能够检查脚本是否已经发送了头信息。请参阅
          <a href="ref.outcontrol.php" class="link">输出控制函数</a>。
        </p>
      </dd>
    </dl>



    <dl class="qandaentry" id="faq.using.header">
      <dt><strong>
        
          我需要直接访问请求报头中的信息，怎么能办到？
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          如果以 Apache 的模块方式运行 PHP，那么函数
          <span class="function"><a href="function.getallheaders.php" class="function">getallheaders()</a></span> 可以做这件事。因此下面的代码可以显示所有的请求报头： 
          <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$headers </span><span style="color: #007700">= </span><span style="color: #0000BB">getallheaders</span><span style="color: #007700">();<br />foreach (</span><span style="color: #0000BB">$headers </span><span style="color: #007700">as </span><span style="color: #0000BB">$name </span><span style="color: #007700">=&gt; </span><span style="color: #0000BB">$content</span><span style="color: #007700">) {<br />    echo </span><span style="color: #DD0000">"headers[</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">] = </span><span style="color: #0000BB">$content</span><span style="color: #DD0000">&lt;br /&gt;\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
          </div>

        </p>
        <p class="para">
          请参阅函数 
          <span class="function"><a href="function.apache-lookup-uri.php" class="function">apache_lookup_uri()</a></span>、
          <span class="function"><a href="function.apache-response-headers.php" class="function">apache_response_headers()</a></span> 和 
          <span class="function"><a href="function.fsockopen.php" class="function">fsockopen()</a></span>。
        </p>
      </dd>
    </dl>



    <dl class="qandaentry" id="faq.using.authentication">
      <dt><strong>
        
          当我用 IIS 进行 HTTP 认证时得到 “No Input file specified” 消息。
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          IIS 的安全模型这里有毛病。这是所有 IIS 下运行的 CGI 程序所共有的问题。一个解决办法是建立一个纯
          HTML 文件（不经过 PHP 解析）作为要进入认证目录的登录页面，然后用 META 标记来重定向到 PHP 页面，或者用一个连接到
          PHP 页面。然后 PHP 就可以正确识别认证信息了。如果是用 ISAPI 模块，那没有这个问题。其它 NT 下的 web 服务器不受此影响。更多信息见 
          <a href="http://support.microsoft.com/kb/q160422/" class="link external">&raquo;&nbsp;http://support.microsoft.com/kb/q160422/</a> 及 
          <a href="features.http-auth.php" class="link">HTTP 认证</a> 一章。
        </p>
      </dd>
    </dl>







    <dl class="qandaentry" id="faq.using.iis.sharing">
      <dt><strong>
        
          Windows：不能访问另一台电脑上用 IIS 共享的文件。
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          必须要做些修改。打开 
          <code class="literal">Internet 信息服务</code>，找到你的 PHP 文件并打开属性页，选择
          <code class="literal">文件安全性</code>标签，点击
          <code class="literal">匿名访问和身份验证控制</code>的“编辑”按钮。
        </p>
        <p class="para">
          解决此问题有两个方法，一是不要选中
          <code class="literal">匿名访问</code>并且选中
          <code class="literal">集成 Windows 身份验证</code>，二是选中
          <code class="literal">匿名访问</code>并编辑匿名访问使用的帐户，改成一个有权限的。
        </p>
    </dd>
    </dl>


    <dl class="qandaentry" id="faq.using.mixml">
      <dt><strong>
        
          我怎样混合使用 XML 和 PHP？它不认我的 &lt;?xml 标记！
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          要能够在 PHP 代码中直接嵌入 &lt;?xml，需要将 PHP 设置项 
          <a href="ini.core.php#ini.short-open-tag" class="link">short_open_tags</a>设置为 
          <code class="literal">0</code>以关闭短标记格式。无法通过函数 
          <span class="function"><a href="function.ini-set.php" class="function">ini_set()</a></span>来更改这项设置。不管 
          <a href="ini.core.php#ini.short-open-tag" class="link">short_open_tags</a>是开或者关，都可以用类似于 
          <code class="literal">&lt;?php echo &#039;&lt;?xml&#039;; ?&gt;</code>的方法达到目的。该项设置的默认值为开。
        </p>
      </dd>
    </dl>




    <dl class="qandaentry" id="faq.using.variables">
      <dt><strong>
        
          哪里可以找到所有可用的 PHP 预定义变量的完整列表？
        
      </strong></dt>
      <dd class="answer">
      <p class="para">
        请阅读手册中的
        <a href="language.variables.predefined.php" class="link">预定义变量</a>
        一章，该部分的文档已经包含了一部分可以用于你的脚本的预定义变量的列表。可用变量的完整列表（及更多信息）可以通过调用 
        <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span>
        函数来查阅。请务必阅读手册中
        <a href="language.variables.external.php" class="link">来自 PHP 之外的变量</a>
        一节，这部分文档阐述了外部变量的概念，例如来自 HTML 表单、Cookie 和 URL 的变量。
      </p>
      </dd>
    </dl>



    <dl class="qandaentry" id="faq.using.freepdf">
      <dt><strong>
        
          怎样才能不用非免费的商业库（例如 PDFLib） 来生成 PDF 文档？我想要个免费的并且不需要再连接别的 PDF 库。
        
      </strong></dt>
      <dd class="answer">
        <p class="para">有几个选择，例如 
        <a href="http://www.fpdf.org/" class="link external">&raquo;&nbsp;FPDF</a> 和
        <a href="http://www.tcpdf.org/" class="link external">&raquo;&nbsp;TCPDF</a> 模块。
      </p>
      </dd>
    </dl>

    <dl class="qandaentry" id="faq.using.shorthandbytes">
      <dt><strong>
        
          有些 PHP 选项可以接受缩写的字节值，与仅能接受 
          <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 字节值相反。都有哪些缩写字节值？
        
      </strong></dt>
      <dd class="answer">
        <p class="para">
          可用的选择有 K（对应 Kilobytes），M（对应 Megabytes）和 G（对应 Gigabytes），不区分大小写。其余的都认为是字节。
          <code class="literal">1M</code>等于一个 Megabyte，即 
          <code class="literal">1048576</code> 字节。
          <code class="literal">1K</code> 等于一个 Kilobyte，即 
          <code class="literal">1024</code> 字节。这些缩写符号可以在 <var class="filename">php.ini</var> 和
          <span class="function"><a href="function.ini-set.php" class="function">ini_set()</a></span> 函数中使用。要注意，数字类型为
          <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 会自动取整，这意味着
          <code class="literal">0.5M</code> 与 <code class="literal">0</code> 是等价的。
        </p>
        <blockquote class="note"><p><strong class="note">注意</strong>: 
          <strong>kilobyte 和 kibibyte 的区别</strong><br />
          <p class="para">
            PHP 将一个千字节（kilobyte）描述为等于 1024 字节（bytes），而
            <abbr>IEC</abbr> 标准则认为这是一个 kibibyte。结论：k 和 K = 1024 bytes.
          </p>
        </p></blockquote>
      </dd>
    </dl>
  
</div>
<?php manual_footer($setup); ?>