language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 850a9367b8ff7fe0ba91042daf9d61d58c985b1e Maintainer: takagi Status: working -->
<!-- Credits: hirokawa,haruki,shimooka,mumumu -->

<!ENTITY installation.enabled.disable 'この拡張モジュールはデフォルトで有効になっています。無効にしたい場合は、次のオプションを指定してコンパイルします。'>

<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>
乱数生成器が自動的にシードを生成するようになりました。</entry></row>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.3.0 で
<emphasis>非推奨</emphasis>となりました。
この機能を使用しないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 5.3.0 で
<emphasis>非推奨</emphasis>となりました。
この機能を使用しないことを強く推奨します。</simpara></warning>'>

<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  この関数が生成する値は、暗号学的にセキュアではありません。そのため、これを暗号や、戻り値を推測できないことが必須の値として使っては <emphasis>いけません</emphasis>。
 </para>
 <para>
  暗号学的にセキュアな乱数が必要な場合は、<classname>Random\Randomizer</classname> を <classname>Random\Engine\Secure</classname> と一緒に使いましょう。簡単なユースケースの場合、<function>random_int</function> と <function>random_bytes</function> 関数が、オペレーティングシステムの <acronym>CSPRNG</acronym> を使った、 便利で安全な <acronym>API</acronym> を提供します。
 </para>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Mt19937 (メルセンヌ・ツイスター) エンジンは、シードとして32ビットの整数だけを受け入れます。よって、2<superscript>19937</superscript>-1 もの周期を持つにも関わらず、あり得るランダムなシーケンスの数はたかだか 2<superscript>32</superscript> (つまり 4,294,967,296) しかありません。
 </para>
 <para>
  暗黙、または明示的にランダムなシードに依存する場合、
  重複がそれ(4,294,967,296 個)よりも早く発生します。
  誕生日のパラドックスによると、80,000 個以下のランダムな値を生成した場合でも、
  シードの重複が 50&#37; の確率で発生します。
  重複したシードの 10&#37; が、ざっと 30,000 個のランダムな値を生成したあとに発生します。
 </para>
 <para>
  このため、無視できる確率以上に重複したシーケンスが発生してはいけないアプリケーションでは、Mt19937 は適していません。
  再現可能なシードが必須の場合、
  <classname>Random\Engine\Xoshiro256StarStar</classname> と <classname>Random\Engine\PcgOneseq128XslRr64</classname>
  が、ランダムな値が衝突しにくく、より大きなシードをサポートしています。
  再現可能なシードが必須でない場合、
  <classname>Random\Engine\Secure</classname>
  が、暗号学的にセキュアなランダム性を提供します。
 </para>
</caution>'>

<!-- Notes -->

<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数はバイナリデータに対応しています。
</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数の結果は
キャッシュされます。詳細は、<function>clearstatcache</function>
を参照してください。</simpara></note>'>

<!ENTITY note.context-support '<para xmlns="http://docbook.org/ns/docbook"><link linkend="stream.contexts">ストリームコンテキスト</link>リソース</para>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para>プログラムがこの関数で始まる場合、
バックグラウンドで処理を続けさせるには、
プログラムの出力をファイルや別の出力ストリームにリダイレクトする必要があります。
そうしないと、プログラムが実行を終えるまで PHP はハングしてしまいます。</para></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><para>Windowsでは、<function>exec</function> 関数はコマンドを起動するために最初に cmd.exe を起動します。cmd.exe を起動せずに外部プログラムを起動したい場合は、<function>proc_open</function> 関数を <parameter>bypass_shell</parameter> オプションを指定して使うようにしてください。</para></note>'>

<!ENTITY note.extractto-windows '<note xmlns="http://docbook.org/ns/docbook"><para>Windows の NTFS ファイルシステムには、ファイル名で使う場合にサポートしていない文字があります。具体的には、<literal>&lt;|&gt;*?":</literal> です。末尾にドットがあるファイル名もサポートしていません。いくつかの展開ツールと異なり、このメソッドはこれらの文字をアンダースコアで置き換えませんし、そのようなファイルを展開すると失敗します。</para></note>'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>関数名の代わりに、オブジェクトへの
リファレンスを格納した配列とメソッド名を指定することもできます。</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para>
<function>call_user_func</function> や <function>call_user_func_array</function> で登録されたコールバックは、
前のコールバックからスローされた例外がキャッチされていない場合はコールされません。</para></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>
引数をリファレンス渡しにすると、その引数への変更がすべてこの関数の返り値に反映されます。
PHP 7 からは、引数が値渡しされた場合には現在の値も返されるようになりました。</para></note>'>

<!ENTITY note.funcnoparam '<note xmlns="http://docbook.org/ns/docbook"><para>この関数は、
カレントスコープに依存してパラメータの詳細を決定しますので、
5.3.0 より前のバージョンでは関数パラメータとして使用することができません。
もし、この値を渡さなければならない場合、戻り値を変数に割り当て、
その変数を渡してください。</para></note>'>

<!ENTITY note.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>
PHP 8.0.0 以降における func_*() 関数ファミリは、名前付き引数に関しては、ほぼ透過的に動作するはずです。つまり、渡された全ての引数は位置を指定したかのように扱われ、引数が指定されない場合は、デフォルト値で置き換えられるということです。
この関数は、未知の名前付きの可変長引数を無視します。
未知の名前付き引数は、可変長引数を通じてのみアクセスできます。
</para></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara>
マッキントッシュコンピュータ上で作成されたファイルを読み込む際に、
<literal>PHP</literal> が行末を認識できないという問題が発生した場合、
実行時の設定オプション<link linkend="ini.auto-detect-line-endings"
>auto_detect_line_endings</link> を有効にする必要が生じるかもしれません。</simpara>
</note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数では、
<link linkend="features.remote-files">リモートファイル</link> を
使用することはできません。これは、処理されるファイルがサーバーの
ファイルシステムによりアクセスできる必要があるためです。</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara>この関数は
(まだ)バイナリデータ対応ではありません!</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、
<parameter>array</parameter> パラメータの要素に対して新しいキーを割り当てます。
その際、単純にキーを並べ替える代わりに、
すでに割り当てられている既存のキーを削除してしまいます。</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は Windows 環境にはまだ実装されていません。
</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara>この拡張モジュールは Windows
環境では利用できません。</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は
ZTS (Zend Thread Safety) を有効にしてビルドした PHPインタプリタでは利用できません。あなたの PHP で ZTS が有効かどうかを調べるには、<command>php -i</command> コマンドを使うか、ビルトイン定数<constant>PHP_ZTS</constant> を確認してください。</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>
<function>srand</function> または
<function>mt_srand</function>
によりランダム数生成器にシードを与える必要はありません。
これは、この処理が自動的に行われるためです。</simpara></note>'>

<!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><para>これは 'スーパーグローバル'
あるいは自動グローバル変数と呼ばれるものです。
スクリプト全体を通してすべてのスコープで使用することができます。
関数やメソッドの内部で使用する場合にも
<command>global $variable;</command> とする必要はありません。
</para></note>">

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>
<parameter>return</parameter> パラメータを使う場合、この関数は内部的に出力バッファリングを使います。
そのため、<function>ob_start</function> コールバック関数の中では使えません。</para></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><para><parameter>return</parameter> パラメータを使う場合、かつ PHP 7.1.0 より前のバージョンでは、この関数は内部的な出力バッファリングを使っていました。この場合、<function>ob_start</function> のコールバック関数の中では使えません。</para></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>時刻の精度は、
ファイルシステムによって異なることがあります。</para></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook">
<para>この関数を使うと、未知のクラスに対しては登録済みの
<link linkend="language.oop5.autoload">autoloader</link> を使用します。</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
   <para>
    ヘッダにアクセスできたりヘッダを出力したりするのは、
    それに対応した SAPI を使っている場合のみです。
   </para>
  </note>
'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  PHP のコンパイル時に --enable-sigchild を指定した場合は、この関数の返り値は未定義となります。
 </para>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  比較結果が等しくなる二つの要素があった場合、それらの並び順は保持されます。PHP 8.0.0 より前のバージョンでは、ソートした配列におけるそれらの並び順は不定でした。
 </para>
</note>
'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
  この関数をコールすると、配列の内部ポインタは最初の要素にリセットされます。
 </para>
</note>
">

<!ENTITY note.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  この関数を実行しても何も起こりません。PHP 8.0.0 より前のバージョンでは、この関数はリソースを閉じるのに使われていました。
 </para>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara><link linkend="ini.allow-url-fopen"
>fopen wrappers</link> が有効の場合、この関数のファイル名として
URL を使用することができます。ファイル名の指定方法に関する詳細は
<function>fopen</function> を参照ください。
<xref linkend="wrappers"/> には、さまざまなラッパーの機能やその使用法、
提供される定義済み変数などの情報がまとめられています。</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>
<literal>PHP 5.0.0</literal> 以降、この関数は、
<emphasis>何らかの</emphasis> URL ラッパーと組合せて使用することができます。
どのラッパーが <function>stat</function> ファミリーをサポートしているかを調べるには
<xref linkend="wrappers"/> を参照してください。</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>ブラウザに直接結果を出力する
すべてのものと同様に、<link linkend="book.outcontrol">出力制御関数</link>
を使用してこの関数の出力をキャプチャーし、(例えば)文字列
(<type>string</type>)に保存することが可能です。</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara>
<xref linkend="userlandnaming" /> も参照ください。</simpara></tip>'>


<!-- Warnings -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para>ユーザーが入力したデータをこの関数に
渡すことを許可する場合、ユーザーが任意のコマンドを実行できるようシステムを欺くことが
できないように <function>escapeshellarg</function> または
<function>escapeshellcmd</function> を適用する必要があります。</para></warning>'>


<!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"><simpara>この拡張モジュールは、
<emphasis>実験的</emphasis> なものです。この拡張モジュールの動作・
関数名・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP
のリリースにおいて変更される可能性があります。
このモジュールは自己責任で使用してください。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.3.0 で
<emphasis>非推奨</emphasis> となりました。
この機能を使用しないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.3.0 で
<emphasis>非推奨</emphasis>となりました。
この機能を使用しないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 5.3.0 で
<emphasis>非推奨</emphasis>となりました。
この機能を使用しないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.3.0 で
<emphasis>非推奨</emphasis>となり、
PHP 5.4.0 で<emphasis>削除</emphasis>されました。</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 5.3.0 で
<emphasis>非推奨</emphasis>となり、
PHP 5.4.0 で<emphasis>削除</emphasis>されました。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.5.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.6.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 7.0.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 7.1.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.1.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.0.0 で
<emphasis>非推奨</emphasis>となり、PHP 8.0.0 で<emphasis>削除</emphasis>
されました。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.1.0 で
<emphasis>非推奨</emphasis>となり、PHP 7.2.0 で<emphasis>削除</emphasis>
されました。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 7.2.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 7.2.0 で
<emphasis>非推奨</emphasis> になり、PHP 8.0.0 で <emphasis>削除</emphasis>
されました。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.2.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.2.0 で
<emphasis>非推奨</emphasis> になり、PHP 8.0.0 で <emphasis>削除</emphasis>
されました。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 7.3.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.3.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.3.0 で
<emphasis>非推奨</emphasis> になり、PHP 8.0.0 で <emphasis>削除</emphasis>
されました。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 7.4.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.4.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 7.4.0 で
<emphasis>非推奨</emphasis> になり、PHP 8.0.0 で <emphasis>削除</emphasis>
されました。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.feature.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>この機能は、PHP 8.0.0 で <emphasis>削除されました</emphasis>。</simpara>
</warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 8.0.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 8.1.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 8.2.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 8.3.0 で
<emphasis>非推奨</emphasis>になります。この機能に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 8.3.0 で
<emphasis>非推奨</emphasis>になります。この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY removed.php.future 'この非推奨の機能は、<emphasis xmlns="http://docbook.org/ns/docbook">きっと</emphasis> 
将来 <emphasis xmlns="http://docbook.org/ns/docbook">削除</emphasis> されるでしょう。'>

<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
この関数は <emphasis>非推奨</emphasis> であり、PHP 5.3.0 で <emphasis>削除</emphasis> されます。</simpara></warning>'>

<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は
<emphasis>非推奨</emphasis> であり、PHP 5.5.0 で <emphasis>削除</emphasis> されます。</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>このエイリアスは PHP 5.3.0 で <emphasis>非推奨</emphasis> となりました。
このエイリアスを使用しないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>この関数は、PHP 5.4.0 以降では<emphasis>非推奨</emphasis>となりました。
この関数は決して使わないようにしましょう。</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>このエイリアスは PHP 5.4.0 で <emphasis>非推奨</emphasis> となりました。
このエイリアスを使用しないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>この関数は PHP 5.5.0 で <emphasis>非推奨</emphasis> となりました。
この関数に頼らないことを強く推奨します。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.5.0 で <emphasis>非推奨</emphasis> となり、
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 5.5.0 で <emphasis>非推奨</emphasis> となり、
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 5.3.0 で <emphasis>非推奨</emphasis> となり、
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 4.1.0 で <emphasis>非推奨</emphasis> となり、
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
このエイリアスは PHP 5.3.0 で <emphasis>非推奨</emphasis> となり、
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は PHP 5.6.0 で <emphasis>非推奨</emphasis> となり、
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は
PHP 7.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この機能は
PHP 7.4.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>このエイリアスは PHP 7.2.0 で <emphasis>非推奨</emphasis> となり、PHP 8.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>このエイリアスは PHP 7.4.0 で <emphasis>非推奨</emphasis> となり、PHP 8.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>このエイリアスは PHP 8.0.0 で <emphasis>非推奨</emphasis> になりました。</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>このエイリアスは PHP 8.0.0 で <emphasis>削除</emphasis> されました。</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、
<emphasis>実験的</emphasis> なものです。この関数の動作・
名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP
のリリースにおいて変更される可能性があります。
この関数は自己責任で使用してください。</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara><link
linkend="book.imap">IMAP</link>、<link linkend="book.recode">recode</link>、
<link linkend="book.yaz">YAZ</link>
拡張モジュールは、組み合わせて使用することはできません。
これは、これらすべてが同一の内部シンボルを使用しているためです。
注意: Yaz 2.0 以降ではこの問題は発生しません。</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><para>
CGI モードで公開したサーバーは、いくつかの脆弱性の標的となる可能性があります。
これらの攻撃からサーバーを守る方法については、
<link linkend="security.cgi-bin">CGI セキュリティ</link>
のセクションを参照してください。</para></warning>'>

<!ENTITY warn.passwordhashing '
<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  パスワードを守るためにこの関数を使うことはおすすめしません。
  ハッシュアルゴリズムの高速性がその理由です。
  詳細とベストプラクティスについては、<link
   linkend="faq.passwords.fasthash">パスワードハッシュ FAQ</link>を参照ください。
 </para>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>IIS のような、いくつかの標準に
対応してない Web サーバーは、PHP に警告を発生させるような手順でデータを送信します。
このようなサーバーを使用する場合は、<link linkend="ini.error-reporting">
error_reporting</link> を警告を発生しないレベルまで小さくする必要があります。
PHP では、<literal>https://</literal> ラッパーでストリームをオープンする際に
バグがある IIS サーバーソフトウエアを検出することができ、この警告を抑制することができます。
あなたが <literal>ssl://</literal> ソケットを作成するために  <function>fsockopen</function> を使用している場合、
自らこの警告を検出し、抑制する必要があります。</para></warning>'>

<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  このクラスは、現在のところ詳細な情報はありません。プロパティとメソッドのリストのみが記述されています。
 </simpara>
</warning>
'>

<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、
現在のところ詳細な情報はありません。引数のリストのみが
記述されています。</simpara></warning>'>


<!-- Deprecation and removal warnings designed for use with a list of
     alternatives. See en/reference/regex/functions/ereg.xml and
     en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この関数は PHP 4.1.0 で <emphasis>非推奨</emphasis> となり、
 PHP 7.0.0 で <emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この関数の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この機能は PHP 5.3.0 で <emphasis>非推奨</emphasis> となり、
 PHP 7.0.0 で <emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この機能の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この関数は PHP 5.3.0 で <emphasis>非推奨</emphasis> となり、
 PHP 7.0.0 で <emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この関数の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この関数は PHP 5.5.0 で <emphasis>非推奨</emphasis> となり、
 PHP 7.0.0 で <emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この関数の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.removed.feature.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この機能は PHP 7.0.0 で <emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この機能の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.removed.function.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この関数は PHP 7.0.0 で <emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この関数の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この機能は PHP 7.1.0 で <emphasis>非推奨</emphasis> となり、
 PHP 7.2.0 で<emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この機能の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 この関数は PHP 7.1.0 で <emphasis>非推奨</emphasis> となり、
 PHP 7.2.0 で<emphasis>削除</emphasis> されました。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 この関数の代替として、これらが使えます。
</para>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は PHP 8.1.0 で
<emphasis>非推奨</emphasis> になります。この関数に頼らないことを強く推奨します。</simpara></warning>
<para xmlns="http://docbook.org/ns/docbook">
この関数の代替として、これらが使えます:
</para>
'>

<!-- Misc -->

<!ENTITY version.exists.asof 'これが使えるようになった PHP のバージョンは '>

<!ENTITY version.trunk.changelog '将来のバージョン'>

<!ENTITY no.function.parameters '<para xmlns="http://docbook.org/ns/docbook">この関数にはパラメータはありません。</para>'>

<!ENTITY example.outputs '<para xmlns="http://docbook.org/ns/docbook">上の例の出力は以下となります。</para>'>

<!ENTITY example.outputs.5 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 5 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.53 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 5.3 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.54 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 5.4 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 5.5 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 5.6 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.7 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 7 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.70 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 7.0 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 7.1 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.72 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 7.2 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.73 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 7.3 での出力は、このようになります。</para>'>

<!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8 での出力は、このようになります。:</para>'>

<!ENTITY example.outputs.8.similar '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8 での出力は、たとえば以下のようになります。:</para>'>

<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8.0 での出力は、このようになります。:</para>'>

<!ENTITY example.outputs.81 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8.1 での出力は、このようになります。:</para>'>

<!ENTITY example.outputs.82 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8.2 での出力は、このようになります。:</para>'>

<!ENTITY example.outputs.82.similar '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8.2 での出力は、たとえば以下のようになります。:</para>'>

<!ENTITY example.outputs.83 '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8.3 での出力は、このようになります。:</para>'>

<!ENTITY example.outputs.83.similar '<para xmlns="http://docbook.org/ns/docbook">上の例の PHP 8.3 での出力は、たとえば以下のようになります。:</para>'>

<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">上の例の 32 ビットマシンでの出力は、このようになります。</para>'>

<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">上の例の 64 ビットマシンでの出力は、このようになります。</para>'>

<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">上の例の出力は、
たとえば以下のようになります。</para>'>

<!ENTITY examples.outputs '<para xmlns="http://docbook.org/ns/docbook">上の例の出力は以下となります。</para>'>

<!ENTITY examples.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">上の例の 32 ビットマシンでの出力は、このようになります。</para>'>

<!ENTITY examples.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">上の例の 64 ビットマシンでの出力は、このようになります。</para>'>

<!ENTITY examples.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">上の例の出力は、
たとえば以下のようになります。</para>'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、
入力配列のポインタを、使用した後にリセット
(<function>reset</function>) します。</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>callback</parameter> がリファレンス渡しされる引数を期待している場合、
  この関数は <constant>E_WARNING</constant> を発生させるようになりました。
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
  この関数は、引数をひとつだけ渡しても呼び出せるようになりました。
  これより前のバージョンでは、少なくともふたつの引数が必須でした。
  </entry>
</row>'>

<!ENTITY seealso.array.sorting '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">配列ソート関数の比較</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>flags</parameter></term>
  <listitem>
   <para>
    オプションの第二引数 <parameter>flags</parameter> によりソートの動作を修正可能です。
    使える値は下記の通りです:
   </para>
   <para>
    ソートタイプのフラグ:
    <itemizedlist>
     <listitem>
      <simpara><constant>SORT_REGULAR</constant> - 通常通りに項目を比較します。
      詳細は <link linkend="language.operators.comparison">比較演算子</link> で説明されています。</simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_NUMERIC</constant> - 数値として項目を比較します。</simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_STRING</constant> - 文字列として項目を比較します。</simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_LOCALE_STRING</constant> - 現在のロケールに基づいて、文字列として項目を比較します。
       比較に使うロケールは、<function>setlocale</function> 関数で変更できます。
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_NATURAL</constant> - 要素の比較を文字列として行い、 
       <function>natsort</function> と同様の「自然順」で比較します。
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_FLAG_CASE</constant> - <constant>SORT_STRING</constant> や
       <constant>SORT_NATURAL</constant> と (ビットORで) 組み合わせて使い、
       文字列のソートで大文字小文字を区別しないようにします。
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </listitem>
 </varlistentry>
'>

<!ENTITY sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
 &return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  <type>float</type> のような <emphasis>非整数</emphasis> を比較関数が返すと、その返り値を内部的に <type>int</type> にキャストして使います。
  つまり、<literal>0.99</literal> や <literal>0.1</literal> といった値は整数値 <literal>0</literal> にキャストされ、
  値が等しいとみなされます。
 </para>
</caution>'>

<!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  ソートに使うコールバック関数は、任意の配列からの任意の値を、もともとの順番に関係なく、任意の順番で処理できなければいけません。なぜなら、個々の配列は、他の配列と比較する前に最初にソートされるからです。

  サンプルコードは、以下のようになります:
  <programlisting role="php">
