http-inout.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 95bdd6883b5dde9504701777ba81b3c5f15df52b Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->

<chapter xml:id="mbstring.http" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>HTTP 入出力</title>
 <para>
  HTTP 入出力の文字エンコーディング変換はバイナリデータも変換して
  しまいます。HTTP 入出力にバイナリデータが使用される場合、ユーザーは、
  文字エンコーディング変換を制御する必要があります。
 </para>
 <note>
  <para>
   HTML フォームの <literal>enctype</literal> が
   <literal>multipart/form-data</literal> に設定され、かつ、
   &php.ini; において
   <literal>mbstring.encoding_translation</literal> に On
   が指定されている場合、
   POST データの変数とアップロードされたファイルの名前の文字エンコーディングは、
   内部文字エンコーディングに変換されます。
   ただし、クエリキーに関しては、変換されません。
  </para>
 </note>
 <para>
  <itemizedlist>
   <listitem>
    <simpara>
     HTTP 入力
    </simpara>
    <para> 
     PHP スクリプトで HTTP 入力文字変換を制御する手段はありません。
     HTTP 入力文字変換を無効にするには、&php.ini;
     で行う必要があります。
     <example>
      <title>
       &php.ini; で HTTP 入力変換を無効にする
      </title>
      <programlisting role="php.ini">
<![CDATA[
;; HTTP 入力変換を無効にする
mbstring.http_input = pass
;; HTTP 入力変換を無効にする
mbstring.encoding_translation = Off
]]>
      </programlisting>
     </example>
    </para>
    <para>
     PHP を Apache モジュールで使用する場合、&php.ini; の設定を
     &httpd.conf; により仮想ホスト単位で、または
     &htaccess; によりディレクトリ単位で上書きすることが可能です。
     詳細は、<link linkend="configuration">設定</link>の節および
     Apache マニュアルを参照ください。
    </para>
   </listitem>
   <listitem>
    <simpara>
     HTTP 出力
    </simpara>
    <para>
     出力の文字エンコーディング変換を有効にする方法は複数あります。
     まず &php.ini;、もうひとつは
     <function>ob_start</function> で <literal>ob_start</literal>
     のコールバック関数として
     <function>mb_output_handler</function> を指定するものです。
    </para>
   </listitem>
  </itemizedlist>
 </para>
 <para>
  <example>
   <title>&php.ini; の設定例</title>
   <programlisting>
<![CDATA[
;; 全ての PHP ページで出力の文字エンコーディング変換を有効にする

;; 出力バッファリングを有効にする
output_buffering    = On

;; mb_output_handler による出力変換を有効にする
output_handler      = mb_output_handler
]]>
   </programlisting>
  </example>
 </para>
 <para>
  <example>
   <title>スクリプトの例</title>
   <programlisting role="php">
<![CDATA[
<?php

// このページでのみ出力の文字エンコーディング変換を有効にする

// HTTP 出力文字エンコーディングをSJISに設定する
mb_http_output('SJIS');

// 出力のバッファリングを開始し、コールバック関数として"mb_output_handler"
// を指定する
ob_start('mb_output_handler');

?>
]]>
   </programlisting>
  </example>
 </para>
</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->