php/archived-doc-ja
1
0
Fork 0
mirror of https://github.com/php/doc-ja.git synced 2026-04-23 07:58:01 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
52bcda59da2c058bd13697dd3899f400a917305d
archived-doc-ja/reference/mbstring/ini.xml
T
TAKAGI Masahiro 97d4b3b8bf sync with en. 
git-svn-id: https://svn.php.net/repository/phpdoc/ja/trunk@193050 c90b9560-bf6c-de11-be94-00142212c4b1
2005-08-11 12:42:03 +00:00

338 lines
10 KiB
XML
Raw Blame History

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.8 $ -->
<!-- EN-Revision: 1.15 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi -->
<section id="mbstring.configuration">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>mbstring 設定オプション</title>
<tgroup cols="4">
<thead>
<row>
<entry>名前</entry>
<entry>デフォルト</entry>
<entry>変更可能な範囲</entry>
<entry>変更履歴</entry>
</row>
</thead>
<tbody>
<row>
<entry>mbstring.language</entry>
<entry>"neutral"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>PHP 4.3.0 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.detect_order</entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>PHP 4.0.6 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.http_input</entry>
<entry>"pass"</entry>
<entry>PHP_INI_ALL</entry>
<entry>PHP 4.0.6 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.http_output</entry>
<entry>"pass"</entry>
<entry>PHP_INI_ALL</entry>
<entry>PHP 4.0.6 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.internal_encoding</entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>PHP 4.0.6 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.script_encoding</entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>PHP 4.3.0 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.substitute_character</entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>PHP 4.0.6 から利用可能です。</entry>
</row>
<row>
<entry>mbstring.func_overload</entry>
<entry>"0"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>PHP 4.2.0 から利用可能で、PHP &lt;= 4.2.3 は PHP_INI_SYSTEM です。</entry>
</row>
<row>
<entry>mbstring.encoding_translation</entry>
<entry>"0"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>PHP 4.3.0 から利用可能です。</entry>
</row>
</tbody>
</tgroup>
</table>
PHP_INI_* 定数の詳細及び定義については、<function>ini_set</function>
を参照してください。
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.mbstring.language">
<term>
<parameter>mbstring.language</parameter>
<type>string</type>
</term>
<listitem>
<para>
mbstring で使用される言語設定(NLS)のデフォルト値。
この設定は <literal>mbstring.internal_encoding</literal> を定義するため、
&php.ini; の中で <literal>mbstring.internal_encoding</literal> は、
<literal>mbstring.language</literal> の後に置く必要があることに注意してください。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.encoding-translation">
<term>
<parameter>mbstring.encoding_translation</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
入力される HTTP クエリに関して、
文字エンコーディング検出および内部文字エンコーディングへの変換を行う
透過的な文字エンコーディングフィルタを有効にします。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.internal-encoding">
<term>
<parameter>mbstring.internal_encoding</parameter>
<type>string</type>
</term>
<listitem>
<para>
内部文字エンコーディングのデフォルト値を定義します。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.http-input">
<term>
<parameter>mbstring.http_input</parameter>
<type>string</type>
</term>
<listitem>
<para>
HTTP 入力文字エンコーディングのデフォルト値を定義します。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.http-output">
<term>
<parameter>mbstring.http_output</parameter>
<type>string</type>
</term>
<listitem>
<para>
HTTP 出力文字エンコーディングのデフォルト値を定義します。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.detect-order">
<term>
<parameter>mbstring.detect_order</parameter>
<type>string</type>
</term>
<listitem>
<para>
文字コード検出のデフォルト値を定義します。
<function>mb_detect_order</function>も参照ください。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.substitute-character">
<term>
<parameter>mbstring.substitute_character</parameter>
<type>string</type>
</term>
<listitem>
<para>
無効な文字を代替する文字を定義します。
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.mbstring.func-overload">
<term>
<parameter>mbstring.func_overload</parameter>
<type>string</type>
</term>
<listitem>
<para>
シングルバイト対応の関数を mbstring 関数の対応する関数でオーバーロード
(置換)します。詳細は、
<link linkend="mbstring.overload">関数のオーバーロード</link>
を参照してください。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
<ulink url="http://www.w3.org/TR/REC-html40/interact/forms.html#adef-accept-charset">HTML 4.01の規約</ulink>
によると、Web ブラウザは、
フォームのデータを投稿する際にページで使用される文字エンコーディングと
異なるエンコーディングを使用することができます。
ブラウザで使用される文字エンコーディングを検出するには、
<function>mb_http_input</function>
を参照ください。
</para>
<para>
一般的に使用されるブラウザでは、
指定したHTML文書の文字エンコーディングをかなり正確に推定することができますが、
<function>header</function> または設定パラメータ
<link linkend="ini.sect.data-handling">default_charset</link> により、
<literal>Content-Type</literal> HTTP ヘッダで <literal>charset</literal>
を設定する方がより良いでしょう。
</para>
<para>
<example>
<title>&php.ini; 設定の例</title>
<programlisting>
<![CDATA[
; デフォルトの言語を設定
mbstring.language = neutral; デフォルト言語を中立(UTF-8)に設定 (デフォルト)
mbstring.language = English; デフォルト言語を英語に設定
mbstring.language = Japanese; デフォルト言語を日本語に設定
;; デフォルトの内部エンコーディングを設定
;; 注意: PHPで動作する文字エンコーディングを使用すること
mbstring.internal_encoding = UTF-8 ; 内部エンコーディングを UTF-8 に設定
;; HTTP入力エンコーディング変換を有効にする
mbstring.encoding_translation = On
;; デフォルトのHTTP入力文字エンコーディングを設定
;; 注意: スクリプトではhttp_inputの設定は変更できません。
mbstring.http_input = pass ; 変換しない。
mbstring.http_input = auto ; HTTP 入力を auto に設定
; 「auto」は、「ASCII,JIS,UTF-8,
; EUC-JP,SJIS」に展開されます。
mbstring.http_input = SJIS ; HTTP入力をSJISに設定
mbstring.http_input = UTF-8,SJIS,EUC-JP ; 順番を指定
;; デフォルトのHTTP出力文字エンコーディングを設定
mbstring.http_output = pass ; 変換しない
mbstring.http_output = UTF-8 ; HTTP出力エンコーディングを
; UTF-8 に指定
;; デフォルトの文字エンコーディング検出順序を設定
mbstring.detect_order = auto ; デフォルトの順番を auto に設定
mbstring.detect_order = ASCII,JIS,UTF-8,SJIS,EUC-JP ; 順番を指定
;; 代替文字のデフォルト値を設定
mbstring.substitute_character = 12307 ; Unicode 値を指定
mbstring.substitute_character = none ; 文字を出力しない
mbstring.substitute_character = long ; long の例: U+3000,JIS+7E7E
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title><literal>EUC-JP</literal> ユーザ用の &php.ini; の設定</title>
<programlisting>
<![CDATA[
;; 出力バッファリングを無効にする
output_buffering = Off
;; HTTP charsetヘッダを設定
default_charset = EUC-JP
;; デフォルトの言語を日本語にする
mbstring.language = Japanese
;; HTTP 入力変換を有効にする
mbstring.encoding_translation = On
;; HTTP 入力エンコーディング変換を auto に設定
mbstring.http_input = auto
;; HTTP 出力を EUC-JP に設定
mbstring.http_output = EUC-JP
;; 内部エンコーディングを EUC-JP に設定
mbstring.internal_encoding = EUC-JP
;; 無効な文字を出力しない
mbstring.substitute_character = none
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title><literal>SJIS</literal> ユーザ用の &php.ini;の 設定</title>
<programlisting>
<![CDATA[
;; 出力のバッファリングを有効に
output_buffering = On
;; 出力の変換を有効にするために mb_output_handler を設定
output_handler = mb_output_handler
;; HTTPヘッダ charset を設定
default_charset = Shift_JIS
;; デフォルトの言語を日本語に設定
mbstring.language = Japanese
;; HTTP 入力変換を有効にする
mbstring.encoding_translation = On
;; HTTP 入力エンコーディング変換を auto に設定
mbstring.http_input = auto
;; SJIS に変換
mbstring.http_output = SJIS
;; 内部エンコーディングを EUC-JP に設定
mbstring.internal_encoding = EUC-JP
;; 無効な文字を出力しない
mbstring.substitute_character = none
]]>
</programlisting>
</example>
</para>
</section>
<!-- 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:"../../../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
-->
Reference in New Issue View Git Blame Copy Permalink