<![CDATA[
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 と $item2 は "string", 1, ["value" => 1] のいずれでも構いません
$compareFunc = static function ($item1, $item2) {
    $value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
    $value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
    return $value1 <=> $value2;
};
?>
]]>
  </programlisting>
 </para>
</caution>'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook"><type>int</type>を使用する際、
その値はバイト単位で測られます。
<link linkend="faq.using.shorthandbytes">この FAQ</link> に記載された
短縮表記を使用することも可能です。</simpara>'>

<!ENTITY info.deprecated.alias '下位互換のために、次の非推奨別名を使用してもいいでしょう。'>

<!ENTITY info.function.alias 'この関数は次の関数のエイリアスです。'>

<!ENTITY info.method.alias 'このメソッドは次のメソッドのエイリアスです。'>

<!ENTITY info.function.alias.deprecated
'<simpara xmlns="http://docbook.org/ns/docbook">この関数エイリアスは非推奨であり、下位互換性維持のために残されています。
今後、PHP から削除される可能性がありますので、この関数を使用しないことを推奨します。
</simpara>'>

<!ENTITY ext.windows.path.dll 'この拡張モジュールを動作させるには、
Windows システムの <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> が通った場所に
<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> ファイルが存在する必要があります。
<acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym> の "<link xmlns="http://docbook.org/ns/docbook"
linkend="faq.installation.addtopath">Windows で PHP のディレクトリを
PATH に追加するにはどうすればいいのですか?</link>" で、その方法を説明しています。
DLL ファイルを PHP のフォルダから Windows のシステムディレクトリにコピーしても動作します
(システムディレクトリは、デフォルトで <envar xmlns="http://docbook.org/ns/docbook">PATH</envar>
に含まれるからです) が、これは推奨しません。
<emphasis xmlns="http://docbook.org/ns/docbook">この拡張モジュールを使用するには、以下のファイルが
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar> の通った場所にある必要があります。</emphasis> '>

<!ENTITY manual.migration.seealso 'これらのバージョンへの移行ガイドも参照ください。'>

<!ENTITY style.oop 'オブジェクト指向型'>
<!ENTITY style.procedural '手続き型'>

<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">リソース</link>'>

<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>

<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>

<!ENTITY parameter.context '<literal xmlns="http://docbook.org/ns/docbook">コンテキスト</literal> についての説明は、
マニュアルの <link xmlns="http://docbook.org/ns/docbook" linkend="context">コンテキスト</link> の節を参照ください。'>

<!ENTITY parameter.use_include_path '&true; に設定すると、このファイル名を
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link> の中からも探します。'>

<!-- Returns -->

<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  戻り値の型が、&true; になりました。これより前のバージョンでは、<type>bool</type> でした。
 </entry>
</row>'>

<!ENTITY return.falseforfailure '失敗した場合に &false; を返します'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; の場合は、失敗したときに &false; を返します。'>

<!ENTITY return.success '成功した場合に &true; を、&return.falseforfailure;。'>
<!ENTITY return.nullorfalse '成功した場合に &null; を、&return.falseforfailure;.'>

<!ENTITY return.void '値を返しません。'>

<!ENTITY return.true.always '常に &true; を返します。'>

<!ENTITY return.callbacksort '比較関数は、最初の引数と二番目の引数の比較結果を返します。最初の引数のほうが二番目の引数より大きい場合は正の整数を、二番目の引数と等しい場合はゼロを、そして二番目の引数より小さい場合は負の整数を返す必要があります。'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara>この関数は論理値
&false; を返す可能性がありますが、&false; として評価される値を返す可能性もあります。
詳細については <link linkend="language.types.boolean">論理値</link>の
セクションを参照してください。この関数の返り値を調べるには
<link linkend="language.operators.comparison">===演算子</link> を
使用してください。</simpara></warning>'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  この関数を &object; に対してコールすることは、推奨されなくなりました。
  &object; に対して最初に <function>get_mangled_object_vars</function> を使って配列に変換するか、<classname>ArrayIterator</classname> のような <interfacename>Iterator</interfacename> を実装したクラスのメソッドを使ってください。
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link> クラスのインスタンスは、プロパティを持たない空のオブジェクトのように扱われるようになりました。これより前のバージョンでは、この関数と同じ名前の <interfacename>Iterator</interfacename> のメソッドをコールしていました。
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  これより前のバージョンで負の数と正の数を返していた場合に、
  この関数は <literal>-1</literal> と <literal>1</literal> を返すようになりました。
 </entry>
</row>
'>

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook"><function>finfo_open</function> が返す、<classname>finfo</classname> クラスのインスタンス。</para>'>
<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>finfo</parameter> は、<classname>finfo</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>x509</parameter></term>
 <listitem>
  <para>
   使用できる値の一覧は <link
    linkend="openssl.certparams">キー/証明書パラメータ</link> を参照ください。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>csr</parameter></term>
 <listitem>
  <para>
   使用できる値の一覧は <link
    linkend="openssl.certparams">CSR パラメータ</link> を参照ください。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.key '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>key</parameter></term>
 <listitem>
  <para>
   使用できる値の一覧は <link
    linkend="openssl.certparams">公開/秘密鍵パラメータ</link> を参照ください。
  </para>
 </listitem>
</varlistentry>'>

<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib '<note xmlns="http://docbook.org/ns/docbook"><simpara> この関数は、PHP が
<option role="configure">--with-t1lib</option>
を指定してコンパイルされている場合のみ使用可能です。</simpara></note>'>

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、PHP が FreeType サポート
(<option role="configure">--with-freetype-dir=DIR</option>)
を有効にしてコンパイルされている場合のみ使用可能です。
</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><para>この関数は、GD 画像ライブラリは必要ありません。</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>この関数は、<function>imagesetinterpolation</function> で設定した補間方式の影響を受けます。</para></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>image</parameter></term><listitem><para><function>imagecreatetruecolor</function>のような画像作成関数が返す <classname>GdImage</classname> オブジェクト。</para></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>font</parameter></term><listitem><para>latin2 エンコーディングの組み込みのフォントの場合は 1, 2, 3, 4, 5 のいずれか (数字が大きなほうが、より大きいフォントに対応します)、あるいは <function>imageloadfont</function> が返した、<classname>GdFont</classname> クラスのインスタンスのいずれか。</para></listitem></varlistentry>'>


<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>
  <entry>
  引数 <parameter>font</parameter> は、<classname>GdFont</classname> クラスのインスタンスと数値を両方受け入れるようになりました。これより前のバージョンでは、数値のみを受け入れていました。
  </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
    <varlistentry xmlns='http://docbook.org/ns/docbook'>
     <term><parameter>fontfile</parameter></term>
     <listitem>
      <para>
       使用したい TrueType フォントへのパス。
      </para>
      <para>
       どの GDライブラリをPHPが使っているかによって、
       <emphasis>いつ
       <parameter>fontfile</parameter> パラメータの先頭が
       <literal>/</literal> で始まらず、
       <literal>.ttf</literal> がファイル名に付加されるかが違います。</emphasis>
       そして、ライブラリは自らが定義したフォントパスに従ってそのファイル名を探そうとします。
      </para>
      <para>
       GD ライブラリ 2.0.18 より前のバージョンを使っている場合、
       セミコロンではなく、<literal>space</literal> 文字が 異なるフォントファイルの
       'pathのセパレータ' として使われていました。
       この機能を意図せず使ってしまうと、次のような警告が発生します:
       <literal>Warning: Could not find/open font</literal>.
       この事象の影響を受けてしまうバージョンでは、
       唯一の解決策はフォントをスペースを含まないパスに移動させることだけです。
      </para>
      <para>
       多くの場合、スクリプトが使っているフォントと同じディレクトリにある場合、
       次のようなテクニックで問題を軽減できるでしょう。
       <programlisting role='php'>
<![CDATA[
<?php
// GD の環境変数を設定
putenv('GDFONTPATH=' . realpath('.'));

// 使用されるフォント名 ( .ttf 拡張子の欠落に注意)
$font = 'SomeFont';
?>
]]>
       </programlisting>
      </para>
      <note>
       <para>
        <link linkend='ini.open-basedir'>open_basedir</link> は
        <parameter>fontfile</parameter> には適用され <emphasis>ない</emphasis> ことに注意してください。
       </para>
      </note>
     </listitem>
    </varlistentry>
">

<!ENTITY gd.return.identifier '成功した場合に画像オブジェクト、エラー時に &false; を返します。'>

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>しかしながら、libgd がイメージの出力に失敗した場合、この関数は &true; を返します。</simpara></caution>'>

<!ENTITY gd.identifier.color "<function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function> で作成された色識別子。">

<!ENTITY gd.value.red '赤コンポーネントの値。'>

<!ENTITY gd.value.green '緑コンポーネントの値。'>

<!ENTITY gd.value.blue '青コンポーネントの値。'>

<!ENTITY gd.source.height 'コピー元の高さ。'>

<!ENTITY gd.source.width 'コピー元の幅。'>

<!ENTITY gd.image.path 'ファイル保存先のパスあるいはオープン中のリソース (この関数が値を戻した後で自動的にクローズされます)。省略したり &null; を設定したりした場合は、画像ストリームを直接出力します。'>

<!ENTITY gd.image.new '新しい画像をファイルあるいは URL から作成する'>

<!ENTITY gd.image.source 'コピー元の画像リソース。'>

<!ENTITY gd.image.destination 'コピー先の画像リソース。'>

<!ENTITY gd.image.output '画像をブラウザあるいはファイルに出力する'>

<!ENTITY gd.image.colors '画像をファイルから作成した場合は、画像内で使われている色だけを解決します。パレットにだけ存在する色は解決されません。'>

<!ENTITY gd.font.size 'ポイント数単位のフォントサイズ。'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
    <function>imagetypes</function> の戻り値として用います。
</simpara>'>

<!ENTITY gd.changlog.t1lib '<row xmlns="http://docbook.org/ns/docbook">
    <entry>7.0.0</entry><entry>PHP から T1Lib サポートが削除されたため、この関数は削除されました。</entry>
</row>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">
    <function>imagecolorallocate</function> や
    <function>imagecolorallocatealpha</function>
    で割り当てた色のかわりに使用できる、特別な色オプション。
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">
    アフィン変換の形式を表す定数。<function>imageaffinematrixget</function> 関数が使用します。
</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">
    スタイル定数。<function>imagefilledarc</function> 関数が使用します。
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
    タイプ変数。<function>imagegd2</function> 関数が使用します。
</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">
    アルファブレンディング効果。<function>imagelayereffect</function> 関数で使用します。
</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
    特別な GD フィルタ。<function>imagefilter</function> 関数で使用します。
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
    画像タイプ定数。<function>image_type_to_mime_type</function>
    や <function>image_type_to_extension</function> 関数で使用します。
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
    特別な PNG フィルタ。<function>imagepng</function> 関数で使用します。
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
    <function>imageflip</function> で使用します。PHP 5.5.0 以降で使用可能です。
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
    <function>imagesetinterpolation</function> で使用します。PHP 5.5.0 以降で使用可能です。
</simpara>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>GD
と GD2 画像フォーマットは libgd が作った独自仕様の画像フォーマットです。これらは <emphasis>obsolete</emphasis> と見なされているため、開発とテストの用途にだけ使うべきです。</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>image</parameter> は、
  <classname>GdImage</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、有効な <literal>gd</literal> <type>resource</type> が期待されていました。
 </entry>
</row>'>

<!-- DBM notes -->

<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>dbm_identifier</parameter></term><listitem><para><function>dbmopen</function> が返す DBM リンク識別子。</para></listitem></varlistentry>'>

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
 <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <para>
   PHP の実装は、
   <link xlink:href="&url.rfc;7159">RFC 7159</link> の JSON のスーパーセットです。
  </para>
 </note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>handle</parameter>
</term><listitem><para><function>curl_init</function>
が返す cURL ハンドル。</para></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>multi_handle</parameter>
</term><listitem><para><function>curl_multi_init</function>
が返す cURL マルチハンドル。</para></listitem></varlistentry>'>

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>
<function>curl_share_init</function> が返す cURL 共有ハンドル</para></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>handle</parameter> は <classname>CurlHandle</classname> クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、<type>resource</type> を期待していました。
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>multi_handle</parameter> は <classname>CurlMultiHandle</classname> クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、<type>resource</type> を期待していました。
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>share_handle</parameter> は <classname>CurlShareHandle</classname> クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、<type>resource</type> を期待していました。
 </entry>
</row>'>


<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
   各フィールドは適切な PHP の型に変換されますが、以下に挙げる例外があります。
   <itemizedlist>
    <listitem>
     <simpara>
      Date は文字列のままになります。
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      DateTime は文字列に変換されます。
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant>
      の範囲外の Integer は文字列になります。
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      dbase 7.0.0 より前のバージョンでは、boolean (<literal>L</literal>) が
      <literal>1</literal> あるいは <literal>0</literal> に変換されていました。
     </simpara>
    </listitem>
   </itemizedlist>
  </para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>broker</parameter></term>
     <listitem>
      <para>
       <function>enchant_broker_init</function> によって返される Enchant ブローカー。
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <para>
       <function>enchant_broker_request_dict</function>
       または
       <function>enchant_broker_request_pwl_dict</function>
       によって返される Enchant 辞書。
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>broker</parameter> は、<classname>EnchantBroker</classname> クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; が期待されていました。
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>dictionary</parameter> は、<classname>EnchantDictionary</classname> クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; が期待されていました。
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>imap</parameter> は、<classname>IMAP\Connection</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、有効な <literal>imap</literal> &resource; が期待されていました。
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>imap</parameter></term><listitem><para><classname>IMAP\Connection</classname> クラスのインスタンス。</para></listitem></varlistentry>'>

<!-- Deprecated -->
<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>imap</parameter></term><listitem><para><function>imap_open</function> が返す IMAP ストリーム。</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">検索を開始するメールボックスの階層を指定します。</para>
<para xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter> の中で使用できる特別な文字として
&apos;<literal>*</literal>&apos; および &apos;<literal>&#37;</literal>&apos; があります。
&apos;<literal>*</literal>&apos; は、すべてのメールボックスを意味します。
<parameter>pattern</parameter> に &apos;<literal>*</literal>&apos; を指定すると、
メールボックス階層全体のリストが得られます。
&apos;<literal>&#37;</literal>&apos; は現在のレベルのみを意味します。
&apos;<literal>&#37;</literal>&apos; を <parameter>pattern</parameter> に指定すると、
トップレベルのメールボックスのみを返します。<literal>UW_IMAPD</literal> の場合、
&apos;<literal>~/mail/&#37;</literal>&apos; は
<filename>~/mail</filename> ディレクトリ内のすべてのメールボックスを返しますが、
そのディレクトリのサブフォルダにあるメールボックスは返しません。</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
信頼できないデータをこのパラメータに渡すのであれば、
<link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link>
を無効にしておかなければ<emphasis>危険</emphasis>です。
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.parameter.intl-calendar '<para xmlns="http://docbook.org/ns/docbook"><classname>IntlCalendar</classname> クラスのインスタンス。</para>'>

<!ENTITY intl.error.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">失敗時に &false; を返します。エラーを検知するには、<function>intl_get_error_code</function> を使うか、 Intl拡張モジュールが <link linkend="ini.intl.use-exceptions">例外</link> をスローするように設定して下さい。</para>'>

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">コードポイントを表す <type>int</type> 型の値 (例: <emphasis>U+2603 SNOWMAN</emphasis> を表す <literal>0x2603</literal>)、あるいは UTF-8 文字列としてエンコードされた文字 (例: <literal>"\u{2603}"</literal>)。</para>'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">戻り値の型は <type>int</type> になります。ただし、コードポイントを UTF-8 文字列で渡した場合は別で、その場合の返り値の型は文字列になります。失敗した場合は、&null; を返します。</para>'>

<!ENTITY intl.codepoint.example 'さまざまなコードポイントの例'>

<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook"><parameter>locale</parameter> の長さが <constant>INTL_MAX_LOCALE_LEN</constant> を超えた場合、&null; を返します。</para>'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">調べたい Unicode プロパティ (定数 <literal>IntlChar::PROPERTY_*</literal> を参照ください)。</para>'>

<!ENTITY intl.property.example 'さまざまなプロパティの例'>

<!-- LDAP notes -->

<!ENTITY ldap.parameter.ldap '<function xmlns="http://docbook.org/ns/docbook">ldap_connect</function> が返す <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname> クラスのインスタンス。'>

<!ENTITY ldap.parameter.result '<function xmlns="http://docbook.org/ns/docbook">ldap_list</function> や <function xmlns="http://docbook.org/ns/docbook">ldap_search</function> が返す、<classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname> クラスのインスタンス。.'>

<!ENTITY ldap.parameter.entry '<classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname> クラスのインスタンス。'>

<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  この関数は PHP 7.4.0 以降で <emphasis>推奨されなくなり</emphasis>、PHP 8.0.0 以降は <emphasis>削除されています</emphasis>。
  代替として、<function>ldap_search</function> 関数の <parameter>controls</parameter> 引数を使うべきです。
  詳細は <link linkend="ldap.controls">LDAP コントロール</link> も参照して下さい。
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>controls</parameter> は、nullable になりました。
  これより前のバージョンでは、デフォルト値が <literal>[]</literal> でした。
 </entry>
</row>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>ldap</parameter> は、<classname>LDAP\Connection</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、有効な <literal>ldap link</literal> &resource; を期待していました。
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>entry</parameter> は、
  <classname>LDAP\ResultEntry</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、有効な <literal>ldap result entry</literal> &resource; を期待していました。
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>result</parameter> は、
  <classname>LDAP\Result</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、有効な <literal>ldap result</literal> &resource; を期待していました。
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  <classname>LDAP\Result</classname>
  クラスのインスタンスを返すようになりました。
  これより前のバージョンでは、&resource; を返していました。
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  <classname>LDAP\ResultEntry</classname>
  クラスのインスタンスを返すようになりました。
  これより前のバージョンでは、&resource; を返していました。
 </entry>
</row>'>

<!ENTITY ldap.return-result '<classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname> クラスのインスタンスを返します。&return.falseforfailure;'>
<!ENTITY ldap.return-result-array '<classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname> のインスタンスか、<classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname> のインスタンスの配列を返します。&return.falseforfailure;'>

<!ENTITY ldap.return-result-array-info '<para xmlns="http://docbook.org/ns/docbook">並列検索も可能です。並列検索を行うには、単一の <classname>LDAP\Connection</classname> のインスタンスではなく、それの配列を使用します。同じベース DN を使用したくない場合や全ての検索について同じフィルタを使用したくない場合、ベース DN の配列またはフィルタの配列を使用することが可能です。これらの配列は、<classname>LDAP\Connection</classname> の配列と同じ大きさである必要があります。これは、その配列の最初が一回の検索で使用され、2 番目のエントリが他の検索で使用されるといったようになるからです。並列検索を実行する際、エラーの場合を除き、<classname>LDAP\Result</classname> の配列が返されます。エラーの場合は、返される値は &false; になります。</para>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>内部エンコーディングあるいは
<function>mb_regex_encoding</function> で指定した文字エンコーディングを、
この関数の文字エンコーディングとして使用します。</para></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>
<function>mb_regex_encoding</function> で指定した文字エンコーディングを、
この関数の文字エンコーディングとして使用します。</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook"><parameter>encoding</parameter> 
パラメータには文字エンコーディングを指定します。省略した場合、もしくは &null; の場合は、
内部文字エンコーディングを使用します。</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para>信頼できない入力に対しては、
絶対に <literal>e</literal> 修正子を使用してはいけません。
(<function>preg_replace</function> と同様、) 自動的なエスケープは行いません。
このことを忘れていると、自分の書いたアプリケーションにリモートコード実行の脆弱性を作りこんでしまうことになります。</para></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>encoding</parameter> は、nullable になりました。
 </entry>
</row>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> は、空の文字列も受け入れるようになりました。
 </entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook"><constant>MCRYPT_暗号名</constant> 定数のいずれか、
あるいはアルゴリズム名をあらわす文字列。</para>'>

<!ENTITY mcrypt.parameter.iv '<para xmlns="http://docbook.org/ns/docbook">CBC, CFB, OFB モードおよび
STREAM モードのいくつかのアルゴリズムの初期化の際に使用されます。
アルゴリズムで必要とする IV を指定しない場合、この関数は警告を発生し、
すべてのバイトを "<literal>\0</literal>" に設定した IV を使用します。</para>'>

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">CBC, CFB, OFB モードおよび
STREAM モードのいくつかのアルゴリズムの初期化の際に使用されます。
指定した IV のサイズがそのモードでサポートされていない場合、
あるいは IV を必要とするモードで IV が指定されなかった場合は、
この関数は警告を発して &false; を返します。</para>'>

<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">定数 <constant>MCRYPT_MODE_モード名</constant>、あるいは文字列
"ecb", "cbc", "cfb", "ofb", "nofb" ,"stream" のいずれか。</para>'>

<!-- MCVE notes -->

