<?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 => 'ja',
  ),
  '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' => 'ja',
    '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 データの変数とアップロードされたファイルの名前の文字エンコーディングは、
   内部文字エンコーディングに変換されます。
   ただし、クエリキーに関しては、変換されません。
  </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">php.ini</var> の設定を
     <var class="filename">httpd.conf</var> により仮想ホスト単位で、または
     <var class="filename">.htaccess</var> によりディレクトリ単位で上書きすることが可能です。
     詳細は、<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> で <code class="literal">ob_start</code>
     のコールバック関数として
     <span class="function"><a href="function.mb-output-handler.php" class="function">mb_output_handler()</a></span> を指定するものです。
    </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 />// を指定する<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); ?>