<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.mbstring.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'mbstring.http.php',
    1 => 'HTTP 输入和输出',
    2 => 'HTTP 输入和输出',
  ),
  'up' => 
  array (
    0 => 'book.mbstring.php',
    1 => '多字节字符串',
  ),
  'prev' => 
  array (
    0 => 'mbstring.ja-basic.php',
    1 => '日文字符多字节编码基础',
  ),
  'next' => 
  array (
    0 => 'mbstring.supported-encodings.php',
    1 => '支持的字符编码',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/mbstring/http-inout.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="mbstring.http" class="chapter">
 <h1 class="title">HTTP 输入和输出</h1>

 <p class="para">
  HTTP 输入/输出字符编码转换同样也适用于二进制数据。
  如果 HTTP 输入/输出用到了二进制数据，用户应当控制字符的编码转换。
 </p>
 <blockquote class="note"><p><strong class="note">注意</strong>: 
  <p class="para">
   如果 HTML 表单的 <code class="literal">enctype</code> 属性设置为 <code class="literal">multipart/form-data</code>，并且 <var class="filename">php.ini</var> 里的 <code class="literal">mbstring.encoding_translation</code> 设置为 On，
   POST 的变量以及上传文件的名称也将会被转换到内部字符编码。
   不过，转换不会应用于查询（query）的键。
  </p>
 </p></blockquote>
 <p class="para">
  <ul class="itemizedlist">
   <li class="listitem">
    <span class="simpara">
     HTTP 输入
    </span>
    <p class="para"> 
     在 PHP 脚本里无法控制 HTTP 输入字符的转换。
     要禁用 HTTP 输入字符的转换，必须要在 <var class="filename">php.ini</var> 里设置。
     <div class="example" id="example-1">
      <p><strong>示例 #1 
       在 <var class="filename">php.ini</var> 中禁用 HTTP 输入转换
      </strong></p>
      <div class="example-contents">
<div class="annotation-interactive php.inicode"><pre class="php.inicode">;; 禁用 HTTP 输入转换
mbstring.http_input = pass
;;禁用 HTTP 输入转换 
mbstring.encoding_translation = Off</pre>
</div>
      </div>

     </div>
    </p>
    <p class="para">
     当 PHP 以 Apache 模块运行。这些设置还可以通过 <var class="filename">httpd.conf</var> 内每个虚拟主机（Virtual Host）指令或每个目录下的 <var class="filename">.htaccess</var> 来覆盖（override）。
     详情参见<a href="configuration.php" class="link">配置</a>这一节，以及 Apache 手册。
    </p>
   </li>
   <li class="listitem">
    <span class="simpara">
     HTTP 输出
    </span>
    <p class="para">
     输出字符编码转换的使用有几种方式。
     一种是使用 <var class="filename">php.ini</var>，另一种是使用 <span class="function"><a href="function.ob-start.php" class="function">ob_start()</a></span>，以 <span class="function"><a href="function.mb-output-handler.php" class="function">mb_output_handler()</a></span> 作为 <code class="literal">ob_start</code> 的回调函数。
    </p>
   </li>
  </ul>
 </p>
 <p class="para">
  <div class="example" id="example-2">
   <p><strong>示例 #2 <var class="filename">php.ini</var> 设置例子</strong></p>
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
;; 为所有 PHP 页面启用输出字符编码的转换

;; 启用输出缓冲
output_buffering    = On

;; 设置 mb_output_handler 来进行输出的转换
output_handler      = mb_output_handler
</pre></div>
   </div>

  </div>
 </p>
 <p class="para">
  <div class="example" id="example-3">
   <p><strong>示例 #3 脚本例子</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// 仅为此页面启用输出字符编码的转换<br /><br />// 设置 HTTP 输出字符编码为 SJIS<br /></span><span style="color: #0000BB">mb_http_output</span><span style="color: #007700">(</span><span style="color: #DD0000">'SJIS'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// 开始缓冲并指定 "mb_output_handler" 为回调函数<br /></span><span style="color: #0000BB">ob_start</span><span style="color: #007700">(</span><span style="color: #DD0000">'mb_output_handler'</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </p>
</div>
<?php manual_footer($setup); ?>