<!ENTITY mcve.conn.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>conn</parameter></term><listitem><para><function>m_initengine</function> が返す MCVE_CONN リソース。</para></listitem></varlistentry>'>

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       memcached 1.3.0 (2009年リリース) 以降は、
       この機能はサポートされなくなりました。
       ゼロでない <parameter>time</parameter> を渡すと、
       削除は失敗します。
       <methodname>Memcached::getResultCode</methodname> は
       <constant>MEMCACHED_INVALID_ARGUMENTS</constant>
       を返します。
      </simpara></note>
'>

<!ENTITY memcached.parameter.expiration '期限切れとなるまでの時間。デフォルトは 0。詳細な情報は<link xmlns="http://docbook.org/ns/docbook"
 linkend="memcached.expiration">有効期限</link> を参照ください。'>

<!ENTITY memcached.parameter.server_key '値を格納したりデータを取得したりするサーバーを表すキー。
アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。
これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。'>

<!ENTITY memcached.parameter.items 'サーバーに格納する キー/値 のペアの配列。'>

<!ENTITY memcached.parameter.key '値の格納先のキー。'>

<!ENTITY memcached.parameter.value '格納する値。'>

<!ENTITY memcached.result.getresultcode '必要に応じて <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname> を使用しましょう。'>

<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
   <parameter>keys</parameter> をキーとした配列を返します。
   それぞれの要素には、
   対応するキーが削除された場合に &true; が入ります。
   対応するキーの削除が失敗した場合、
   定数 <constant>Memcached::RES_*</constant> のうちの一つが入ります。
   </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <methodname>Memcached::getResultCode</methodname> は、
   最後に行われた削除操作の結果コードを返します。
   つまり、<parameter>keys</parameter>
   の最後の要素に対する削除操作の結果を返します。
  </para>
'>

<!-- password notes -->

<!ENTITY password.parameter.algo 'パスワードのハッシュに使うアルゴリズムを表す
<link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">パスワードアルゴリズム定数</link>。'>

<!ENTITY password.parameter.hash '<function xmlns="http://docbook.org/ns/docbook">password_hash</function> が作ったハッシュ。'>

<!ENTITY password.parameter.options 'オプションを含む連想配列。各アルゴリズムがサポートするオプションについては、
<link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">パスワードアルゴリズム定数</link>
のページを参照ください。'>

<!ENTITY password.parameter.password 'ユーザーのパスワード。'>

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>dictionary</parameter>
  は、<classname>PSpell\Dictionary</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>config</parameter>
  は、<classname>PSpell\Config</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<para xmlns="http://docbook.org/ns/docbook"><classname>PSpell\Dictionary</classname> クラスのインスタンス。</para>'>

<!ENTITY pspell.parameter.pspell-config '<para xmlns="http://docbook.org/ns/docbook"><classname>PSpell\Config</classname> クラスのインスタンス。</para>'>

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   <parameter>socket</parameter> は、<classname>Socket</classname> クラスのインスタンスになりました。
   これより前のバージョンでは、リソース型でした。
  </entry>
 </row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>address</parameter> は、<classname>AddressInfo</classname> クラスのインスタンスになりました。
  これより前のバージョンでは、リソース型でした。
 </entry>
</row>'>

<!-- geaman notes -->

<!ENTITY gearman.parameter.host 'ジョブサーバーのホスト名。'>

<!ENTITY gearman.parameter.port 'ジョブサーバーのポート番号。'>

<!ENTITY gearman.parameter.functionname 'ワーカーが実行するために登録した関数。'>

<!ENTITY gearman.parameter.workload 'シリアライズしたデータ。'>

<!ENTITY gearman.parameter.data '作業を完了させるために必要となる追加データ。'>

<!ENTITY gearman.parameter.context 'タスクに関連づけるアプリケーションコンテキスト。'>

<!ENTITY gearman.parameter.unique 'タスクを特定するために用いる一意な ID。'>

<!ENTITY gearman.parameter.jobhandle 'Gearman サーバーが割り当てたジョブハンドル。'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">サポートされるタイムゾーンのリスト</title>'>

<!ENTITY date.timezone.intro '<para xmlns="http://docbook.org/ns/docbook">
これは、PHP がサポートしているタイムゾーンの完全なリストです。例えば
<function xmlns="http://docbook.org/ns/docbook">date_default_timezone_set</function> などで使用します。
<caution><simpara>ここに挙げられていないタイムゾーンの挙動は未定義です。</simpara></caution>
</para><note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">最新バージョンのタイムゾーンデータベースは、PECL の
<link xlink:href="&url.pecl.package.get;timezonedb" xmlns:xlink="http://www.w3.org/1999/xlink">timezonedb</link>
からインストールできます。</simpara></note>'>

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">
ここに挙げられているタイムゾーン (UTC 以外のもの) は使用しないでください。
これらは過去のバージョンとの互換性のためにのみ残されているものであり、おかしな挙動を引き起こすかもしれません。
さらに、ここに挙げられているタイムゾーンは、IANA のタイムゾーンデータベースからいつ削除されてもおかしくありません。
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
 上の警告を無視する場合は、PHP のタイムゾーンサポートで使っている IANA タイムゾーンデータベースが
 POSIX スタイルの符号を使っていることに気をつけましょう。つまり、
 <literal>Etc/GMT+n</literal> や
 <literal>Etc/GMT-n</literal> といったタイムゾーンの符号が、一般的な使いかたとは逆転するのです。
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 たとえば、GMT より8時間進んでいるタイムゾーン (中国やオーストラリア西部など)
 は、このデータベースでは
 <literal>Etc/GMT-8</literal> となります。ふつうは
 <literal>Etc/GMT+8</literal> であろうと想定するでしょうが、そうではありません。
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 改めて言いますが、その場所にあわせた正確なタイムゾーンを使うことを推奨します。すなわち、先の例なら
 <literal>Asia/Shanghai</literal> や
 <literal>Australia/Perth</literal> を使うということです。
</simpara>'>

<!ENTITY date.timezone.abbrev-volatile '<simpara xmlns="http://docbook.org/ns/docbook">
これらの略称は、変化しやすいものだと考えておく必要があります。つまり、
timezonedb のリリースによって変わる可能性があるので、略称に依存するべきではありません。
タイムゾーンの略章は使わないことを強く推奨します。
</simpara>'>

<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
すべての日付/時刻関数は、
有効なタイムゾーンが設定されていない場合に <constant>E_WARNING</constant>
を発生させます。
<function>date_default_timezone_set</function> も参照ください。</para>'>

<!ENTITY date.timezone.errors.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry><para>
タイムゾーンがおかしい場合に <constant>E_STRICT</constant> や
<constant>E_NOTICE</constant> が発生するようになりました。</para></entry></row>'>

<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><para>
オプションのパラメータ <parameter>timestamp</parameter> は、
<type>int</type> 型の Unix タイムスタンプです。
<parameter>timestamp</parameter> が指定されなかったり、&null; だった場合のデフォルト値は、
現在の時刻です。言い換えると、デフォルトは
<function>time</function> の返り値となります。
</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
object</parameter></term><listitem><para>手続き型のみ: <function>date_create</function>
が返す <classname>DateTime</classname> オブジェクト</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>手続き型のみ: 
<function>date_create</function> が返す <classname>DateTime</classname> オブジェクト。
この関数は、このオブジェクトを変更します。</para></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term><listitem><para>手続き型のみ: <function>timezone_open</function> が返す <classname>DateTimeZone</classname> オブジェクト</para></listitem></varlistentry>'>

<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure
'メソッドチェインに使う、変更された <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> オブジェクトを返します。&return.falseforfailure;。'>
<!ENTITY date.datetime.return.modifiedobject 'メソッドチェインに使う、変更された <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> オブジェクトを返します。'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure
'変更されたデータを持つ、新しい <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> オブジェクトを返します。&return.falseforfailure;.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject '変更されたデータを持つ、新しい <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> オブジェクトを返します。'>

<!ENTITY date.timezone.dbversion 'このリストの元になっているのは、タイムゾーンデータベース バージョン'>

<!ENTITY date.timezone.africa 'アフリカ'>
<!ENTITY date.timezone.america 'アメリカ'>
<!ENTITY date.timezone.antarctica '南極'>
<!ENTITY date.timezone.arctic '北極'>
<!ENTITY date.timezone.asia 'アジア'>
<!ENTITY date.timezone.atlantic '大西洋'>
<!ENTITY date.timezone.australia 'オーストラリア'>
<!ENTITY date.timezone.europe 'ヨーロッパ'>
<!ENTITY date.timezone.indian 'インド'>
<!ENTITY date.timezone.pacific '太平洋'>
<!ENTITY date.timezone.others 'その他'>
<!ENTITY date.timezone.abbreviations '略称'>

<!ENTITY date.formats '有効な書式については <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">日付と時刻の書式</link> で説明しています。'>
<!ENTITY date.formats.parameter '日付/時刻 文字列。&date.formats;'>

<!-- DomXml Notes -->
<!ENTITY node.inserted 'このノードは、(たとえば) <function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>
などで挿入されない限り、ドキュメント内に現われません。'>


<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'このノードは、(
<function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function>
などで) 挿入されない限り、ドキュメント内にあらわれません。'>

<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">
壊れた HTML も読み込めますが、マークアップが正しくない場合には <constant>E_WARNING</constant> が発生します。
このエラーの処理には <link linkend="function.libxml-use-internal-errors">libxml のエラー処理関数</link>
が使えます。
</para>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>DOM拡張モジュール は UTF-8 エンコーディングを使います。他のエンコーディングを扱う場合は、<function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname>, <function>iconv</function> を使ってください。</para></note>'>
<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para><classname>DOMDocument</classname> オブジェクトに対して <function>json_encode</function> を使うと、結果は空オブジェクトをエンコードしたものになります。</para></note>'>



<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">次の例では、以下のような内容の <filename>book.xml</filename> を使います。</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<para xmlns="http://docbook.org/ns/docbook">
  <link linkend="libxml.constants">追加の Libxml パラメータ</link> を、ビット演算子の <literal>OR</literal> で指定します。
</para>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>registerNodeNS</parameter></term>
 <listitem>
  <para>
   コンテキストノードのスコープ内の名前空間を、<classname>DOMXPath</classname> オブジェクトに自動登録するかどうか。
   このオプションを使うと、スコープ内の名前空間ごとに、手動で <methodname>DOMXPath::registerNamespace</methodname> をコールする必要がなくなります。
   名前空間のプレフィックスが衝突した場合は、直近の子孫の名前空間プレフィックスのみが登録されます。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
   指定された <parameter>nodes</parameter> のうちの一つの子ノードの型を、
   親ノードが許可していない場合や、ノードが自分自身やその祖先であった場合に発生します。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
   指定された <parameter>nodes</parameter> のうちの一つの子ノードの型を、
   親ノードが許可していない場合や、ノードが自分自身やその祖先であった場合に発生します。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <para>
   指定された <parameter>nodes</parameter> のうちの一つが、
   このノードを作成したドキュメントとは異なるものから作成された場合に発生します。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'これより前のバージョンでは、エラーコード <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant> を持つ <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> がスローされていました。'>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
  <para>
   ノードをフィルタする XPath の配列。
   この配列のそれぞれのエントリは、以下の情報を持つ連想配列です:
   <itemizedlist>
    <listitem>
     <simpara>
      XPath の式の文字列を含む <literal>query</literal> キー。必須です。
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      名前空間のプレフィックス(keys) を名前空間URI (values) にマップした配列を含む <literal>namespaces</literal> キー。オプションです。
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>'>

<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
失敗したときは <constant>E_WARNING</constant> が発生します。
</para>'>

<!ENTITY fs.validfp.all '<para xmlns="http://docbook.org/ns/docbook">ファイルポインタは、有効なファイルポインタである必要があり、
<function>fopen</function> または <function>fsockopen</function> で正常にオープンされた
（そしてまだ <function>fclose</function> でクローズされていない）
ファイルを指している必要があります。</para>'>

<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook"><function>fopen</function>
を使用して作成したファイルシステムポインタリソース。</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    PHP の数値型は符号付整数であり、
    多くのプラットフォームでは 32 ビットの整数を取るため、
    ファイルシステム関数の中には
    2GB より大きなファイルについては期待とは違う値を返すものがあります。
   </simpara></note>'>

<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
    PHP 5.6.1 以降では <constant>INI_SCANNER_TYPED</constant> も指定できるようになりました。
    このモードでは、boolean や null そして integer の型を、可能な限り維持します。
    文字列 <literal>"true"</literal>、<literal>"on"</literal> そして <literal>"yes"</literal>
    は &true; に変換されます。<literal>"false"</literal>、<literal>"off"</literal>、<literal>"no"</literal>
    そして <literal>"none"</literal> は &false; だとみなされます。このモードでは、<literal>"null"</literal> は &null;
    に変換されます。また数値形式の文字列も、可能な限り integer 型に変換されます。
   </para>'>

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook"><function>gnupg_init</function>
あるいは <classname>gnupg</classname> のコールで得られた gnupg ID。</para>'>

<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">フィンガープリントキー。</para>'>

<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">エラー時に <classname>HaruException</classname> をスローします。</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">ODBC 接続 ID。詳細は
<function>odbc_connect</function> を参照ください。</para>'>

<!ENTITY odbc.parameter.catalog 'カタログ(ODBC 2 の用語では &apos;修飾子&apos;)。'>

<!ENTITY odbc.parameter.schema 'スキーマ (ODBC 2 の用語では &apos;所有者&apos;)。'>

<!ENTITY odbc.parameter.search 'このパラメータには以下の検索パターンを使用できます。
<literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> はゼロ個以上の文字にマッチし、
<literal xmlns="http://docbook.org/ns/docbook">_</literal> はひとつの文字にマッチします。'>

<!ENTITY odbc.result.driver-specific 'ドライバは追加のカラムを返すことが出来ます。'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'コールバック関数をコールできなかったり、
あるいは定義されていなかったりした場合は <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
レベルのエラーとなります。'>

<!ENTITY oauth.changelog.error.null '以前は、失敗したときに &false; ではなく &null; を返していました。'>

<!-- Oracle -->
<!ENTITY oci.db "<para xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'>
接続先の <literal>Oracle インスタンス</literal>。
<link xlink:href='&url.oracle.oic.connect;'>Easy Connect
文字列</link>、<filename>tnsnames.ora</filename>
ファイルの接続文字列、あるいはローカルの Oracle インスタンス名を指定します。
</para>
<para xmlns='http://docbook.org/ns/docbook'>省略した場合、または &null; の場合、PHP は環境変数
<constant>TWO_TASK</constant> (Linux) あるいは
<constant>LOCAL</constant> (Windows)
と <constant>ORACLE_SID</constant> を用いて接続先の
<literal>Oracle インスタンス</literal> を判断します。
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Easy Connect 方式を使うには、PHP を Oracle
10<emphasis>g</emphasis> 以降のクライアントライブラリとリンクさせる必要があります。Oracle 10<emphasis>g</emphasis> の Easy Connect
文字列の形式は
<emphasis>[//]host_name[:port][/service_name]</emphasis> です。Oracle
11<emphasis>g</emphasis> 以降の場合は、この構文は
<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>
となります。
Oracle 19c では、さらにオプションが追加されています。
タイムアウトや keep-alive の設定を含みます。詳細は Oracle のドキュメントを参照して下さい。
サービス名を調べるには、Oracle のユーティリティ
<literal>lsnrctl status</literal> をデータベースサーバー上で実行します。
</para>
<para xmlns='http://docbook.org/ns/docbook'>
<filename>tnsnames.ora</filename> ファイルは Oracle Net のサーチパス上にあります。
サーチパスに含まれるのは <filename>/your/path/to/instantclient/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>, <filename>/etc</filename> です。
もうひとつの方法として、
<literal>TNS_ADMIN</literal> を指定して
<filename>$TNS_ADMIN/tnsnames.ora</filename> を読み込ませることもできます。
ウェブデーモンにそのファイルの読み込み権限を与えておきましょう。
</para>">

<!ENTITY oci.charset "<para xmlns='http://docbook.org/ns/docbook'>
Oracle クライアントライブラリが使う文字セットを指定します。
これは、データベースが用いる文字セットと一致させる必要はありません。
一致していない場合は、Oracle
が最善を尽くしてデータベースの文字セットとの間の変換を行います。
文字セットによっては、この変換結果がうまく使えないこともあります。
また、変換にはそれなりの時間を要します。
</para>
<para xmlns='http://docbook.org/ns/docbook'>省略した場合は、
Oracle クライアントライブラリは環境変数 <constant>NLS_LANG</constant>
の値をもとに文字セットを判断します。
</para>
<para xmlns='http://docbook.org/ns/docbook'>このパラメータを渡すことで、
接続に要する時間を短縮できます。
</para>">

<!ENTITY oci.sessionmode '<para xmlns="http://docbook.org/ns/docbook">
このパラメータは PHP 5 (PECL OCI8 1.1) 以降で使え、
<constant>OCI_DEFAULT</constant>、
<constant>OCI_SYSOPER</constant> そして <constant>OCI_SYSDBA</constant>
といった値を指定することができます。<constant>OCI_SYSOPER</constant> あるいは
<constant>OCI_SYSDBA</constant> を指定した場合は、
この関数は外部の証明書を使った特権接続の確立を試みます。
特権接続は、デフォルトでは無効になっています。有効にするには
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
を <literal>On</literal> に設定しなければなりません。
</para>
<para xmlns="http://docbook.org/ns/docbook">
PHP 5.3 (PECL OCI8 1.3.4) 以降、
<constant>OCI_CRED_EXT</constant> モードを使えるようになりました。
これは、Oracle に外部認証あるいは OS 認証を使うよう指示します。
どちらかをデータベースで設定しておかなければなりません。
<constant>OCI_CRED_EXT</constant> フラグを使えるのは、ユーザー名が
&quot;/&quot; でパスワードが空のときだけです。
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
は <literal>On</literal> あるいは <literal>Off</literal> のどちらでもかまいません。
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> は、
<constant>OCI_SYSOPER</constant> あるいは
<constant>OCI_SYSDBA</constant> モードと組み合わせて使います。
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> は、セキュリティ上の理由により
Windows ではサポートされていません。
</para>'>

<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">OCI8 拡張モジュールによるデータ型マッピングの
詳細については、<link linkend="oci8.datatypes">ドライバが
サポートするデータ型</link> を参照ください。</para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">
<function>oci_connect</function>、<function>oci_pconnect</function>
あるいは <function>oci_new_connect</function> が返す Oracle 接続 ID。</para>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Oracle のバージョン</title>
<para>この関数が使えるのは、PHP をバージョン 10<emphasis>g</emphasis> 以降の
Oracle データベースライブラリとリンクさせた場合だけです。</para></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>パフォーマンス</title><para>
古いバージョンの OCI8 や Oracle データベースでは、クライアントの情報を Oracle の
<literal>DBMS_APPLICATION_INFO</literal> パッケージで設定することができました。
それよりも <function>oci_set_client_info</function> を使うほうが効率的です。</para></tip>'>

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>データベースとのやりとりに関するメモ</title>
<para>OCI8 関数の中には、データベースとのやりとりを伴わないものもあります。
たとえば、結果のキャッシングが有効になっている場合、
クエリを実行してもデータベースとのやりとりを行わない可能性があります。
</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">
大量の行を返すクエリの場合、
<link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
を増やすか
<function>oci_set_prefetch</function> を使えばパフォーマンスが劇的に向上します。
</para>'>


<!ENTITY oci.arg.statement.id
"<para xmlns='http://docbook.org/ns/docbook'>
<function>oci_parse</function> で作成して
<function>oci_execute</function> で実行した有効な OCI8 ステートメント ID、
あるいは <literal>REF
CURSOR</literal> ステートメント ID。</para>">

<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<para xmlns="http://docbook.org/ns/docbook">パラメータ <parameter>status</parameter> は、
<function>pcntl_waitpid</function> が正常にコールされた際に得られます。</para>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">注釈は、
ドキュメントを印刷したり表示したりするときには表示されません。
しかし、Acrobat Distiller? あるいは Ghostview
でドキュメントを pdf に変換すると表示されます。</para>'>

<!-- Notes for safe-mode limited functions: -->

<!-- Not used in EN anymore -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara>&sm.disabled;</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck '<note xmlns="http://docbook.org/ns/docbook"><simpara><link linkend="features.safe-mode">
セーフモード</link> が有効の場合、PHP は操作を行うファイル／ディレクトリが実行するスクリプトと
同じ UID (所有者)を有しているかどうかを確認します。</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck.dir '<note xmlns="http://docbook.org/ns/docbook"><simpara> <link
linkend="features.safe-mode">セーフモード</link> が有効の場合、PHP は、
操作を行うディレクトリが、実行するスクリプトと同じ UID (所有者)を有しているか
どうかを確認します。</simpara></note>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para>この関数の動作は、<link
linkend="ini.open-basedir">open_basedir</link> の設定に依存します。</para></note>'>

<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara>これは、関数ではなく
言語構造のため、<link linkend="functions.variable-functions">可変関数</link> や <link linkend="functions.named-arguments">名前付き引数</link> を用いてコールすることはできません。</simpara></note>'>

<!-- Common pieces in features/safe-mode.xml
     Jade doesn't allow in-line entities, so I put them here... Though they
     should have been inline in safe-mode.xml -->

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck '処理を行うファイル/ディレクトリが実行するスクリプトと
同じUIDを有しているかどうかを確認します。'>

<!-- Not used in EN anymore -->
<!ENTITY warn.sm.exec '<warning xmlns="http://docbook.org/ns/docbook"><simpara><link linkend="features.safe-mode">
セーフモード</link>が有効な場合、コマンド文字列は
<function>escapeshellcmd</function> でエスケープされます。
つまり、<literal>echo y | echo x</literal> は、<literal>echo y \| echo x</literal>
となります。</simpara></warning>'>

<!-- Not used in EN anymore -->
<!ENTITY note.exec-path '<note xmlns="http://docbook.org/ns/docbook"><simpara><link linkend="features.safe-mode">
セーフモード</link> が有効な場合、<link linkend="ini.safe-mode-exec-dir">
safe_mode_exec_dir</link>の中にある実行プログラムのみ実行可能です。
実際的な理由により、現在、実行プログラムへのパスに <literal>..</literal>を
含めることはできません。</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck.dir '処理を行うディレクトリが実行するスクリプトと同じ UID
を有しているかどうかを確認します。'>

<!-- Not used in EN anymore -->
<!ENTITY sm.disabled 'この関数は、PHP が <link xmlns="http://docbook.org/ns/docbook"
linkend="features.safe-mode">safe-mode</link> で動作している場合は無効となります。'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">設定ディレクティブは定義されていません。</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">リソース型は定義されていません。</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">定数は定義されていません。</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">外部ライブラリは必要ありません。</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">PHP コアに含まれるため、
追加のインストール無しで使用できます。</para>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<para xmlns="http://docbook.org/ns/docbook">以下に設定ディレクティブに関する
簡単な説明を示します。</para>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">
&php.ini; の設定により動作が変化します。
</simpara>'>

<!ENTITY ini.php.constants 'INI_* モードの詳細および定義については
<xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/> を参照してください。'>

<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara xmlns="http://docbook.org/ns/docbook">
以下の定数が定義されています。
この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、
実行時に動的にロードされている場合のみ使用可能です。
</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">
以下の定数は、PHP コアに含まれており、常に利用可能です。
</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara xmlns="http://docbook.org/ns/docbook">
以下のクラスが定義されています。この拡張モジュールが
PHP 組み込みでコンパイルされているか、実行時に動的にロードされている場合のみ
使用可能です。
</simpara>'>

<!ENTITY note.extension.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>
PHP 5 が必要です。</simpara></note>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">このドライバでは以下の定数が定義されて
います。これは拡張モジュールが PHP に組み込まれているか、実行時に動的にロード
されている場合のみ使用可能です。さらに、これらのドライバ固有の定数は
そのドライバを使用している場合にのみ使用されます。
あるドライバ固有の属性を別のドライバで使うと、予期せぬ結果を引き起こします。
もし複数のドライバを使用しているコードを実行している場合、
<function>PDO::getAttribute</function> で <constant>PDO::ATTR_DRIVER_NAME</constant>
属性を使用することで、使用中のドライバ名を調べることが可能です。</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>例外は、<constant>PDO::ATTR_ERRMODE</constant> 属性が <constant>PDO::ERRMODE_EXCEPTION</constant> ではない場合でも発生します。</simpara></note>'>

<!-- PDO errors -->

<!ENTITY pdo.errors '<para xmlns="http://docbook.org/ns/docbook">
<constant>PDO::ATTR_ERRMODE</constant> が <constant>PDO::ERRMODE_WARNING</constant> に設定されていた場合、<constant>E_WARNING</constant> レベルのエラーが発生します。
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>PDO::ATTR_ERRMODE</constant> が <constant>PDO::ERRMODE_EXCEPTION</constant> に設定されていた場合、<classname>PDOException</classname> がスローされます。
</para>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'この &link.pecl; 拡張モジュールは PHP にバンドルされていません。'>

<!ENTITY pecl.bundled 'この &link.pecl; 拡張モジュールは PHP にバンドルされています。'>

<!ENTITY pecl.info 'この PECL 拡張モジュールをインストールする方法は、
マニュアルの <link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">
PECL 拡張モジュールのインストール</link> という章にあります。
新規リリース・ダウンロード・ソースファイル・管理者情報・CHANGELOG
といった関連する情報については、次の場所にあります。'>

<!ENTITY pecl.info.dead 'この拡張モジュールは、メンテナンスされておらず開発が止まっています。
しかし、ソースコードは <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> 
<acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym> から取得できます。'>

<!ENTITY pecl.info.dead.git 'この拡張モジュールは、メンテナンスされておらず開発が止まっています。
しかし、ソースコードは <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym> から取得できます。'>

<!ENTITY pecl.windows.download 'この <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
拡張モジュールの <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> は、現在存在しません。
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">Windows でのビルド</link>
も参照ください'>

<!ENTITY pecl.windows.download.avail 'この <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
拡張モジュールの Windows バイナリ (<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> ファイル)
は、PECL のウェブサイトから取得できます。'>

<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver '
この拡張モジュールは &link.pecl; レポジトリに移動
されており、以下のバージョン以降 PHP にバンドルされなくなっています。 PHP '>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook"><classname>PgSql\Connection</classname> クラスのインスタンス。</para>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook"><classname>PgSql\Connection</classname> クラスのインスタンス。
<parameter>connection</parameter> が指定されない場合は、デフォルトの接続を使います。
デフォルトの接続とは、<function>pg_connect</function> または <function>pg_pconnect</function> によって確立された直近の接続です。
<warning><simpara>PHP 8.1.0 以降では、デフォルトの接続を使うことは推奨されなくなりました。</simpara></warning></para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook"><classname>PgSql\Connection</classname> クラスのインスタンス。
<parameter>connection</parameter> が &null;, の場合、デフォルトの接続を使います。
デフォルトの接続とは、<function>pg_connect</function> または <function>pg_pconnect</function> によって確立された直近の接続です。
<warning><simpara>PHP 8.1.0 以降では、デフォルトの接続を使うことは推奨されなくなりました。</simpara></warning></para>'>

<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook"><function>pg_query</function>、<function>pg_query_params</function> や (様々な関数がありますが、特に) <function>pg_execute</function> が返した <classname>PgSql\Result</classname> クラスのインスタンス。</para>'>

<!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook"><function>pg_lo_open</function> が返した <classname>PgSql\Lob</classname> クラスのインスタンス。</para>'>

<!ENTITY pgsql.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">
返される配列のインデックスを制御するオプションの引数です。
<parameter>mode</parameter> は定数で、以下の値を取ることができます。:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant>, <constant>PGSQL_BOTH</constant>。
<constant>PGSQL_NUM</constant> を使うと、配列のインデックスを数値にした配列を返します。<constant>PGSQL_ASSOC</constant> を使うと、連想配列のインデックスを返します。<constant>PGSQL_BOTH</constant> を指定すると、数値と連想配列のインデックスを両方含めた形で配列を返します。</para>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  <parameter>connection</parameter> は、<classname>PgSql\Connection</classname> クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  <parameter>result</parameter> は、<classname>PgSql\Result</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  <parameter>lob</parameter> は、<classname>PgSql\Lob</classname>
  クラスのインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  <classname>PgSql\Result</classname> クラスのインスタンスを返すようになりました。
  これより前のバージョンでは、&resource; を返していました。
 </entry>
</row>'>

<!-- Common pieces for reference part END -->

<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">Windows 版の <literal>PHP</literal> には
この拡張モジュールのサポートが組み込まれています。これらの関数を使用
するために拡張モジュールを追加でロードする必要はありません。</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.safe-mode">セーフモード</link>'>

<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">SQL セーフモード</link>'>

<!-- APD Notes -->
<!ENTITY apd.debug-level.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>debug_level</parameter></term><listitem>
<para><literal>XXX_TRACE</literal> 定数の組み合わせによる整数値。</para>
<para><constant>MEMORY_TRACE</constant> を用いることは推奨しません。
これは非常に低速で、またあまり正確ではないようだからです。
<constant>ASSIGNMENT_TRACE</constant> は、まだ実装されていません。</para>
<para>すべての機能 (TIMING, FUNCTIONS, ARGS SUMMARY (strace -c のようなもの))
のトレースを有効にするには、値 99 を指定します。</para>
</listitem></varlistentry>'>

<!-- BCMath Notes -->
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>scale</parameter></term><listitem>
<para>このオプションパラメータを使用して、結果の小数点以下の桁数を指定します。省略した場合は、<function>bcscale</function> 関数でグローバルに設定した桁数をデフォルトとして使用します。それも設定されていない場合は <literal>0</literal> を使用します。</para></listitem></varlistentry>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
-128 から 255 までの <type>int</type> を渡すと、ひとつの文字の ASCII 値とみなします
(負の値には 256 を足して、拡張 ASCII の範囲に収まるようにします)。
それ以外の整数値は、10 進数を含む文字列とみなします。</para></note>'>

<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><para>
PHP 8.1.0 以降は、ctype関数 に文字列でない引数を渡すことは、推奨されなくなりました。将来のバージョンでは、引数は ASCII コードポイントではなく、文字列として解釈されるようになります。ユーザが意図する振る舞いによっては、引数を文字列にキャストするか、 <function>chr</function> を明示的にコールすべきです。</para></warning>'>

<!ENTITY ctype.result.empty-string '空文字列を渡して呼び出した場合、結果は常に &false; になります。'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  引数 <parameter>ftp</parameter> は、<classname>FTP\Connection</classname>
  のインスタンスを期待するようになりました。
  これより前のバージョンでは、&resource; を期待していました。
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<para xmlns="http://docbook.org/ns/docbook"><classname>FTP\Connection</classname> クラスのインスタンス</para>'>

<!-- GMP Notes -->
<!ENTITY gmp.return '<classname xmlns="http://docbook.org/ns/docbook">GMP</classname> オブジェクトを返します。'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook"><classname>GMP</classname> オブジェクト、整数、あるいは数値に変換可能な数値形式の文字列。</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>result</parameter></term><listitem>
<para>手続き型のみ: <function>mysqli_query</function>、<function>mysqli_store_result</function>、<function>mysqli_use_result</function>、<function>mysqli_stmt_get_result</function> が返す <classname>mysqli_result</classname> オブジェクト。</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link</parameter></term><listitem><para>手続き型のみ:
<function>mysqli_connect</function> あるいは <function>mysqli_init</function> が返す <classname>mysqli</classname>オブジェクト。
</para></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>stmt</parameter></term><listitem><para>手続き型のみ:
<function>mysqli_stmt_init</function> が返す <classname>mysqli_stmt</classname> オブジェクト。</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd '<link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link> でのみ使用可能です。'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd は常に、サーバーのデフォルト文字セットを想定しています。この文字セットは接続時の
ハンドシェイク/認証 のときに送信され、これを mysqlnd が使います。</para>
<para>Libmysqlclient が使うデフォルトの文字セットは <filename>my.cnf</filename>
で設定したものです。あるいは明示的に <function>mysqli_options</function> をコールして設定することもできます。
これは、<function>mysqli_init</function> のあとで <function>mysqli_real_connect</function>
を実行する前にコールします。</para></note>'>
<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook">
<para>行数が <constant>PHP_INT_MAX</constant> より大きい場合、
行数の数値は文字列で返されます。</para></note>'>
<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
<title>セキュリティ上の注意: SQLインジェクション</title><para>クエリに入力値を含める場合は、<link linkend="mysqli.quickstart.prepared-statements">プリペアドステートメント</link> を使うべきです。使わない場合、データを適切にフォーマットし、全ての文字列は <function>mysqli_real_escape_string</function> を使ってエスケープしなければいけません。</para></warning>'>
<!ENTITY mysqli.conditionalexception '<para xmlns="http://docbook.org/ns/docbook">
mysqli のエラー報告 (<constant>MYSQLI_REPORT_ERROR</constant>) が有効になっており、かつ要求された操作が失敗した場合は、警告が発生します。さらに、エラー報告のモードが <constant>MYSQLI_REPORT_STRICT</constant> に設定されていた場合は、<classname>mysqli_sql_exception</classname> が代わりにスローされます。</para>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
渡された正規表現のパターンがコンパイルできない場合、<constant>E_WARNING</constant> が発生します。
</para>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">この関数は、
PHP が apache モジュールとしてインストールされた場合のみサポートされます。</simpara>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro '<para xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager) は、PHP における FastCGI 実装です。(主に)高負荷のサイトで有用な機能が含まれています。
</para>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>
SimpleXML では、ほとんどのメソッドに反復処理を追加するための手順が定義されています。
これらは、<function>var_dump</function> やオブジェクトを評価する他の手段で
見ることはできません。</simpara></note>'>

<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold '<para xmlns="http://docbook.org/ns/docbook">
<constant>SQLITE_ASSOC</constant> および <constant>SQLITE_BOTH</constant> で
返されるカラム名は、設定オプション
<link linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link> の値に基づき、
大文字小文字が変換されます。</para>'>

<!ENTITY sqlite.decode-bin '<para xmlns="http://docbook.org/ns/docbook">
<parameter>decode_binary</parameter> パラメータが &true; (デフォルト)に
設定された場合、PHP はバイナリエンコーディングをデコードします。
これは、<function>sqlite_escape_string</function> によりエンコードされたデータに
適用されます。sqlite をサポートする他のアプリケーションにより
作成されたデータベースを処理する時以外は、この値をデフォルトのままにしておくべきです。</para>'>

<!ENTITY sqlite.no-unbuffered '<note xmlns="http://docbook.org/ns/docbook"><para>この関数は、
バッファなしの結果ハンドルで使用することはできません。</para></note>'>

<!ENTITY sqlite.param-compat '<note xmlns="http://docbook.org/ns/docbook"><simpara>
(MySQL のような)他のデータベース拡張モジュールとの互換性のため、
2 種類の構文がサポートされています。
推奨されるのは最初の構文で、<parameter>dbhandle</parameter> パラメータを
関数の最初のパラメータとするものです。</simpara></note>'>

<!ENTITY sqlite.result-type '<para xmlns="http://docbook.org/ns/docbook">オプションの <parameter>result_type</parameter>
パラメータには定数を指定でき、返される配列の添字を定義します。
<constant>SQLITE_ASSOC</constant> を用いると、連想配列の添字(名前フィールド)のみが
返されます。一方、<constant>SQLITE_NUM</constant> は、
数値の添字(フィールド番号)のみを返します。<constant>SQLITE_BOTH</constant> は、
連想配列の添字と数値の添字の両方を返します。
<constant>SQLITE_BOTH</constant> がこの関数のデフォルトです。</para>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数により返されるフィー
ルド名は <emphasis>大文字小文字を区別</emphasis> します。</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、
NULL フィールドに PHPの &null; 値を設定します。</simpara></note>'>

<!-- MSQL Notes -->
<!-- The msql.*.description entities are used in the parameters refsect1 -->
<!ENTITY msql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link_identifier</parameter></term><listitem><para>mSQL 接続。指定されない場合、<function>msql_connect</function> により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、この関数は、<function>msql_connect</function>をコールした時と同様にリンクを確立し、使用します。</para></listitem></varlistentry>'>

<!ENTITY msql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>result</parameter></term><listitem><para>評価された結果 <type>リソース</type>。この結果は、<function>msql_query</function> のコールにより得られたものです。</para></listitem></varlistentry>'>

<!ENTITY msql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>field_offset</parameter></term><listitem><para>数値フィールドオフセット。<parameter>field_offset</parameter> は、<literal>1</literal>から始まります。</para></listitem></varlistentry>'>

<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link_identifier</parameter></term><listitem><para>MySQL 接続。指定されない場合、<function>mysql_connect</function> により直近にオープンされたリンクが指定されたと仮定されます。そのようなリンクがない場合、引数を指定せずに <function>mysql_connect</function> がコールした時と同様にリンクを確立します。リンクが見付からない、または、確立できない場合、<constant>E_WARNING</constant> レベルのエラーが生成されます。</para></listitem></varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link_identifier</parameter></term><listitem><para>MySQL 接続。指定されない場合、<function>mysql_connect</function> により直近にオープンされたリンクが指定されたと仮定されます。接続が見つからない、または、確立できない場合、<constant>E_WARNING</constant> レベルのエラーが生成されます。</para></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>result</parameter></term><listitem><para>評価された結果 <type>リソース</type>。この結果は、<function>mysql_query</function> のコールにより得られたものです。</para></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>field_offset</parameter></term><listitem><para>数値フィールドオフセット。<parameter>field_offset</parameter> は <literal>0</literal> から始まります。<parameter>field_offset</parameter> が存在しない場合、<constant>E_WARNING</constant> レベルのエラーが発行されます。</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">
この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。
<link linkend="book.mysqli">MySQLi</link> あるいは
<link linkend="ref.pdo-mysql">PDO_MySQL</link> を使うべきです。詳細な情報は
<link linkend="mysqlinfo.api.choosing">MySQL: API の選択</link> を参照ください。
この関数の代替として、これらが使えます。</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">
この関数は PHP 4.3.0 で非推奨になり、PHP 7.0.0 で
<link linkend="book.mysql">MySQL 拡張モジュール</link> 全体とあわせて削除されました。
<link linkend="book.mysqli">MySQLi</link> あるいは
<link linkend="ref.pdo-mysql">PDO_MySQL</link> を使うべきです。詳細な情報は
<link linkend="mysqlinfo.api.choosing">MySQL: API の選択</link> を参照ください。
この関数の代替として、これらが使えます。</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">
この関数は PHP 5.3.0 で非推奨になり、PHP 7.0.0 で
<link linkend="book.mysql">MySQL 拡張モジュール</link> 全体とあわせて削除されました。
<link linkend="book.mysqli">MySQLi</link> あるいは
<link linkend="ref.pdo-mysql">PDO_MySQL</link> を使うべきです。詳細な情報は
<link linkend="mysqlinfo.api.choosing">MySQL: API の選択</link> を参照ください。
この関数の代替として、これらが使えます。</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">
この関数は PHP 5.4.0 で非推奨になり、PHP 7.0.0 で
<link linkend="book.mysql">MySQL 拡張モジュール</link> 全体とあわせて削除されました。
<link linkend="book.mysqli">MySQLi</link> あるいは
<link linkend="ref.pdo-mysql">PDO_MySQL</link> を使うべきです。詳細な情報は
<link linkend="mysqlinfo.api.choosing">MySQL: API の選択</link> を参照ください。
この関数の代替として、これらが使えます。</para>'>

<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">
この関数は PHP 5.5.0 で非推奨になり、PHP 7.0.0 で
<link linkend="book.mysql">MySQL 拡張モジュール</link> 全体とあわせて削除されました。
<link linkend="book.mysqli">MySQLi</link> あるいは
<link linkend="ref.pdo-mysql">PDO_MySQL</link> を使うべきです。詳細な情報は
<link linkend="mysqlinfo.api.choosing">MySQL: API の選択</link> を参照ください。
この関数の代替として、これらが使えます。</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
持続的でない MySQL 接続や結果セットは、PHP スクリプトの実行が終了する時点で自動的に破棄されます。
そのため、オープンした接続をクローズしたり結果セットを開放したりすることは必須ではありませんが、
そうしておくことを推奨します。
その時点ですぐに PHP や MySQL にリソースを返せ、パフォーマンスの向上につながるからです。
関連する除法は
<link linkend="language.types.resource.self-destruct">リソースの開放</link>を参照ください。</para>'>

<!-- Sybase Notes -->
<!ENTITY sybase.ct.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、Sybase の CT
ライブラリインターフェイスでのみ使用可能で、DB ライブラリでは使用できません。
</simpara></note>'>

<!ENTITY sybase.db.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>
この関数は、Sybase の DB ライブラリインターフェイスを使用する場合のみ利用可能で、
CT ライブラリでは利用できません。</simpara></note>'>

<!ENTITY sybase.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link_identifier</parameter></term><listitem><para>Sybase 接続。
このリンク ID が指定されない場合、<function>sybase_connect</function> により
オープンされた直近のリンクが指定されたと仮定されます。
そのようなリンクが見つからない場合、<function>sybase_connect</function>
が引数なしでコールされた時と同様にリンクが作成されます。接続が見付かたなかったり、確立できない場合、<constant>E_WARNING</constant> レベルのエラーを発行します。</para></listitem></varlistentry>'>

<!-- CPDF Notes -->
<!ENTITY cpdf.ul '<para xmlns="http://docbook.org/ns/docbook">オプションのパラメータ
<parameter>mode</parameter> は単位長さを定義します。この値が <literal>0</literal>
または値が省略された場合、このページで指定されたデフォルト値が使用されます。
それ以外の場合、現在の単位を無視して
ポストスクリプトのポイントで座標が計測されます。</para>'>

<!ENTITY cpdf.mode.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>mode</parameter></term><listitem><para>オプションのパラメータ <parameter>mode</parameter>は単位長さを定義します。この値が <literal>0</literal> または値が省略された場合、このページで指定されたデフォルト値が使用されます。それ以外の場合、現在の単位を無視してポストスクリプトのポイントで座標が計測されます。</para></listitem></varlistentry>'>

<!ENTITY cpdf.pdf-document.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>pdf_document</parameter></term><listitem><para><function>cpdf_open</function> が返す、ドキュメントのハンドル。</para></listitem></varlistentry>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">拡張属性には二種類の異なる名前空間、つまり、ユーザーとルートがあります。
ユーザー名前空間は、すべてのユーザーで利用可能ですが、ルート名前空間は、ルート権限を有するユーザーのみ利用可能です。
xattr はデフォルトでユーザー名前空間で処理を行いますが、 <parameter>flags</parameter>
引数によりこれを変更することができます。</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara>数値で IPv6 アドレスを指定するときは、
(例 <literal>fe80::1</literal>) アドレスを角カッコでくくらなくてはなりません。たとえば、
<literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!ENTITY ipv6.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>IPv6 サポートは <literal>PHP 5.0.0
</literal> で追加されました。</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY tidy.object '<classname xmlns="http://docbook.org/ns/docbook">Tidy</classname> オブジェクト。'>

<!ENTITY tidy.conf-enc '<para xmlns="http://docbook.org/ns/docbook"><parameter>config</parameter>パラメータは、配列または
文字列として指定することができます。文字列として指定した場合には設定ファイルの名前として解釈され、
そうでない場合はオプション自体として解釈されます。各オプションに関する説明については、
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link> を参照してください。</para><para>
<parameter>encoding</parameter> パラメータは、文書を入力/出力する際のエンコーディングを
設定します。<parameter>encoding</parameter> には次の値を使用可能です。
<literal>ascii</literal>, <literal>latin0</literal>, <literal>latin1</literal>,
<literal>raw</literal>, <literal>utf8</literal>, <literal>iso2022</literal>,
<literal>mac</literal>, <literal>win1252</literal>, <literal>ibm858</literal>,
<literal>utf16</literal>, <literal>utf16le</literal>,
<literal>utf16be</literal>, <literal>big5</literal> および
<literal>shiftjis</literal>.</para>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>
Apache2 の MPM マルチスレッドモードを実運用環境で使用することは推奨されません。
代わりに prefork MPM を使ってください。これは Apache 2.0 および 2.2
におけるデフォルトの MPM です。prefork MPM を使う理由については、
<link linkend="faq.installation.apache2">マルチスレッド版 MPM の Apache2</link>の
FAQ エントリを参照してください。</para></warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Windows 上で
Apache 設定ファイルにパスの値を追加する際、例えば
<filename>c:\directory\file.ext</filename> に含まれるすべてのバックスラッシュは
<filename>c:/directory/file.ext</filename> のように前向きスラッシュに変換する必要があります。
また、ディレクトリを表す際には最後にスラッシュをつけなければなりません。
</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors '著者と貢献者'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook">
我々は、現在最も活動的な人々をこのマニュアルの先頭に掲げています。
しかし、他にも多くの我々の活動を支援してくれる人がおり、
また、過去にこのプロジェクトを支援してくれた人がいます。
マニュアルのユーザー注記により支援してくれた名前がわからない人々がいますが、
彼らの支援は非常に有益です。以下に掲げたリストはアルファベット順です。</para>'>

<!ENTITY Credit.Authors.and.Editors '著者と編集者'>

<!ENTITY Credit.Past.Authors.Text '以下の方々は本マニュアルに
ついてコンテンツを提供したことで大きな貢献をしています。'>

<!ENTITY Credit.Past.Editors.Text '
以下の方々は本マニュアルについて多くの編集作業を行ったことで大きな貢献を
しています。'>

<!ENTITY Credit.Note.Editors.Title 'ユーザー注記の管理者'>

<!ENTITY Credit.Note.Editors.Active '現在最もアクティブな管理者。'>

<!ENTITY Credit.Note.Editors.Inactive '
以下の方々もユーザー注記の管理に注力してくれました。'>

<!ENTITY listendand ' そして'>

<!-- classkit and runkit entities -->
<!ENTITY note.classkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数により現在実行中
(もしくはチェーンド)のメソッドを操作することはできません。</simpara>
</note>'>

<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、
現在実行中(もしくはチェーンド)のメソッドを操作することはできません。</simpara>
</note>'>

<!ENTITY note.runkit.sandbox '<note xmlns="http://docbook.org/ns/docbook"><simpara>
サンドボックスのサポート
(<function>runkit_lint</function>, <function>runkit_lint_file</function>,
および <classname>Runkit_Sandbox</classname> クラスで使用)は、
PHP 5.1.0 以降または特別なパッチを適用した
PHP 5.0 でのみ利用可能であり、スレッドセーフを有効にしておく必要があります。
詳細については、runkit パッケージに含まれる <filename>README</filename>
ファイルを参照してください。</simpara></note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>デフォルトでは、
削除・リネーム・変更が可能なのはユーザー定義関数だけです。組み込み関数を
オーバーライドするには、&php.ini; で
<literal>runkit.internal_override</literal> を有効にする必要があります。
</simpara></note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara>
この公開鍵サブシステムは、クライアントが認証 <emphasis>済</emphasis> の
公開鍵をサーバー上で管理するために使用されます。
公開鍵認証によりリモートシステムで認証を行うには、かわりに
<function>ssh2_auth_pubkey_file</function> 関数を使用してください。</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval '返り値 (通常は、&true; が成功そして &false; が失敗を表します)。この値は PHP で内部的に処理されるものであることに注意しましょう。'>

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term>
  <parameter>writer</parameter>
 </term>
 <listitem>
  <para>
   手続き型のコールでのみ使用します。
   変更される <classname>XMLWriter</classname> のインスタンスです。
   このインスタンスは、<function>xmlwriter_open_uri</function>
   あるいは <function>xmlwriter_open_memory</function>
   を呼び出すことで取得したものです。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  引数 <parameter>writer</parameter> は、<classname>XMLWriter</classname>
  のインスタンスを期待するようになりました。
  これより前のバージョンでは、リソースが期待されていました。
 </entry>
</row>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only '<note xmlns="http://docbook.org/ns/docbook"><para>この関数は WSDL モードでのみ動作します。</para></note>'>

<!-- Stomp notes -->
<!ENTITY stomp.param.link "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>link</parameter></term><listitem><para>手続き型のみ: <function>stomp_connect</function> が返す stomp リンク ID。</para></listitem></varlistentry>">
<!ENTITY stomp.param.headers "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>headers</parameter></term><listitem><para>追加のヘッダ (例: receipt) を含む連想配列。</para></listitem></varlistentry>">
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><para>トランザクションヘッダを指定し、そのメッセージがトランザクションの一部であることを示します。</para></note>">
<!ENTITY stomp.note.sync "<tip xmlns='http://docbook.org/ns/docbook'><simpara>Stomp は本来非同期です。同期通信を実装するには receipt ヘッダを追加します。これを追加すると、サーバーがメッセージを受領するかタイムアウトに達するまではメソッドが何も返さないようになります。</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath '<note xmlns="http://docbook.org/ns/docbook"><simpara>相対パスは、PHP バイナリが存在するディレクトリを基準として解決されます。呼び出しもとのスクリプトの作業ディレクトリを基準とするには、<function>realpath</function> あるいは dirname(__FILE__) を使用してください。</simpara></note>'>
<!ENTITY svn.referto.status 'とりうる値については <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">状態に関する定数</link> を参照ください。'>
<!ENTITY svn.referto.type 'とりうる値については <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">型に関する定数</link> を参照ください。'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<para xmlns="http://docbook.org/ns/docbook">ニューラルネットワークリソース。</para>'>
<!ENTITY fann.train.description '<para xmlns="http://docbook.org/ns/docbook">ニューラルネットワークトレーニングリソース。</para>'>
<!ENTITY fann.errdat.description '<para xmlns="http://docbook.org/ns/docbook">ニューラルネットワークリソースあるいはニューラルネットワークトレーニングリソース。</para>'>
<!ENTITY fann.return.void '<para xmlns="http://docbook.org/ns/docbook">値を返しません。</para>'>
<!ENTITY fann.return.bool '<para xmlns="http://docbook.org/ns/docbook">成功した場合に &true;、それ以外の場合に &false; を返します。</para>'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook">成功した場合にニューラルネットワークリソース、エラー時に &false; を返します。</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook">成功した場合にニューラルネットワークトレーニングリソース、エラー時に &false; を返します。</para>'>
<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>この関数は、fann拡張モジュールが libfann &gt; 2.2 以上でビルドされている場合にだけ利用可能です。</para></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success '成功した場合に &true; を返します。'>
<!ENTITY imagick.imagick.throws 'エラー時に ImagickException をスローします。'>
<!ENTITY imagick.imagickdraw.throws 'エラー時に ImagickDrawException をスローします。'>
<!ENTITY imagick.imagickpixel.throws 'エラー時に ImagickPixelException をスローします。'>
<!ENTITY imagick.imagickpixeliterator.throws 'エラー時に ImagickPixelIteratorException をスローします。'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'このメソッドは、ImageMagick バージョン 6.2.9 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x631 'このメソッドは、ImageMagick バージョン 6.3.1 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x632 'このメソッドは、ImageMagick バージョン 6.3.2 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x636 'このメソッドは、ImageMagick バージョン 6.3.6 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x637 'このメソッドは、ImageMagick バージョン 6.3.7 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x638 'このメソッドは、ImageMagick バージョン 6.3.8 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x639 'このメソッドは、ImageMagick バージョン 6.3.9 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x640 'このメソッドは、ImageMagick バージョン 6.4.0 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x641 'このメソッドは、ImageMagick バージョン 6.4.1 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x642 'このメソッドは、ImageMagick バージョン 6.4.2 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x643 'このメソッドは、ImageMagick バージョン 6.4.3 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x644 'このメソッドは、ImageMagick バージョン 6.4.4 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x645 'このメソッドは、ImageMagick バージョン 6.4.5 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x647 'このメソッドは、ImageMagick バージョン 6.4.7 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x649 'このメソッドは、ImageMagick バージョン 6.4.9 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x653 'このメソッドは、ImageMagick バージョン 6.5.3 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.available.0x657 'このメソッドは、ImageMagick バージョン 6.5.7 以降で Imagick をコンパイルした場合に使用可能です。'>
<!ENTITY imagick.method.not.available.0x700 'このメソッドは、ImageMagick バージョン 7.0.0 以降で Imagick をコンパイルした場合には利用できません。'>

<!ENTITY imagick.constant.available 'この定数は、Imagick のコンパイルを次のバージョンの ImageMagick で 
行った場合に使用可能です。'>

<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>この関数は Imagick 3.4.4 以降では <emphasis>非推奨</emphasis> になりました。この関数に依存したコードを書くのはやめましょう。</simpara></warning>'>

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'デフォルトは <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant> です。
<link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">チャネル定数</link> の一覧を参照ください。'>

<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz 'あいまいさをあらわす量。たとえば、これを 10 に設定すると、
赤色の値が 100 の色と 102 の色は同じものとみなされます。'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'そのモードで有効なチャネル定数を指定します。
複数のチャネルを適用するには、<link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">チャネル定数</link>
をビット演算子で組み合わせます。&imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha '透明度。1.0 は完全な不透明で 0.0 が完全な透明をあらわします。'>

<!ENTITY imagick.imagickexception.throw 'エラー時に
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> をスローします。'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  パラメータ <parameter>bestfit</parameter> の挙動は Imagick 3.0.0 で変わりました。
  これより前のバージョンでは、200x150 の画像に対して
  400x400 を指定した場合は何もせずそのままになっていました。
  Imagick 3.0.0 以降では、この画像は 400x300 に拡大されます。これが、
  指定したサイズに対して「ベストフィット」する大きさだからです。
  <parameter>bestfit</parameter> を使う場合は、幅と高さの両方を指定しなければなりません。
 </simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  この関数を正しく動作させるには、正しい形式の
  <filename>openssl.cnf</filename> をインストールしておく必要があります。
  詳細な情報は、<link linkend="openssl.installation">インストールについてのセクション</link>
  を参照ください。
 </simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
 オプションのパラメータ <parameter>notext</parameter>
 を設定すると、出力内容の冗長性が変化します。&false; を指定すると、
 人間が読むための追加情報が出力に含まれるようになります。
 <parameter>notext</parameter> のデフォルト値は &true; です。
</para>'>

<!-- COM/Dotnet -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<para>
 variant に関するすべての計算用関数と同様、この関数のパラメータには
 PHP のネイティブ型 (整数、文字列、浮動小数点数、boolean あるいは
 &null;) あるいは COM、VARIANT、DOTNET クラスのインスタンスが使用できます。
 PHP のネイティブ型は、<xref linkend="class.variant"/>
 クラスのコンストラクタと同じ方法で variant に変換されます。
 COM オブジェクトおよび DOTNET オブジェクトはデフォルトプロパティの値を持っており、
 これを variant の値として使用します。
</para>
<para>
 variant に関する計算関数は、COM ライブラリの同名の関数のラッパーです。
 これらの関数についての詳細な情報は、MSDN ライブラリでご確認ください。
 PHP での関数名は微妙に異なります。たとえば、PHP での関数
 <function>variant_add</function> に対応する関数は、MSDN のドキュメントでは
 <literal>VarAdd()</literal> となります。
</para>
</note>
'>
<!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  この関数は PHP 5 には存在しません。
  より自然なオブジェクト指向形式の構文で、
  プロパティにアクセスしたりメソッドをコールしたりすることになります。
 </simpara>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><para>
このメソッドは、&php.ini; の <literal>phar.readonly</literal>
が <literal>0</literal> でないと <classname>Phar</classname>
オブジェクトで動作しません。それ以外の場合は
<classname>PharException</classname> がスローされます。</para></note>'>

<!ENTITY phar.removed.pharcompress '<note xmlns="http://docbook.org/ns/docbook"><para>
このメソッドは、phar 拡張モジュールバージョン 2.0.0 で削除されました。
今後は <function>Phar::compress</function>、
<function>Phar::decompress</function>、<function>Phar::compressFiles</function> および
<function>Phar::decompressFiles</function> をご利用ください。</para></note>'>

<!ENTITY phar.removed.pharfileinfocompress '<note xmlns="http://docbook.org/ns/docbook"><para>
このメソッドは、phar 拡張モジュールバージョン 2.0.0 で削除されました。
今後は <function>PharFileInfo::isCompressed</function>、
<function>PharFileInfo::decompress</function> および <function>PharFileInfo::compress</function>
をご利用ください。</para></note>'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>Phar::addFile</function>, <function>Phar::addFromString</function>, <function>Phar::offsetSet</function> は、呼び出されるたびに新しいPharアーカイブを生成します。パフォーマンスを気にするなら、代わりに
  <function>Phar::buildFromDirectory</function> や <function>Phar::buildFromIterator</function> を使うべきです。
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>PharData::addFile</function>, <function>PharData::addFromString</function>, <function>PharData::offsetSet</function> は、呼び出されるたびに新しいPharアーカイブを生成します。パフォーマンスを気にするなら、代わりに
  <function>PharData::buildFromDirectory</function> や <function>PharData::buildFromIterator</function> を使うべきです。
 </simpara>
</note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">この拡張モジュールを使うには
<link linkend="book.libxml">libxml</link> 拡張モジュールが必要です。つまり、
PHP 7.4 以降では <option role="configure">--with-libxml</option>、それより前のバージョンでは <option role="configure">--enable-libxml</option> も指定しなければならないということです。
しかし、libxml はデフォルトで有効になっているのでこのオプションは暗黙のうちに指定されています。</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para>この関数は、PHP
を libxml 20620 以降と組み合わせてコンパイルした場合にのみ使用可能です。</para></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description '
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function> が返すリソース'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">このメソッドのコールに
(未実装などの理由で) 失敗した場合、
<constant>E_WARNING</constant> を発行します。</para>'>
<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para>有効なコンテキストがコール元関数に渡された場合に
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
プロパティが更新されます。</para></note>'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success '成功した場合に &true; を返します。'>
<!ENTITY gmagick.gmagickexception.throw 'エラー時に
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> をスローします。'>

<!-- Reflection -->
<!ENTITY reflection.export.return '<parameter xmlns="http://docbook.org/ns/docbook">return</parameter> パラメータを
&true; に設定すると、エクスポートを文字列で返します。それ以外の場合は
&null; を返します。'>

<!ENTITY reflection.export.param.return '&true; に設定すると、エクスポートを発行するのではなく返します。
&false; (デフォルト) の場合はその逆です。'>

<!ENTITY reflection.invoke.reference '関数の引数の中にリファレンス渡しを要するものがある場合は、
渡す引数の中でもリファレンスにしておく必要があります。'>

<!ENTITY reflection.export.param.name 'エクスポートするリフレクション。'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <para>
  指定したクラス名にマッチするアトリビュートの、
  <classname>ReflectionAttribute</classname>
  のみを含むようにフィルタします。
 </para>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
 <para>
  <parameter>name</parameter> が指定されていた場合に、
  結果をどうフィルタするかを決めるフラグ。
 </para>
 <para>
  デフォルトは <literal>0</literal> です。
  この場合、アトリビュートのクラス名が
  <parameter>name</parameter> であるものだけを返します。
 </para>
 <para>
  他の利用可能なオプションは、
  <constant>ReflectionAttribute::IS_INSTANCEOF</constant> です。
  この場合、フィルタリングに
  <literal>instanceof</literal> を使います。
 </para>
</listitem>
</varlistentry>'>

<!-- SPL -->
<!ENTITY spl.datastructures.intro.title '<title xmlns="http://docbook.org/ns/docbook">データ構造</title>'>

<!ENTITY spl.exceptions.intro.title '<title xmlns="http://docbook.org/ns/docbook">例外</title>'>
<!ENTITY spl.exceptions.intro '<para xmlns="http://docbook.org/ns/docbook">SPL には標準の例外が用意されています。</para><para xmlns="http://docbook.org/ns/docbook"><xref linkend="reserved.exceptions" /> も参照ください。</para>'>

<!ENTITY spl.files.intro.title '<title xmlns="http://docbook.org/ns/docbook">ファイル操作</title>'>
<!ENTITY spl.files.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">SPL にはファイルを扱うためのクラスが用意されています。</para></partintro>'>

<!ENTITY spl.interfaces.intro.title '<title xmlns="http://docbook.org/ns/docbook">インターフェイス</title>'>
<!ENTITY spl.interfaces.intro '<para xmlns="http://docbook.org/ns/docbook">SPL にはインターフェイスが用意されています。</para><para xmlns="http://docbook.org/ns/docbook"><xref linkend="reserved.interfaces" /> も参照ください。</para>'>
<!ENTITY spl.interfaces.list '<title xmlns="http://docbook.org/ns/docbook">インターフェイス一覧</title>'>

<!ENTITY spl.iterators.intro.title '<title xmlns="http://docbook.org/ns/docbook">イテレータ</title>'>
<!ENTITY spl.iterators.intro '<para xmlns="http://docbook.org/ns/docbook">SPL にはイテレータが用意されており、オブジェクトを反復処理することができます。</para>'>

<!ENTITY spl.misc.intro.title '<title xmlns="http://docbook.org/ns/docbook">その他のクラスおよびインターフェイス</title>'>
<!ENTITY spl.misc.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>他の SPL カテゴリにあてはまらないクラスおよびインターフェイス群です。</para></partintro>'>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>ポータビリティを考慮して、ZIP ファイル名のディレクトリ区切り文字には常にスラッシュ (<literal>/</literal>) を使うことを推奨します。</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error 'パラメータに問題がある場合は &false;、失敗した場合は <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 エラーコード</link> を返します。'>
<!ENTITY win32service.success.false.error '成功した場合に &true; を返します。&win32service.false.error;'>
<!ENTITY win32service.noerror.false.error '成功した場合に <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> を返していました。&win32service.false.error;'>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
 <acronym>MIB</acronym> は、オブジェクトIDごとのタイプを定義します。
 これは、以下の一覧から指定される一文字でなければなりません。
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>MIBから取得するタイプ</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
 <acronym>SNMP</acronym> ライブラリをコンパイルする際、
 <constant>OPAQUE_SPECIAL_TYPES</constant> が定義されていた場合、
 以下も正しい値になります:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>unsigned int64</entry></row>
   <row><entry>I</entry><entry>signed int64</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
 これらの大半は、対応する ASN.1 の型を使います。&apos;s&apos;, &apos;x&apos;, &apos;d&apos; および &apos;b&apos; はどれも OCTET STRING
 を異なる方法で表したものであり、&apos;u&apos; も Gauge32 値を扱うためのものです。
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
 MIB ファイルが "snmp_read_mib" や libsnmp の設定で MIB ツリーに読み込まれている場合は、
 <parameter>type</parameter> に &apos;=&apos; を使うことができます。
 これはすべてのオブジェクト ID を表し、型は自動的に MIB から読み込みます。
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
 "SYNTAX    BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}"
 のような BITS 型の値変数を設定する方法は二通りあることに注意しましょう。
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   型として "b" を使い、ビット番号の一覧を指定する。この方法はおすすめしません。
   同じ OID に対して GET クエリを実行しても 0xF8 などを返すからです。
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Using type "x" and a hex number but without(!) the usual "0x" prefix.
   型として "x" を使い、通常のプレフィックス "0x" をつけずに(!) 16 進数を指定する。
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 詳細は、サンプルを参照ください。
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
 このメソッドは、デフォルトでは一切例外をスローしません。ライブラリでエラーが発生したときに
 SNMPException をスローさせるには SNMP クラスパラメータ
 <parameter>exceptions_enabled</parameter> に値を設定しなければなりません。
 詳細は <link linkend="snmp.props.exceptions-enabled">
 <parameter>SNMP::$exceptions_enabled</parameter> の説明</link>を参照ください。
</para>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
<parameter xmlns="http://docbook.org/ns/docbook">callback</parameter> 関数が、リクエスト終了時にコールされます。
この関数のプロトタイプは、<programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
に一致しなければなりません。
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><para>は、リクエストに渡すカスタムデータです。</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>にはリクエスト固有の結果が格納されます。基本的には、対応するシステムコールが返すそのままの値となります。</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>はオプションで指定するリクエストリソースです。
<function>eio_get_last_error</function> のような関数で使えます。</para></listitem>
</varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<para
xmlns="http://docbook.org/ns/docbook">リクエストの優先順位。<constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>、<constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>、<constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant> あるいは &null; を指定します。
&null; を渡した場合、<parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter> は内部的に
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant> となります。
</para>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">相対パスを避けましょう
</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real '実数値の配列。'>
<!ENTITY trader.arg.array.of.real.high '高値。実数値の配列。'>
<!ENTITY trader.arg.array.of.real.low '安値。実数値の配列。'>
<!ENTITY trader.arg.array.of.real.close '終値。実数値の配列。'>
<!ENTITY trader.arg.array.of.real.open '始値。実数値の配列。'>
<!ENTITY trader.arg.array.of.real.volume '取引高。実数値の配列。'>
<!ENTITY trader.arg.array.of.real.periods '実数値の配列。'>

<!-- to be translated -->
<!ENTITY trader.arg.penetration 'Percentage of penetration of a candle within another candle.'>
<!ENTITY trader.arg.vfactor 'Volume Factor. Valid range from 1 to 0.'>
<!ENTITY trader.arg.time.period 'Number of period. Valid range from 2 to 100000.'>
<!ENTITY trader.arg.fast.period 'Number of period for the fast MA. Valid range from 2 to 100000.'>
<!ENTITY trader.arg.slow.period 'Number of period for the slow MA. Valid range from 2 to 100000.'>
<!ENTITY trader.arg.signal.period 'Smoothing for the signal line (nb of period). Valid range from 1 to 100000.'>
<!ENTITY trader.arg.fastk.period 'Time period for building the Fast-K line. Valid range from 1 to 100000.'>
<!ENTITY trader.arg.fastd.period 'Smoothing for making the Fast-D line. Valid range from 1 to 100000, usually set to 3.'>
<!ENTITY trader.arg.slowk.period 'Smoothing for making the Slow-K line. Valid range from 1 to 100000, usually set to 3.'>
<!ENTITY trader.arg.slowd.period 'Smoothing for making the Slow-D line. Valid range from 1 to 100000.'>
<!ENTITY trader.arg.min.period 'Value less than minimum will be changed to Minimum period. Valid range from 2 to 100000'>
<!ENTITY trader.arg.max.period 'Value higher than minimum will be changed to Maximum period. Valid range from 2 to 100000'>
<!ENTITY trader.arg.ma.type 'Type of Moving Average. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.fast.ma.type 'Type of Moving Average for fast MA. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slow.ma.type 'Type of Moving Average for slow MA. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.fastd.ma.type 'Type of Moving Average for Fast-D. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slowk.ma.type 'Type of Moving Average for Slow-K. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slowd.ma.type 'Type of Moving Average for Slow-D. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slowk.ma.type 'Type of Moving Average for Slow-K. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.signal.ma.type 'Type of Moving Average for signal line. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.nbdevup 'Deviation multiplier for upper band. Valid range from <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> to <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn 'Deviation multiplier for lower band. Valid range from <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> to <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Upper limit use in the adaptive algorithm. Valid range from 0.01 to 0.99.'>
<!ENTITY trader.arg.slow.limit 'Lower limit use in the adaptive algorithm. Valid range from 0.01 to 0.99.'>

<!-- Mongo -->
<!ENTITY mongo.setreadpreference.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>read_preference</parameter></term><listitem><para>The read preference mode: <constant>MongoClient::RP_PRIMARY</constant>, <constant>MongoClient::RP_PRIMARY_PREFERRED</constant>, <constant>MongoClient::RP_SECONDARY</constant>, <constant>MongoClient::RP_SECONDARY_PREFERRED</constant>, or <constant>MongoClient::RP_NEAREST</constant>.</para></listitem></varlistentry><varlistentry><term><parameter>tags</parameter></term><listitem><para>An array of zero or more tag sets, where each tag set is itself an array of criteria used to match tags on replica set members.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Returns &true; on success, or &false; otherwise.</para>'>
<!ENTITY mongo.setreadpreference.errors '<para xmlns="http://docbook.org/ns/docbook">Emits <constant>E_WARNING</constant> if either parameter is invalid, or if one or more tag sets are provided with the <constant>MongoClient::RP_PRIMARY</constant> read preference mode.</para>'>
<!ENTITY mongo.getreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the read preference. The array contains the values <literal>type</literal> for the string read preference mode (corresponding to the <classname>MongoClient</classname> constants), and <literal>tagsets</literal> containing a list of all tag set criteria. If no tag sets were specified, <literal>tagsets</literal> will not be present in the array.</para>'>
<!ENTITY mongo.setwriteconcern.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>w</parameter></term><listitem><para>The write concern. This may be an integer denoting the number of servers required to acknowledge the write, or a string mode (e.g. "majority").</para></listitem></varlistentry><varlistentry><term><parameter>wtimeout</parameter></term><listitem><para>The maximum number of milliseconds to wait for the server to satisfy the write concern.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Returns &true; on success, or &false; otherwise.</para>'>
<!ENTITY mongo.setwriteconcern.errors '<para xmlns="http://docbook.org/ns/docbook">Emits <constant>E_WARNING</constant> if the <literal>w</literal> parameter is not an integer or string value.</para>'>
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the write concern. The array contains the values <literal>w</literal> for an integer acknowledgement level or string mode, and <literal>wtimeout</literal> denoting the maximum number of milliseconds to wait for the server to satisfy the write concern.</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>Specifies a cumulative time limit in milliseconds for processing the operation on the server (does not include idle time). If the operation is not completed by the server within the timeout period, a <classname>MongoExecutionTimeoutException</classname> will be thrown.</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Builds the index in the background so that building an index does <emphasis>not</emphasis> block other database activities. Specify &true; to build in the background. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">Building Indexes with Replica Sets</link> for more information.</para></warning></listitem>'>
<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Specify &true; to force creation of a unique index where the collection may contain duplicate values for a key. MongoDB will index the first occurrence of a key and delete all subsequent documents from the collection that contain a duplicate value for that key. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> may delete data from your database. Use with extreme caution.</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>This option is not supported on MongoDB 2.8+. Index creation will fail if the collection contains duplicate values.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>The value of this option should specify the number of seconds after which a document should be considered expired and automatically removed from the collection. This option is only compatible with single-field indexes where the field will contain <classname>MongoDate</classname> values.</para><note xmlns="http://docbook.org/ns/docbook"><para>This feature is available in MongoDB 2.2+. See <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">Expire Data from Collections by Setting TTL</link> for more information.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>A optional name that uniquely identifies the index.</para><note xmlns="http://docbook.org/ns/docbook"><para>By default, the driver will generate an index name based on the index&apos;s field(s) and ordering or type. For example, a compound index <literal>array("x" => 1, "y" => -1)</literal> would be named <literal>"x_1_y_-1"</literal> and a geospatial index <literal>array("loc" => "2dsphere")</literal> would be named <literal>"loc_2dsphere"</literal>. For indexes with many fields, it is possible that the generated name might exceed MongoDB&apos;s <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">limit for index names</link>. The <literal>"name"</literal> option may be used in that case to supply a shorter name.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>Specify &true; to create a sparse index, which only indexes documents containing a specified field. The default value is &false;.</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>Specify &true; to create a unique index. The default value is &false;. This option applies only to ascending/descending indexes.</para><note xmlns="http://docbook.org/ns/docbook"><para>When MongoDB indexes a field, if a document does not have a value for the field, a &null; value is indexed. If multiple documents do not contain a field, a unique index will reject all but the first of those documents. The <literal>"sparse"</literal> option may be used to overcome this, since it will prevent documents without the field from being indexed.</para></note></listitem>'>
<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>This method will use the <link xlink:href="&url.mongodb.docs.command;listCollections" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> database command when communicating with MongoDB 2.8+. For previous database versions, the method will query the special <literal>system.namespaces</literal> collection.</simpara></note>'>
<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>Optional query criteria. If provided, this criteria will be used to filter the collections included in the result.</para><para>Relevant fields that may be queried include <literal>"name"</literal> (collection name as a string, without the database name prefix) and <literal>"options" (object containing options used to create the collection).</literal>.</para><note><simpara>MongoDB 2.6 and earlier versions require the <literal>"name"</literal> criteria, if specified, to be a string value (i.e. equality match). This is because the driver must prefix the value with the database name in order to query the <literal>system.namespaces</literal> collection. Later versions of MongoDB do not have this limitation, as the driver will use the listCollections command.</simpara></note></listitem>'>
<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Boolean, defaults to &false;. Determines whether system collections should be included in the result.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"w"</literal></para><para>See <link linkend="mongo.writeconcerns">Write Concerns</link>. The default value for <classname>MongoClient</classname> is <literal>1</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>Deprecated alias for <literal>"wTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for <link linkend="mongo.writeconcerns">write concern</link> acknowledgement. It is only applicable when <literal>"w"</literal> is greater than <literal>1</literal>, as the timeout pertains to replication. If the write concern is not satisfied within the time limit, a <classname>MongoCursorException</classname> will be thrown. A value of <literal>0</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>10000</literal> (ten seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para><para>Boolean, defaults to &false;. If journaling is enabled, it works exactly like <literal>"j"</literal>. If journaling is not enabled, the write operation blocks until it is synced to database files on disk. If &true;, an acknowledged insert is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If journaling is enabled, users are strongly encouraged to use the <literal>"j"</literal> option instead of <literal>"fsync"</literal>. Do not use <literal>"fsync"</literal> and <literal>"j"</literal> simultaneously, as that will result in an error.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for socket communication. If the server does not respond within the timeout period, a <classname>MongoCursorTimeoutException</classname> will be thrown and there will be no way to determine if the server actually handled the write or not. A value of <literal>-1</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>30000</literal> (30 seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>Boolean, defaults to &false;. Forces the write operation to block until it is synced to the journal on disk. If &true;, an acknowledged write is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If this option is used and journaling is disabled, MongoDB 2.6+ will raise an error and the write will fail; older server versions will simply ignore the option.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>Deprecated. Please use the <link linkend="mongo.writeconcerns">write concern</link> <literal>"w"</literal> option.</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>Deprecated alias for <literal>"socketTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorException</classname> if the <literal>"w"</literal> option is set and the write fails.</para><para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorTimeoutException</classname> if the <literal>"w"</literal> option is set to a value greater than one and the operation takes longer than <varname>MongoCursor::$timeout</varname> milliseconds to complete.  This does not kill the operation on the server, it is a client-side timeout. The operation in <varname>MongoCollection::$wtimeout</varname> is milliseconds.</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook">Issues <constant>E_DEPRECATED</constant> warning</para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>These fields may also overwrite those that would be created automatically by the driver, as described in the MongoDB core documentation for the <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">files collection</link>. Some practical use cases for this behavior would be to specify a custom <literal>chunkSize</literal> or <literal>_id</literal> for the file.</para></note>'>
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Returns the <literal>_id</literal> of the saved file document. This will be a generated <classname>MongoId</classname> unless an <literal>_id</literal> was explicitly specified in the <parameter>metadata</parameter> parameter.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>An array of Write Options.<informaltable><thead><row><entry>key</entry><entry>value meaning</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry><link linkend="mongo.writeconcerns">Write concern</link> value</entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Maximum time to wait for replication</link></entry></row><row><entry>ordered</entry><entry>Determines if MongoDB must apply this batch in order. Ordered writes execute serially (i.e. one at a time) and execution will stop after the first error. Unordered writes may execute in parallel and execution will not stop after the first error. Defaults to &true;</entry></row><row><entry>j (bool)</entry><entry>Wait for journaling on the primary. This value is discouraged, use WriteConcern instead</entry></row><row><entry>fsync (bool)</entry><entry>Wait for fsync on the primary. This value is discouraged, use WriteConcern instead</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>The <classname>MongoCollection</classname> to execute the batch on. Its <link linkend="mongo.writeconcerns">write concern</link> will be copied and used as the default write concern if none is given as <parameter>$write_options</parameter> or during <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> An array containing the basic information about the server that was picked. <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>server hash, example: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Node type (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>The maximum BSON Size over the wire this node accepts: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>The maximum Message Size over the wire this node accepts: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>An array of writeConcern options (see below)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>writeConcern array values</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>boolean, force flushing to disk before returning</entry> </row> <row> <entry>j</entry> <entry>boolean, force journal write before returning</entry> </row> <row> <entry>wtimeout</entry> <entry>integer, milliseconds, maximum time the primary is allowed to wait to verify replication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>The total size (in bytes) of the encoded message being sent over the wire</entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>The MongoDB namespace used for the protocol message <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this class
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
Alternatives to this class include:</para>'>
<!ENTITY mongo.noalternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this class
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
There is no equivalent for this class in the new extension.</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this method
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
Alternatives to this method include:</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this method
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
There is no equivalent for this method in the new extension.</para>'>
<!ENTITY mongo.alternative.phplib.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this method
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
There is no equivalent for this method in the new extension, but there is an
alternative in the <link linkend="mongodb.overview">PHP library</link>:</para>'>

<!ENTITY mongo.deprecated.note '<para
xmlns="http://docbook.org/ns/docbook">This extension is deprecated. Instead,
the <link linkend="set.mongodb">MongoDB</link> extension should be
used.</para>'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 1.15.0</entry>
        <entry>
         Return types for methods are declared as tentative on PHP 8.0 and newer,
         triggering deprecation notices in code that implements this interface
         without declaring the appropriate return types. The <code>#[ReturnTypeWillChange]</code>
         attribute can be added to silence the deprecation notice.
        </entry>
       </row>
'>

<!ENTITY mongodb.option.collation '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>collation</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> allows users to specify language-specific rules for string comparison, such as rules for lettercase and accent marks. When specifying collation, the <literal>"locale"</literal> field is mandatory; all other collation fields are optional. For descriptions of the fields, see <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Collation Document</link>.
           </para>
           <para>
            If the collation is unspecified but the collection has a default collation, the operation uses the collation specified for the collection. If no collation is specified for the collection or for the operation, MongoDB uses the simple binary comparison used in prior versions for string comparisons.
           </para>
           <para>
            This option is available in MongoDB 3.4+ and will result in an exception at execution time if specified for an older server version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Map of parameter names and values. Values must be constant or closed expressions that do not reference document fields. Parameters can then be accessed as variables in an aggregate expression context (e.g. <literal>$$var</literal>).
           </para>
           <para>
            This option is available in MongoDB 5.0+ and will result in an exception at execution time if specified for an older server version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>The Manager used to route data key queries to a separate MongoDB cluster. By default, the current Manager and cluster is used.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>) denoting the collection that contains all data keys used for encryption and decryption.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            A document containing the configuration for one or more KMS providers, which are used to encrypt data keys. Supported providers include <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, <literal>"kmip"</literal>, and <literal>"local"</literal> and at least one must be specified.
           </para>
           <para>
            If an empty document is specified for <literal>"aws"</literal>,
            <literal>"azure"</literal>, or <literal>"gcp"</literal>, the driver
            will attempt to configure the provider using
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Automatic Credentials</link>.
           </para>
           <para>
            The format for <literal>"aws"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <para>
            The format for <literal>"azure"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // Defaults to "login.microsoftonline.com"
}
]]>
           </programlisting>
           <para>
            The format for <literal>"gcp"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // Defaults to "oauth2.googleapis.com"
}
]]>
           </programlisting>
           <para>
            The format for <literal>"kmip"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
            The format for <literal>"local"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // 96-byte master key used to encrypt/decrypt data keys
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"aws"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Required. The Amazon Resource Name (ARN) to the AWS customer master key (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. An alternate host identifier to send KMS requests to. May include port number.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"azure"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Required. Host with optional port (e.g. "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional. A specific version of the named key. Defaults to using the key&apos;s primary version.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"gcp"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional. A specific version of the named key. Defaults to using the key&apos;s primary version.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. Host with optional port. Defaults to "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"kmip"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Optional. Unique identifier to a 96-byte KMIP secret data managed object. If unspecified, the driver creates a random 96-byte KMIP secret data managed object.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. Host with optional port.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            A document containing the TLS configuration for one or more KMS providers. Supported providers include <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, and <literal>"kmip"</literal>. All providers support the following options:
           </para>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>,
    tlsDisableOCSPEndpointCheck: <optional bool>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>maxCommitTimeMS</entry>
          <entry>integer</entry>
          <entry>
           <para>
            The maximum amount of time in milliseconds to allow a single
            <literal>commitTransaction</literal> command to run.
           </para>
           <para>
            If specified, <literal>maxCommitTimeMS</literal> must be a signed
            32-bit integer greater than or equal to zero.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readConcern</entry>
          <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
          <entry>
           <para>
            A read concern to apply to the operation.
           </para>
           <para>
            This option is available in MongoDB 3.2+ and will result in an
            exception at execution time if specified for an older server
            version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readPreference '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readPreference</entry>
          <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
          <entry>
           <para>
            A read preference to use for selecting a server for the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.session '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>session</entry>
          <entry><classname>MongoDB\Driver\Session</classname></entry>
          <entry>
           <para>
            A session to associate with the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
     <warning xmlns="http://docbook.org/ns/docbook">
      <para>
       If you are using a <literal>"session"</literal> which has a transaction
       in progress, you cannot specify a <literal>"readConcern"</literal> or
       <literal>"writeConcern"</literal> option. This will result in an
       <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
       being thrown. Instead, you should set these two options when you create
       the transaction with
       <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
      </para>
     </warning>
'>
<!ENTITY mongodb.option.writeConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>writeConcern</entry>
          <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
          <entry>
           <para>
            A write concern to apply to the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>).
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      The name of the database on which to execute the command.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
    <listitem>
     <para>
      The write(s) to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
    <listitem>
     <para>
      The command to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Encryption options</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Option</entry>
          <entry>Type</entry>
          <entry>Description</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            The encryption algorithm to be used. This option is required.
            Specify one of the following
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption constants</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant></member>
           </simplelist>
          </entry>
         </row>
         <row>
          <entry>contentionFactor</entry>
          <entry><type>int</type></entry>
          <entry>
           <para>
            The contention factor for evaluating queries with indexed, encrypted
            payloads.
           </para>
           <para>
            This option only applies and may only be specified when
            <literal>algorithm</literal> is
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            or
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyAltName</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Identifies a key vault collection document by
            <literal>keyAltName</literal>. This option is mutually exclusive
            with <literal>keyId</literal> and exactly one is required.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyId</entry>
          <entry><classname>MongoDB\BSON\Binary</classname></entry>
          <entry>
           <para>
            Identifies a data key by <literal>_id</literal>. The value is a UUID
            (binary subtype 4). This option is mutually exclusive with
            <literal>keyAltName</literal> and exactly one is required.
           </para>
          </entry>
         </row>
         <row>
          <entry>queryType</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            The query type for evaluating queries with indexed, encrypted
            payloads. Specify one of the following
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption constants</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW</constant></member>
           </simplelist>
           <para>This option only applies and may only be specified when
            <literal>algorithm</literal> is
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            or <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Index options for a queryable encryption field supporting "range"
            queries. The options below must match the values set in the
            <literal>encryptedFields</literal> of the target collection. For
            double and decimal128 BSON field types, <literal>min</literal>,
            <literal>max</literal>, and <literal>precision</literal> must all be
            set, or all be unset.
           </para>
           <para>
            <table>
             <title>Range index options</title>
             <tgroup cols="3">
              <thead>
               <row>
                <entry>Option</entry>
                <entry>Type</entry>
                <entry>Description</entry>
               </row>
              </thead>
              <tbody>
               <row>
                <entry>min</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Required if <literal>precision</literal> is set. The minimum
                 BSON value of the range.
                </entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Required if <literal>precision</literal> is set. The maximum
                 BSON value of the range.
                </entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Required. Positive 64-bit integer.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>
                 Optional. Positive 32-bit integer specifying precision to use
                 for explicit encryption. May only be set for double or
                 decimal128 BSON field types.
                </entry>
               </row>
               <row>
                <entry>trimFactor</entry>
                <entry><type>int</type></entry>
                <entry>Required. Positive 32-bit integer.</entry>
               </row>
              </tbody>
             </tgroup>
            </table>
           </para>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
    <listitem>
     <para>
      The query to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <para>
      <link linkend="mongodb.persistence.typemaps">Type map configuration</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
    <listitem>
     <para>
      The <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">query predicate</link>.
      An empty predicate will match all documents in the collection.
     </para>
     <note>
      <simpara>
       When evaluating query criteria, MongoDB compares types and values according to its own <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">comparison rules for BSON types</link>, which differs from PHP&apos;s <link linkend="types.comparisons">comparison</link> and <link linkend="language.types.type-juggling">type juggling</link> rules. When matching a special BSON type the query criteria should use the respective <link linkend="book.bson">BSON class</link> (e.g. use <classname>MongoDB\BSON\ObjectId</classname> to match an <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
      </simpara>
     </note>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Returns <classname>MongoDB\Driver\Cursor</classname> on success.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Returns <classname>MongoDB\Driver\WriteResult</classname> on success.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> if the <literal>"session"</literal> option is used with an associated transaction in combination with a <literal>"readConcern"</literal> or <literal>"writeConcern"</literal> option.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> if the <literal>"session"</literal> option is used in combination with an unacknowledged write concern.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\BulkWriteException</classname> on any write failure (e.g. write error, failure to apply a write concern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> on argument parsing errors.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\AuthenticationException</classname> if authentication is needed and fails.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\ConnectionException</classname> if connection to the server fails (for reasons other than authentication).</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> if the input did not contain exactly one BSON document. Possible reasons include, but are not limited to, invalid BSON, extra data (after reading one BSON document), or an unexpected <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link> error.</member>'>

<!ENTITY mongodb.note.queryable-encryption-preview '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Queryable Encryption is in public preview and available for evaluation
     purposes. It is not yet recommended for production deployments as breaking
     changes may be introduced. See the <link xlink:href="https://www.mongodb.com/blog/post/mongodb-releases-queryable-encryption-preview/" xmlns:xlink="http://www.w3.org/1999/xlink">Queryable Encryption Preview</link> blog post for more information.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.decimal128 '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     <classname>MongoDB\BSON\Decimal128</classname> is only compatible with
     MongoDB 3.4+. Attempting to use the BSON type with an earlier version of
     MongoDB will result in an error.
    </simpara>
   </note>
'>
<!ENTITY mongodb.note.extended-json '
  <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <simpara>
    The output is consistent with the <function>MongoDB\BSON\toJSON</function>
    function, which uses the driver-specific legacy extended JSON format. This
    does not necessarily match the
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxed</link>
    or <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canonical</link>
    extended JSON representations used by
    <function>MongoDB\BSON\toRelaxedExtendedJSON</function> and
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, respectively.
   </simpara>
  </note>
'>
<!ENTITY mongodb.note.forking '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     On Unix platforms, the extension is sensitive to scripts that use the
     fork() system call without also calling exec(). Users are advised not to
     re-use <classname>MongoDB\Driver\Manager</classname> instances in a forked
     child process.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.uint32 '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Because PHP&apos;s integer type is signed, some values returned by this
    method may appear as negative integers on 32-bit platforms. The
    <literal>"&#37;u"</literal> formatter of <function>sprintf</function> may be
    used to obtain a string representation of the unsigned decimal value.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.readpreference '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    The <literal>"readPreference"</literal> option does not control the server
    to which the driver issues the operation; it will always be executed on
    this server object. Instead, it may be used when issuing the operation to a
    secondary (from a replica set connection, not standalone) or mongos node to
    ensure that the driver sets the wire protocol accordingly or adds the read
    preference to the operation, respectively.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.write '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    It is the caller&apos;s responsibility to ensure that the server is capable
    of executing the write operation. For example, executing a write operation
    on a secondary (excluding its "local" database) will fail.
   </simpara>
  </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     BSON documents can technically contain duplicate keys because documents are
     stored as a list of key-value pairs; however, applications should refrain
     from generating documents with duplicate keys as server and driver behavior
     may be undefined. Since PHP objects and arrays cannot have duplicate keys,
     data could also be lost when decoding a BSON document with duplicate keys.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>A request must be created via <function>radius_create_request</function> before this function can be called.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>The attribute type.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>The RADIUS resource.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>A bitmask of the attribute options. The available options include <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> and <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>The attribute tag. This parameter is ignored unless the <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> option is set.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>The vendor ID.</para></listitem></varlistentry>'>


<!ENTITY mongo.setreadpreference.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>read_preference</parameter></term><listitem><para>読み込みの優先モード。<constant>MongoClient::RP_PRIMARY</constant>、<constant>MongoClient::RP_PRIMARY_PREFERRED</constant>、<constant>MongoClient::RP_SECONDARY</constant>、<constant>MongoClient::RP_SECONDARY_PREFERRED</constant> あるいは <constant>MongoClient::RP_NEAREST</constant> のいずれか。</para></listitem></varlistentry><varlistentry><term><parameter>tags</parameter></term><listitem><para>ゼロ個以上のタグセットの配列。各タグセット自体も配列で、レプリカセットのメンバーのタグにマッチさせる条件として使います。</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">成功した場合に &true;、それ以外の場合に &false; を返します。</para>'>
<!ENTITY mongo.setreadpreference.errors '<para xmlns="http://docbook.org/ns/docbook">パラメータが無効な場合、あるいは優先読み込みモードが <constant>MongoClient::RP_PRIMARY</constant> のときにタグセットを指定した場合に <constant>E_WARNING</constant> が発生します。</para>'>
<!ENTITY mongo.getreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">この関数は、優先読み込みに関する配列を返します。配列に含まれる内容は、<literal>type</literal> (優先読み込みモードを表す文字列。<classname>MongoClient</classname> の定数に対応)、そして <literal>tagsets</literal> (すべてのタグセット条件のリスト) です。タグセットを指定しなかった場合は、<literal>tagsets</literal> は存在しません。</para>'>
<!ENTITY mongo.setwriteconcern.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>w</parameter></term><listitem><para>書き込み確認。何台のサーバーに書き込めたら成功とみなすのかを表す整数値、あるいは文字列 ("majority" など) でモードを指定します。</para></listitem></varlistentry><varlistentry><term><parameter>wtimeout</parameter></term><listitem><para>サーバーが書き込み確認を待つ最大ミリ秒数。</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">成功した場合に &true;、それ以外の場合に &false; を返します。</para>'>
<!ENTITY mongo.setwriteconcern.errors '<para xmlns="http://docbook.org/ns/docbook"><literal>w</literal> が整数値あるいは文字列でない場合に <constant>E_WARNING</constant> が発生します。</para>'>
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">この関数は、書き込み確認を表す配列を返します。<literal>w</literal> の値はサーバーの台数を表す整数値かモードを表す文字列、そして <literal>wtimeout</literal> の値はサーバーが書き込み確認を待つ最大ミリ秒数です。</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>サーバー上で操作を行う累積時間の制限 (アイドル時間を含まない) を、ミリ秒単位で指定します。この時間内にサーバー側の操作が完了しなければ、<classname>MongoExecutionTimeoutException</classname> をスローします。</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Builds the index in the background so that building an index does <emphasis>not</emphasis> block other database activities. Specify &true; to build in the background. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">Building Indexes with Replica Sets</link> for more information.</para></warning></listitem>'>
<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>&true; を指定すると、一意なインデックスを強制的に作成します。このとき、コレクション内でキーの値が重複してしまう可能性があります。MongoDB は最初に出現したキーをインデックスし、それ以降に出現する同じキーのすべてのドキュメントを削除します。デフォルト値は &false; です。</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> はデータベースのデータを削除することがあるので、使う際には十分な注意が必要です。</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>このオプションは、MongoDB 2.8 以降には対応していません。コレクションに値の重複がある場合は、インデックスの作成に失敗します。</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>このオプションの値に指定するのは、ドキュメントを有効期限切れとみなしてコレクションから自動削除するまでの秒数です。このオプションが使えるのは、単一フィールドインデックスで、フィールドに <classname>MongoDate</classname> の値を含む場合のみです。</para><note xmlns="http://docbook.org/ns/docbook"><para>この機能が使えるのは、MongoDB 2.2 以降です。詳細は <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">Expire Data from Collections by Setting TTL</link> を参照ください。</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>オプションの、インデックスを一意に特定するための名前。</para><note xmlns="http://docbook.org/ns/docbook"><para>ドライバーがデフォルトで生成するインデックス名は、インデックスのフィールドと、並び順あるいは型に基づくものです。たとえば、複合インデックス <literal>array("x" => 1, "y" => -1)</literal> の名前は <literal>"x_1_y_-1"</literal> であり、地理空間インデックス <literal>array("loc" => "2dsphere")</literal> の名前は <literal>"loc_2dsphere"</literal> となります。多数のフィールドからなるインデックスの場合、自動生成される名前が MongoDB の <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">インデックス名の制限</link> を超えてしまう可能性があります。<literal>"name"</literal> オプションは、そんな場合に短い名前を用意するときなどに使えます。</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>&true; を指定すると、疎なインデックスを作ります。これは、指定したフィールドを含むドキュメントだけをインデックスします。デフォルト値は &false; です。</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>&true; を指定すると、一意なインデックスを作ります。デフォルト値は &false; です。このオプションを使えるのは、昇順もしくは降順のインデックスだけです。</para><note xmlns="http://docbook.org/ns/docbook"><para>MongoDB がフィールドをインデックスするとき、もしそのフィールドに値を含まないドキュメントがあれば、&null; 値をインデックスします。このフィールドを含まないドキュメントが複数あった場合、一意なインデックスは、最初に出現したドキュメント以外を受け付けません。これを防ぐには <literal>"sparse"</literal> オプションを使います。このオプションを指定すれば、インデックス対象のフィールドが存在しないドキュメントはインデックスしなくなります。</para></note></listitem>'>
<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>このメソッドは、MongoDB 2.8 以降と通信する際に、データベースコマンド <link xlink:href="&url.mongodb.docs.command;listCollections" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> を利用します。以前のバージョンのデータベースの場合は、特別なコレクション <literal>system.namespaces</literal> を問い合わせます。</simpara></note>'>
<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>オプションの問い合わせ条件。これを指定すると、結果に含まれるコレクションをその条件でフィルタリングします。</para><para>問い合わせの対象となる関連フィールドには、<literal>"name"</literal> (コレクション名を表す文字列。データベース名のプレフィックスは含まない) や <literal>"options"</literal> (コレクションを作成するために用いるオプションを含むオブジェクト) があります。</para><note><simpara>MongoDB 2.6 以前のバージョンでは、<literal>"name"</literal> の条件指定には文字列しか使えませんでした (一致する文字列だけに絞り込むなど)。これは、ドライバが <literal>system.namespaces</literal> コレクションに問い合わせるときに、その値をデータベース名の先頭に付加する必要があったからです。最新版の MongoDB にはこの制約がなくなりました。listCollections コマンドを使うようになったからです。</simpara></note></listitem>'>
<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Boolean で、デフォルトは &false; です。system コレクションを結果に含めるかどうかを指定します。</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook">
<para><literal>"w"</literal></para>
<para><link linkend="mongo.writeconcerns">WriteConcerns</link> を参照ください。<classname>MongoClient</classname> でのデフォルト値は <literal>1</literal> です。
</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>廃止予定。<literal>"wTimeoutMS"</literal> のエイリアスです。</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>このオプションは、<link linkend="mongo.writeconcerns">書き込み確認</link>を待つ制限時間をミリ秒単位で指定します。これが書き込み操作に適用されるのは、<literal>"w"</literal> が <literal>1</literal> より大きい場合のみです。というのも、タイムアウトはレプリケーションに関する機能だからです。この時間内に書き込み確認ができなかった場合は <classname>MongoCursorException</classname> をスローします。<literal>0</literal> を指定すると、永遠にブロックし続けます。<classname>MongoClient</classname> でのデフォルトは <literal>10000</literal> ミリ秒 (10 秒) です。</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para>
<para>Boolean 型で、デフォルトは &false; です。
ジャーナリングが有効な場合、これは <literal>"j"</literal> とまったく同じ動きをします。
ジャーナリングが有効でない場合は、追加をディスク上のデータベースファイルに同期させるまで成功したと見なさないようになります。
&true; にすると確認つき書き込みが暗黙のうちに設定され、<literal>"w"</literal> の値を <literal>0</literal> にします。
</para>
<note><simpara>ジャーナリングが有効な場合は、<literal>"fsync"</literal> のかわりに <literal>"j"</literal> を使いましょう。
<literal>"fsync"</literal> と <literal>"j"</literal> を同時に指定すると、エラーになります。
</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>このオプションは、ソケット通信の制限時間を、ミリ秒単位で指定します。この時間内にサーバーからの反応がなければ、<classname>MongoCursorTimeoutException</classname> をスローします。この場合、サーバー側で書き込み処理が行われたのかどうかを判断できなくなります。<literal>-1</literal> を指定すると、永遠にブロックします。<classname>MongoClient</classname> のデフォルト値は <literal>30000</literal> (30 秒) です。</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>デフォルトは &false; です。これを指定すると、追加をジャーナルに同期させるまで成功したと見なさないようになります。&true; にすると確認付き書き込みと見なされ、<literal>"w"</literal> の設定を <literal>0</literal> に上書きします。</para><note><simpara>このオプションを使っているときにジャーナリングを無効にすると、MongoDB 2.6 以降ではエラーが発生して書き込みに失敗します。古いバージョンのサーバーでは、単純にオプションの指定を無視します。</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>非推奨。<link linkend="mongo.writeconcerns">write concern</link> の <literal>w</literal> オプションを使いましょう。</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>非推奨。<literal>"socketTimeoutMS"</literal> のエイリアス。</para></listitem>'>
<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook"><literal>"w"</literal> オプションが設定されていて書き込みが失敗した場合に <classname>MongoCursorException</classname> をスローします。</para><para xmlns="http://docbook.org/ns/docbook"><literal>"w"</literal> オプションの値が 1 より大きく設定されていて、操作の完了までの時間が <varname>MongoCursor::$timeout</varname> ミリ秒をこえた場合に <classname>MongoCursorTimeoutException</classname> をスローします。サーバー上での操作は止めません。これはクライアント側でのタイムアウトです。<varname>MongoCollection::$wtimeout</varname> はミリ秒です。</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook"><constant>E_DEPRECATED</constant> が発生します。</para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>これらのフィールドは、ドライバが自動生成したフィールドも上書きします。詳しい説明は、MongoDB コアドキュメントの <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">files collection</link> を参照ください。この挙動の現実的な使い道としては、ファイルの <literal>chunkSize</literal> や <literal>_id</literal> を独自に指定する場合などがあります。</para></note>'>
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">格納したファイルドキュメントの <literal>_id</literal> を返します。<parameter>metadata</parameter> パラメータで <literal>_id</literal> を明示的に指定していない場合は、自動生成した <classname>MongoId</classname> となります。</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>書き込みオプションの配列。<informaltable><thead><row><entry>キー</entry><entry>値</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry><link linkend="mongo.writeconcerns">WriteConcern</link> の値</entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">レプリケーションを待つ時間の最大値</link></entry></row><row><entry>ordered</entry><entry>MongoDB にこのバッチを順番どおりに実行させるのかどうかを指定する。順番どおりの書き込みはシリアルに (一度に一行ずつ) 実行され、最初にエラーが発生した時点で実行は中断する。順番どおりでない書き込みはパラレルに実行され、エラーが発生しても処理は中断しない。デフォルトは &true;</entry></row><row><entry>j (bool)</entry><entry>プライマリーへのジャーナリングを待つかどうか。これは非推奨なので、かわりに確認付き書き込みを使うこと</entry></row><row><entry>fsync (bool)</entry><entry>プライマリーへの fsync を待つかどうか。これは非推奨なので、かわりに確認付き書き込みを使うこと</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>バッチを実行する <classname>MongoCollection</classname>。<link linkend="mongo.writeconcerns">確認付き書き込み</link> をコピーして、デフォルトとして使います。<parameter>$write_options</parameter> で指定したり、<methodname>MongoWriteBatch::execute</methodname> で指定したりすることもできます。</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem><para>選んだサーバーについての基本情報を含む配列。<informaltable><tgroup cols="2"><thead><row><entry>キー</entry><entry>値</entry></row></thead><tbody><row><entry>hash</entry><entry>ハーバーハッシュ。例：<literal>localhost:27017;-;X;56052</literal></entry></row><row><entry>type</entry><entry>ノード型 (primary/secondary/mongos/arbiter)。例：<literal>2</literal></entry></row><row><entry>max_bson_size</entry><entry>このノードがネットワーク越しに受け付ける BSON の最大サイズ。例：<literal>16777216</literal></entry></row><row><entry>max_message_size</entry><entry>このノードがネットワーク越しに受け入れるメッセージの最大サイズ。例：<literal>48000000</literal></entry></row><row><entry>request_id</entry><entry>このメッセージのリクエスト識別子。例：<literal>42</literal></entry></row></tbody></tgroup></informaltable></para></listitem></varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem><para><informaltable><tgroup cols="2"><thead><row><entry>キー</entry><entry>値</entry></row></thead><tbody><row><entry>ordered</entry><entry>boolean で、バッチ操作をシーケンシャルに行う必要がある (orderd = true) かどうかを表します。</entry></row><row><entry>writeConcern</entry><entry>書き込み確認のオプションの配列 (以下を参照ください)</entry></row></tbody></tgroup></informaltable><table><title>書き込み確認の配列の値</title><tgroup cols="2"><thead><row><entry>キー</entry><entry>値</entry></row></thead><tbody><row><entry>fsync</entry><entry>boolean で、強制的にディスクへのフラッシュをしてから返します。</entry></row><row><entry>j</entry><entry>boolean で、強制的にジャーナルに書き出してから返します。</entry></row><row><entry>wtimeout</entry><entry>integer で、プライマリがレプリケーションの検証までに待つ最大の時間をミリ秒で指定します。</entry></row><row><entry>w</entry><entry>integer でサーバー数、あるいは文字列でレプリケーションタグを指定します。</entry></row></tbody></tgroup></table></para></listitem></varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para><informaltable><tgroup cols="2"><thead><row><entry>キー</entry><entry>値</entry></row></thead><tbody><row><entry>message_length</entry><entry>ネットワーク越しに送信するエンコード済みメッセージのサイズ (バイト数)。</entry></row><row><entry>request_id</entry><entry>このメッセージのリクエスト識別子。例：<literal>42</literal></entry></row><row><entry>namespace</entry><entry>プロトコルメッセージに使う、MongoDB 名前空間。例：<literal>dbname.collectionname</literal></entry></row></tbody></tgroup></informaltable></para></listitem></varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">このクラスを定義している拡張モジュールは非推奨です。
かわりに <link linkend="set.mongodb">MongoDB</link> 拡張モジュールを使うべきです。
このクラスの代替として、以下が使えます。</para>'>
<!ENTITY mongo.noalternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">このクラスを定義している拡張モジュールは非推奨です。
かわりに <link linkend="set.mongodb">MongoDB</link> 拡張モジュールを使うべきです。
このクラスの代替は、新しい拡張モジュールには存在しません。</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">このメソッドを定義している拡張モジュールは非推奨です。
かわりに <link linkend="set.mongodb">MongoDB</link> 拡張モジュールを使うべきです。
このメソッドの代替として、以下が使えます。</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">このメソッドを定義している拡張モジュールは非推奨です。
かわりに <link linkend="set.mongodb">MongoDB</link> 拡張モジュールを使うべきです。
このメソッドの代替は、新しい拡張モジュールには存在しません。</para>'>
<!ENTITY mongo.alternative.phplib.note '<para
xmlns="http://docbook.org/ns/docbook">このメソッドを定義している拡張モジュールは非推奨です。
かわりに <link linkend="set.mongodb">MongoDB</link> 拡張モジュールを使うべきです。
このメソッドの代替は、新しい拡張モジュールには存在しません。しかし、かわりに使える
<link linkend="mongodb.overview">PHP ライブラリ</link> があります。</para>'>

<!ENTITY mongo.deprecated.note '<para
xmlns="http://docbook.org/ns/docbook">この拡張モジュールは非推奨です。
かわりに <link linkend="set.mongodb">MongoDB</link> 拡張モジュールを使うべきです。</para>'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 1.15.0</entry>
        <entry>
         Return types for methods are declared as tentative on PHP 8.0 and newer,
         triggering deprecation notices in code that implements this interface
         without declaring the appropriate return types. The <code>#[ReturnTypeWillChange]</code>
         attribute can be added to silence the deprecation notice.
        </entry>
       </row>
'>

<!ENTITY mongodb.option.collation '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>collation</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> allows users to specify language-specific rules for string comparison, such as rules for lettercase and accent marks. When specifying collation, the <literal>"locale"</literal> field is mandatory; all other collation fields are optional. For descriptions of the fields, see <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Collation Document</link>.
           </para>
           <para>
            If the collation is unspecified but the collection has a default collation, the operation uses the collation specified for the collection. If no collation is specified for the collection or for the operation, MongoDB uses the simple binary comparison used in prior versions for string comparisons.
           </para>
           <para>
            This option is available in MongoDB 3.4+ and will result in an exception at execution time if specified for an older server version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Map of parameter names and values. Values must be constant or closed expressions that do not reference document fields. Parameters can then be accessed as variables in an aggregate expression context (e.g. <literal>$$var</literal>).
           </para>
           <para>
            This option is available in MongoDB 5.0+ and will result in an exception at execution time if specified for an older server version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>The Manager used to route data key queries to a separate MongoDB cluster. By default, the current Manager and cluster is used.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>) denoting the collection that contains all data keys used for encryption and decryption. This option is required.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            A document containing the configuration for one or more KMS providers, which are used to encrypt data keys. Supported providers include <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, <literal>"kmip"</literal>, and <literal>"local"</literal> and at least one must be specified.
           </para>
           <para>
            The format for <literal>"aws"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <para>
            The format for <literal>"azure"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // Defaults to "login.microsoftonline.com"
}
]]>
           </programlisting>
           <para>
            The format for <literal>"gcp"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // Defaults to "oauth2.googleapis.com"
}
]]>
           </programlisting>
           <para>
            The format for <literal>"kmip"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
            The format for <literal>"local"</literal> is as follows:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // 96-byte master key used to encrypt/decrypt data keys
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"aws"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Required. The Amazon Resource Name (ARN) to the AWS customer master key (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. An alternate host identifier to send KMS requests to. May include port number.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"azure"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Required. Host with optional port (e.g. "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional. A specific version of the named key. Defaults to using the key&apos;s primary version.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"gcp"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Required.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional. A specific version of the named key. Defaults to using the key&apos;s primary version.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. Host with optional port. Defaults to "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"kmip"</literal> provider options</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Optional. Unique identifier to a 96-byte KMIP secret data managed object. If unspecified, the driver creates a random 96-byte KMIP secret data managed object.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional. Host with optional port.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            A document containing the TLS configuration for one or more KMS providers. Supported providers include <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, and <literal>"kmip"</literal>. All providers support the following options:
           </para>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>,
    tlsDisableOCSPEndpointCheck: <optional bool>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>maxCommitTimeMS</entry>
          <entry>integer</entry>
          <entry>
           <para>
            The maximum amount of time in milliseconds to allow a single
            <literal>commitTransaction</literal> command to run.
           </para>
           <para>
            If specified, <literal>maxCommitTimeMS</literal> must be a signed
            32-bit integer greater than or equal to zero.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readConcern</entry>
          <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
          <entry>
           <para>
            A read concern to apply to the operation.
           </para>
           <para>
            This option is available in MongoDB 3.2+ and will result in an
            exception at execution time if specified for an older server
            version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readPreference '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readPreference</entry>
          <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
          <entry>
           <para>
            A read preference to use for selecting a server for the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.session '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>session</entry>
          <entry><classname>MongoDB\Driver\Session</classname></entry>
          <entry>
           <para>
            A session to associate with the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
     <warning xmlns="http://docbook.org/ns/docbook">
      <para>
       If you are using a <literal>"session"</literal> which has a transaction
       in progress, you cannot specify a <literal>"readConcern"</literal> or
       <literal>"writeConcern"</literal> option. This will result in an
       <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
       being thrown. Instead, you should set these two options when you create
       the transaction with
       <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
      </para>
     </warning>
'>
<!ENTITY mongodb.option.writeConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>writeConcern</entry>
          <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
          <entry>
           <para>
            A write concern to apply to the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>).
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      The name of the database on which to execute the command.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
    <listitem>
     <para>
      The write(s) to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
    <listitem>
     <para>
      The command to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
    <listitem>
     <para>
      The query to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <para>
      <link linkend="mongodb.persistence.typemaps">Type map configuration</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
    <listitem>
     <para>
      The <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">query predicate</link>.
      An empty predicate will match all documents in the collection.
     </para>
     <note>
      <simpara>
       When evaluating query criteria, MongoDB compares types and values according to its own <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">comparison rules for BSON types</link>, which differs from PHP&apos;s <link linkend="types.comparisons">comparison</link> and <link linkend="language.types.type-juggling">type juggling</link> rules. When matching a special BSON type the query criteria should use the respective <link linkend="book.bson">BSON class</link> (e.g. use <classname>MongoDB\BSON\ObjectId</classname> to match an <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
      </simpara>
     </note>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Returns <classname>MongoDB\Driver\Cursor</classname> on success.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Returns <classname>MongoDB\Driver\WriteResult</classname> on success.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> if the <literal>"session"</literal> option is used with an associated transaction in combination with a <literal>"readConcern"</literal> or <literal>"writeConcern"</literal> option.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> if the <literal>"session"</literal> option is used in combination with an unacknowledged write concern.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\BulkWriteException</classname> on any write failure (e.g. write error, failure to apply a write concern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> on argument parsing errors.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\AuthenticationException</classname> if authentication is needed and fails.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\ConnectionException</classname> if connection to the server fails (for reasons other than authentication).</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> if the input did not contain exactly one BSON document. Possible reasons include, but are not limited to, invalid BSON, extra data (after reading one BSON document), or an unexpected <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link> error.</member>'>

<!-- Not used in EN anymore -->
<!ENTITY mongodb.note.queryable-encryption-preview ''>

<!ENTITY mongodb.note.decimal128 '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     <classname>MongoDB\BSON\Decimal128</classname> is only compatible with
     MongoDB 3.4+. Attempting to use the BSON type with an earlier version of
     MongoDB will result in an error.
    </simpara>
   </note>
'>
<!ENTITY mongodb.note.extended-json '
  <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <simpara>
    The output is consistent with the <function>MongoDB\BSON\toJSON</function>
    function, which uses the driver-specific legacy extended JSON format. This
    does not necessarily match the
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxed</link>
    or <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canonical</link>
    extended JSON representations used by
    <function>MongoDB\BSON\toRelaxedExtendedJSON</function> and
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, respectively.
   </simpara>
  </note>
'>
<!ENTITY mongodb.note.forking '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     On Unix platforms, the MongoDB driver is sensitive to scripts that use the
     fork() system call without also calling exec(). Users are advised not to
     re-use <classname>MongoDB\Driver\Manager</classname> instances in a forked
     child process.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.uint32 '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Because PHP&apos;s integer type is signed, some values returned by this
    method may appear as negative integers on 32-bit platforms. The
    <literal>"&#37;u"</literal> formatter of <function>sprintf</function> may be
    used to obtain a string representation of the unsigned decimal value.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.readpreference '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    The <literal>"readPreference"</literal> option does not control the server
    to which the driver issues the operation; it will always be executed on
    this server object. Instead, it may be used when issuing the operation to a
    secondary (from a replica set connection, not standalone) or mongos node to
    ensure that the driver sets the wire protocol accordingly or adds the read
    preference to the operation, respectively.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.write '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    It is the caller&apos;s responsibility to ensure that the server is capable
    of executing the write operation. For example, executing a write operation
    on a secondary (excluding its "local" database) will fail.
   </simpara>
  </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     BSON documents can technically contain duplicate keys because documents are
     stored as a list of key-value pairs; however, applications should refrain
     from generating documents with duplicate keys as server and driver behavior
     may be undefined. Since PHP objects and arrays cannot have duplicate keys,
     data could also be lost when decoding a BSON document with duplicate keys.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>リクエストを <function>radius_create_request</function> で作ってからでないと、この関数は呼べません。</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>属性の型。</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>RADIUS リソース。</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>属性のオプションのビットマスク。使えるオプションには、<link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> や <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link> があります。</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>属性のタグ。<link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> が設定されていない限り、このパラメータは無視されます。</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>ベンダー ID。</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>file_descriptor</parameter></term>
 <listitem>
  <para>
   ファイル記述子。ファイルリソースか、あるいは <type>int</type> で指定します。
   <type>int</type> を指定した場合は、システムコールにそのまま渡せるファイル記述子だとみなします。
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
  各リソースには、それぞれソフトリミットとハードリミットがあります。
  ソフトリミットとは、そのリソースに対してカーネルが課す制限値のことです。
  ハードリミットとは、ソフトリミットの上限値のことです。
  特権を持たないプロセスは、ソフトリミットの値を 0 からハードリミット値の間で設定することが可能です。
  また、ハードリミットの値を下げることもできます。
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
 <para xmlns="http://docbook.org/ns/docbook">
  オプションの引数。文字を変換するときに使うエンコーディングを定義します。
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  省略した場合の <parameter>encoding</parameter> のデフォルト値は、
  <link linkend="ini.default-charset">default_charset</link> の値を使います。
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  技術的にはこの引数を省略可能ですが、
  <link linkend="ini.default-charset">default_charset</link>
  の指定が入力とは違う文字セットになっている可能性もあるので、
  適切な値を指定しておくことを強く推奨します。
 </para>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <para>
   0個以上のディレクティブで構成されるフォーマット文字列:

   変換結果に直接コピーされる通常文字列 (<literal>&#37;</literal> は除きます)
   と、<emphasis>変換仕様</emphasis>。
   これらのいずれも、自分が持つパラメータを取得します。
  </para>

  <para>
   変換の仕様は、以下のプロトタイプに従います:
   <literal>&#37;[argnum$][flags][width][.precision]specifier</literal>.
  </para>

  <formalpara>
   <title>Argnum</title>
   <para>
    何番目の引数を変換の対象にするかを指定するために、
    数値の後にドル記号 <literal>$</literal> を続けます。
   </para>
  </formalpara>
  
  <para>
   <table>
    <title>フラグ一覧</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>フラグ</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        与えられたフィールドの幅を左寄せにします。
        右寄せがデフォルトです。
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        正の数値の前に付ける <literal>+</literal> 符号です;
        デフォルトは、負の数にだけマイナスの符号が数値の前に付きます。
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(space)</entry>
       <entry>
        スペースに変換される詰め物です。
        これがデフォルトです。
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        数値の左側を0埋めします。
        <literal>s</literal> 指定子を使うと、
        右側にも0埋めできます。
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(char)</entry>
       <entry>
        指定された (char) で埋めます。
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <formalpara>
   <title>Width</title>
   <para>
    (最小で)何文字がこの変換結果に含まれるかを数値で指定するか、
    <literal>*</literal> を指定します。
    <literal>*</literal> を指定した場合、
    指定子によってフォーマットされる値の前に、
    幅を追加の数値として指定します。
   </para>
  </formalpara>

  <formalpara>
   <title>Precision</title>
   <para>
    ピリオド <literal>.</literal> の後に数値を続けるか、
    <literal>*</literal> を続けますが、
    その意味は指定子に依存します:
    <itemizedlist>
     <listitem>
      <simpara>
       <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> と <literal>F</literal>
       指定子の場合:
       小数点の後に表示する桁数 (デフォルトでは、この値は6です)
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <literal>g</literal>, <literal>G</literal>,
       <literal>h</literal>, <literal>H</literal> 指定子の場合:
       表示する最大の有効桁数
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <literal>s</literal> 指定子の場合:
       文字列を切り捨てる時点、つまり、文字列の最大の長さを設定します。
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      明示的に精度を指定せず、ピリオドを指定した場合、精度は0として扱われます。
      <literal>*</literal> を使った場合、
      精度は指定子によってフォーマットされる値の前に、
      追加の数値として指定します。
     </simpara>
    </note>
   </para>
  </formalpara>

  <para>
   <table>
    <title>指定子の一覧</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>指定子</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        文字通り、パーセント文字です。
        引数は不要です。
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        引数は整数として扱われ、2進数値として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        引数は整数として扱われ、ASCII文字として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
        引数は整数として扱われ、(符号付き)10進数値として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        引数は科学的記法で表現された値(e.g. 1.2e+2)として扱われます。
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        <literal>e</literal> 指定子に似ていますが、
        大文字を使います(e.g. 1.2E+2)
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        引数は小数として扱われ、浮動小数点数値として表現されます(ロケールを考慮します)。
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        引数は小数として扱われ、浮動小数点数値として表現されます(ロケールを考慮しません)。
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <para>
         汎用フォーマット
        </para>
        <para>
         P を精度を表す、ゼロでない値とします。
         精度が省略された場合、Pの値は6です。
         精度に0を指定した場合、Pの値は1になります。
         この場合、 <literal>E</literal> 指定子の変換結果は、
         X乗になります。
        </para>
        <para>
         P > X ≥ −4 の場合、<literal>E</literal>
         指定子の変換結果となり、精度は、P − (X + 1) になります。
         そうでない場合、<literal>e</literal> 指定子の変換結果となり、
         精度は、P - 1 になります。
        </para>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        <literal>g</literal> 指定子に似ていますが、
        <literal>E</literal> と <literal>f</literal> を使います。
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        <literal>g</literal> 指定子に似ていますが、
        <literal>F</literal> を使います。
        PHP 8.0.0 以降で利用可能です。
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        <literal>g</literal> 指定子に似ていますが、
        <literal>E</literal> と <literal>F</literal> を使います。
        PHP 8.0.0 以降で利用可能です。
       </entry>
      </row>
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        引数は整数として扱われ、8進数値として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        引数は文字列として扱われ、文字列として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        引数は整数として扱われ、符号なし10進数値として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        引数は整数として扱われ、16進数値(小文字)として表現されます。
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
        引数は整数として扱われ、16進数値(大文字)として表現されます。
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <warning>
   <para>
    <literal>c</literal> 指定子はパディングと幅を無視します
   </para>
  </warning>

  <warning>
   <para>
    文字列と width
    指定子を、1文字の表現に1バイト以上必要な文字セットと一緒に使おうとすると、
    期待しない結果になるかもしれません。
   </para>
  </warning>

  <para>
   値は、指定子の型に合うように強制されます:
   <table>
    <title>型のハンドリング</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>型</entry>
       <entry>指定子</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
       <parameter>string</parameter> を解釈するフォーマット。
       <function>sprintf</function> のドキュメントにある説明と比べて、以下の違いがあります。
       <simplelist>
        <member>
         ロケールに対応していません。
        </member>
        <member>
         <literal>F</literal>、<literal>g</literal>、<literal>G</literal> および
         <literal>b</literal> はサポートしていません。
        </member>
        <member>
         <literal>D</literal> は十進数値を表します。
        </member>
        <member>
         <literal>i</literal> は基数検出つきの整数値を表します。
        </member>
        <member>
         <literal>n</literal> は処理する文字数を表します。
        </member>
        <member>
         <literal>s</literal> は、空白文字を読み取ると停止することを示します。
        </member>
        <member>
         <literal>argnum$</literal> の代わりに
         <literal>*</literal> を指定すると、
         この変換仕様に従った値の代入を抑制します。
        </member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
 <para xmlns="http://docbook.org/ns/docbook">
  PHP 8.0.0 より前のバージョンでは、<parameter>needle</parameter> が文字列でない場合、
  数値に変換され、文字の通常の値として扱われていました。
  この振る舞いは PHP 7.3.0 以降では推奨されないので、
  この機能を使用しないことを強く推奨します。
  意図した動作に依存する場合、
  <parameter>needle</parameter> を string に明示的にキャストするか、
  明示的に <function>chr</function> 関数を呼び出すべきでしょう。 
 </para>
'>

<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> は、空文字列を受け入れるようになりました。
 </entry>
</row>'>

<!ENTITY strings.changelog.encoding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>5.6.0</entry>
  <entry>
   <parameter>encoding</parameter> パラメータのデフォルト値が、
   <link linkend="ini.default-charset">default_charset</link> の設定値に変わりました。
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-conversion '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   ケース変換は、<function>setlocale</function>
   で設定されたロケールに依存しなくなりました。
   ASCII 文字のみが変換されます。
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   ケースフォールディングは、<function>setlocale</function>
   で設定されたロケールに依存しなくなりました。
   ASCII のケースフォールディングのみが行われます。
   ASCII でないバイト列は、バイト値として比較されます。
  </entry>
 </row>
'>

<!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       この関数は、失敗時に &false; を返さなくなりました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       引数の数が0だった場合、
       <classname>ValueError</classname> がスローされるようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <literal>[width]</literal> の値が0より小さかったり、
       <constant>PHP_INT_MAX</constant> より大きい場合に、
       <classname>ValueError</classname> をスローするようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <literal>[precision]</literal> の値が0より小さかったり、
       <constant>PHP_INT_MAX</constant> より大きい場合に、
       <classname>ValueError</classname> をスローするようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       引数が必要な数より少なかった場合、
       <classname>ArgumentCountError</classname>
       がスローされるようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.changelog.vsprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       この関数は、失敗時に &false; を返さなくなりました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       引数の数が0だった場合、
       <classname>ValueError</classname> がスローされるようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <literal>[width]</literal> の値が0より小さかったり、
       <constant>PHP_INT_MAX</constant> より大きい場合に、
       <classname>ValueError</classname> をスローするようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <literal>[precision]</literal> の値が0より小さかったり、
       <constant>PHP_INT_MAX</constant> より大きい場合に、
       <classname>ValueError</classname> をスローするようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       引数が必要な数より少なかった場合、
       <classname>ValueError</classname>
       がスローされるようになりました。
       これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
       を発生させていました。
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.errors.sprintf '
  <para xmlns="http://docbook.org/ns/docbook">
 　PHP 8.0.0 以降では、
   引数の数が0の場合に <classname>ValueError</classname>
   がスローされます。
   これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
   を発生させていました。
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   PHP 8.0.0 以降では、
   <literal>[width]</literal> の値が0より小さかったり、
   <constant>PHP_INT_MAX</constant> より大きい場合に、
   <classname>ValueError</classname> がスローされます。
   これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
   を発生させていました。
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   PHP 8.0.0 以降では、
   <literal>[precision]</literal> の値が0より小さかったり、
   <constant>PHP_INT_MAX</constant> より大きい場合に、
   <classname>ValueError</classname> がスローされます。
   これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
   を発生させていました。
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   PHP 8.0.0 以降では、
   引数が必要な数より少なかった場合、
   <classname>ArgumentCountError</classname>
   がスローされます。
   これより前のバージョンでは、代わりに &false; を返し、<constant>E_WARNING</constant>
   を発生させていました。
  </para>
'>

<!ENTITY strings.errors.vsprintf '
  <para xmlns="http://docbook.org/ns/docbook">
 　PHP 8.0.0 以降では、
   引数の数が0の場合に <classname>ValueError</classname>
   がスローされます。
   これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
   を発生させていました。
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   PHP 8.0.0 以降では、
   <literal>[width]</literal> の値が0より小さかったり、
   <constant>PHP_INT_MAX</constant> より大きい場合に、
   <classname>ValueError</classname> がスローされます。
   これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
   を発生させていました。
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   PHP 8.0.0 以降では、
   <literal>[precision]</literal> の値が0より小さかったり、
   <constant>PHP_INT_MAX</constant> より大きい場合に、
   <classname>ValueError</classname> がスローされます。
   これより前のバージョンでは、代わりに <constant>E_WARNING</constant>
   を発生させていました。
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   PHP 8.0.0 以降では、
   引数が必要な数より少なかった場合、
   <classname>ValueError</classname> がスローされます。
   これより前のバージョンでは、代わりに &false; を返し、<constant>E_WARNING</constant>
   を発生させていました。
  </para>
'>

<!-- filter snippets -->
<!ENTITY filter.param.filter '
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>filter</parameter></term>
  <listitem>
   <para>
    適用するフィルタの ID。<xref linkend="filter.filters" />
    に、利用できるフィルタの一覧があります。
   </para>
   <para>
    省略した場合は <constant>FILTER_DEFAULT</constant> を使います。これは
    <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link> と同等です。
    結果的に、デフォルトでは何もフィルタリングをしません。
   </para>
  </listitem>
 </varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
 この関数が使う不規則性のソースは、優先度順に以下のとおりです:
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <listitem>
  <para>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </para>
  <para>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </para>
 </listitem>
 <listitem>
  <para>
   macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22 CCRandomGenerateBytes がコンパイル時に利用可能な場合): CCRandomGenerateBytes()
  </para>
  <para>
   macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <simpara>
   上記にあてはまらないオペレーティングシステムやPHP のバージョンの場合: <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   どの不規則性のソースも利用できなかったり、
   すべてのソースがランダムな値を生成できなかった場合、
   <classname>Random\RandomException</classname> がスローされます。
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   適切な不規則性のソースが見つからない場合は
   <classname>Random\RandomException</classname> をスローします。
  </simpara>
 </listitem>
'>
<!ENTITY csprng.function.backport '
 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   この関数は PHP 7.0 で追加されたものですが、PHP 5.2 から 5.6 までのバージョンで使える
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">ユーザーランドの実装</link>
   も公開されています。
  </simpara>
 </note>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
    <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link> に存在する
    <methodname>Random\Engine::generate</methodname> メソッド
    がスローした、あらゆる <classname>Throwable</classname> がスローされます。
  </simpara>
 </listitem>
'>

<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>この関数は、PECL uopz 5.0.0 で
<emphasis>削除</emphasis> されました。</simpara></warning>'>

<!-- XML snippets -->

<!ENTITY xml.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <para>
   XMLパーサ
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 &null; や空文字列を渡すと、ハンドラはデフォルトの状態にリセットされます。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 <parameter>handler</parameter> が <type>callable</type> の場合、その callable がハンドラとして設定されます。
</para>
<para xmlns="http://docbook.org/ns/docbook">
 <parameter>handler</parameter> が文字列の場合、<function>xml_set_object</function> で設定されたオブジェクトのメソッド名になります。
</para>'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   ハンドラをコールするXMLパーサ
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  引数 <parameter>parser</parameter> は、
  <classname>XMLParser</classname> インスタンスを期待するようになりました。
  これより前のバージョンでは、有効な <literal>xml</literal> <type>resource</type> が期待されていました。
 </entry>
</row>'>

<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
   <para xmlns="http://docbook.org/ns/docbook">
    暗号化されたすべてのクライアントストリームで、ピア検証がデフォルトで有効になりました。
    デフォルトでは、OpenSSL のデフォルト CA バンドルを使ってピア証明書を検証します。
    たいていの場合は、正しい SSL 証明書を持つサーバーと通信するならこれを変更する必要はありません。
    OpenSSL が、よく知られた CA バンドルを使うように設定されているからです。
   </para>
   
   <para xmlns="http://docbook.org/ns/docbook">
    デフォルトの CA バンドルを上書きすることもできます。
    openssl.cafile あるいは openssl.capath を設定すればグローバルに変更でき、コンテキストオプション
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> あるいは
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>
    を使えばリクエスト単位で変更できます。
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    一般的にはおすすめできませんが、
    コンテキストオプション
    <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
    を &false; にしてリクエストでのピア証明書の検証を無効化することもできます。
    また同じく、ピア名の検証も、コンテキストオプション
    <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
    を &false; にすれば無効化できます。
   </para>
'>

<!-- 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: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->