cvs: phpdoc-ja /appendices wrappers.xml /internals/zendapi creating.xml /reference/gmp/functions gmp-div-q.xml /reference/pdo constants.xml

takagi Sat Sep 23 06:26:37 2006 UTC Modified files: /phpdoc-ja/reference/pdo constants.xml /phpdoc-ja/reference/gmp/functions gmp-div-q.xml /phpdoc-ja/internals/zendapi creating.xml /phpdoc-ja/appendices wrappers.xml Log: sync with en.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/pdo/constants.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-ja/reference/pdo/constants.xml diff -u phpdoc-ja/reference/pdo/constants.xml:1.11 phpdoc-ja/reference/pdo/constants.xml:1.12 --- phpdoc-ja/reference/pdo/constants.xml:1.11 Fri May 5 05:27:15 2006 +++ phpdoc-ja/reference/pdo/constants.xml Sat Sep 23 06:26:37 2006 @@ -1,6 +1,6 @@ <?xml version='1.0' encoding='utf-8'?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.15 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.17 Maintainer: shimooka Status: ready --> <!-- CREDITS: hirokawa --> <section id="pdo.constants"> &reftitle.constants; @@ -281,7 +281,7 @@ </term> <listitem> <simpara> - + PHP 5.2.0 以降で使用可能です。 </simpara> </listitem> </varlistentry> @@ -509,7 +509,7 @@ </term> <listitem> <simpara> - + PHP 5.2.0 以降で使用可能です。 </simpara> </listitem> </varlistentry> @@ -594,7 +594,7 @@ </varlistentry> <varlistentry> <term> - <constant>PDO::PDO_NULL_NATURAL</constant> + <constant>PDO::NULL_NATURAL</constant> (<type>integer</type>) </term> <listitem> @@ -605,7 +605,7 @@ </varlistentry> <varlistentry> <term> - <constant>PDO::PDO_NULL_EMPTY_STRING</constant> + <constant>PDO::NULL_EMPTY_STRING</constant> (<type>integer</type>) </term> <listitem> @@ -616,7 +616,7 @@ </varlistentry> <varlistentry> <term> - <constant>PDO::PDO_NULL_TO_STRING</constant> + <constant>PDO::NULL_TO_STRING</constant> (<type>integer</type>) </term> <listitem> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/gmp/functions/gmp-div-q.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-ja/reference/gmp/functions/gmp-div-q.xml diff -u phpdoc-ja/reference/gmp/functions/gmp-div-q.xml:1.5 phpdoc-ja/reference/gmp/functions/gmp-div-q.xml:1.6 --- phpdoc-ja/reference/gmp/functions/gmp-div-q.xml:1.5 Fri Nov 11 21:15:54 2005 +++ phpdoc-ja/reference/gmp/functions/gmp-div-q.xml Sat Sep 23 06:26:37 2006 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./ja/functions/gmp.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.4 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> <refentry id="function.gmp-div-q"> <refnamediv> <refname>gmp_div_q</refname> @@ -74,7 +74,7 @@ 0 1 0 -1 +-1 ]]> </screen> </example> http://cvs.php.net/viewvc.cgi/phpdoc-ja/internals/zendapi/creating.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-ja/internals/zendapi/creating.xml diff -u phpdoc-ja/internals/zendapi/creating.xml:1.1 phpdoc-ja/internals/zendapi/creating.xml:1.2 --- phpdoc-ja/internals/zendapi/creating.xml:1.1 Fri May 5 05:28:26 2006 +++ phpdoc-ja/internals/zendapi/creating.xml Sat Sep 23 06:26:37 2006 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <sect1 id="zend.creating"> <title>拡張モジュールの作成</title> <para> @@ -147,7 +147,7 @@ </row> <row> <entry colname="col1">コンパイル</entry> - <entry colname="col2">cc -fpic -DCOMPILE_DL=1 -I/usr/local/include -I. + <entry colname="col2">cc -fpic -DCOMPILE_DL_FIRST_MODULE=1 -I/usr/local/include -I. -I.. -I../Zend -c -o <filename>&lt;your_object_file&gt;</filename> <filename>&lt;your_c_file&gt;</filename></entry> </row> @@ -163,7 +163,7 @@ モジュールをコンパイルするためのコマンドでは、コンパイラに対して 位置独立なコードを出力するように指示しています (<literal>-fpic</literal> は省略できません)。 - また、定数 <literal>COMPILE_DL</literal> を指定することで、 + また、定数 <literal>COMPILE_DL_FIRST_MODULE</literal> を指定することで、 モジュールのコードを動的ロード可能なモジュールとしてコンパイルするようにしています (上のテストモジュールではこれをチェックしています。これについては後で説明します)。 これらのオプションに続いて、ソースファイルをコンパイルするために必要な http://cvs.php.net/viewvc.cgi/phpdoc-ja/appendices/wrappers.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-ja/appendices/wrappers.xml diff -u phpdoc-ja/appendices/wrappers.xml:1.16 phpdoc-ja/appendices/wrappers.xml:1.17 --- phpdoc-ja/appendices/wrappers.xml:1.16 Sun Aug 13 00:31:31 2006 +++ phpdoc-ja/appendices/wrappers.xml Sat Sep 23 06:26:37 2006 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.62 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.65 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi --> <appendix id="wrappers"> <title>サポートされるプロトコル/ラッパー</title> @@ -611,19 +611,16 @@ <section id="wrappers.php"> <title>PHP 入出力ストリーム</title> - <simpara> - PHP 3.0.13 以降で、<filename>php://output</filename>。 - および PHP 4.3.0 以降で <filename>php://input</filename>、 - PHP 5.0.0 以降で <filename>php://filter</filename> - </simpara> - + <itemizedlist> <listitem><simpara><filename>php://stdin</filename></simpara></listitem> <listitem><simpara><filename>php://stdout</filename></simpara></listitem> <listitem><simpara><filename>php://stderr</filename></simpara></listitem> <listitem><simpara><filename>php://output</filename></simpara></listitem> <listitem><simpara><filename>php://input</filename></simpara></listitem> - <listitem><simpara><filename>php://filter</filename></simpara></listitem> + <listitem><simpara><filename>php://filter</filename> (PHP 5.0.0 以降で使用可能)</simpara></listitem> + <listitem><simpara><filename>php://memory</filename> (PHP 5.1.0 以降で使用可能)</simpara></listitem> + <listitem><simpara><filename>php://temp</filename> (PHP 5.1.0 以降で使用可能)</simpara></listitem> </itemizedlist> <simpara> @@ -736,6 +733,43 @@ </simpara> </listitem> </itemizedlist> + + <simpara> + <filename>php://memory</filename> ラッパーは、データをメモリに保存します。 + <filename>php://temp</filename> も同様ですが、メモリの制限 + (デフォルトは 2 MB です) を超過した際にはテンポラリファイルを使用します。 + </simpara> + <simpara> + <filename>php://temp</filename> ラッパーは、次の + 'parameters' を 'path' の一部として受け付けます。 + </simpara> + <itemizedlist> + <listitem> + <para> + <literal>/maxmemory:&lt;バイト数&gt;</literal> + (<emphasis>任意</emphasis>) + このパラメータは、メモリの制限 (データをテンポラリファイルに移動する閾値) + のデフォルト値を変更します。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +$fiveMBs = 5 * 1024 * 1024; +$fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+'); + +fputs($fp, "hello\n"); + +// 先ほど書き込んだデータを読み込みます。 +rewind($fp); +echo stream_get_contents($fp); +?> +]]> + </programlisting> + </informalexample> + </para> + </listitem> + </itemizedlist> + <para> <table> <title> @@ -757,33 +791,45 @@ <row> <entry>読み込み許可</entry> <entry> - <literal>php://stdin</literal> および - <literal>php://input</literal> のみ。 + <literal>php://stdin</literal>、 + <literal>php://input</literal>、 + <literal>php://memory</literal> および + <literal>php://temp</literal> のみ。 </entry> </row> <row> <entry>書き込み許可</entry> <entry> <literal>php://stdout</literal>、 - <literal>php://stderr</literal> および - <literal>php://output</literal> のみ。 + <literal>php://stderr</literal>、 + <literal>php://output</literal>、 + <literal>php://memory</literal> および + <literal>php://temp</literal> のみ。 </entry> </row> <row> <entry>追加許可</entry> <entry> <literal>php://stdout</literal>、 - <literal>php://stderr</literal> および - <literal>php://output</literal> のみ（書き込みと同じ）。 + <literal>php://stderr</literal>、 + <literal>php://output</literal>、 + <literal>php://memory</literal> および + <literal>php://temp</literal> のみ (書き込みと同じ)。 </entry> </row> <row> <entry>同時読み書き許可</entry> - <entry>No. これらのラッパーは一方通行です。</entry> + <entry> + <literal>php://memory</literal> および + <literal>php://temp</literal> のみ。 + </entry> </row> <row> <entry><function>stat</function> のサポート</entry> - <entry>No</entry> + <entry> + <literal>php://memory</literal> および + <literal>php://temp</literal> のみ。 + </entry> </row> <row> <entry><function>unlink</function> のサポート</entry> @@ -895,6 +941,100 @@ </table> </para> </section> + + <section id="wrappers.data"> + <title>データ (RFC 2397)</title> + <simpara> + <filename>data:</filename> (<ulink url="&url.rfc;2397">RFC + 2397</ulink>) ストリームラッパーは、 PHP 5.2.0 + 以降で使用可能です。 + </simpara> + + <example> + <title>data:// の内容の表示</title> + <programlisting role="php"> +<![CDATA[ +<?php +// "I love PHP" と表示します +echo file_get_contents('data://text/plain;base64,SSBsb3ZlIFBIUAo='); +?> +]]> + </programlisting> + </example> + + <example> + <title>media type の取得</title> + <programlisting role="php"> +<![CDATA[ +<?php +$fp = fopen('data://text/plain;base64,', 'r'); +$meta = stream_get_meta_data($fp); + +// "text/plain" と表示します +echo $meta['mediatype']; +?> +]]> + </programlisting> + </example> + + + <para> + <table> + <title>ラッパーの概要</title> + <tgroup cols="2"> + <thead> + <row> + <entry>属性</entry> + <entry>サポートの有無</entry> + </row> + </thead> + <tbody> + <row> + <entry><link linkend="ini.allow-url-fopen">allow_url_fopen</link> で制約される</entry> + <entry>No</entry> + </row> + <row> + <entry>読み込み許可</entry> + <entry>Yes</entry> + </row> + <row> + <entry>書き込み許可</entry> + <entry>No</entry> + </row> + <row> + <entry>追加許可</entry> + <entry>No</entry> + </row> + <row> + <entry>同時読み書き許可</entry> + <entry>No</entry> + </row> + <row> + <entry><function>stat</function> のサポート</entry> + <entry>No</entry> + </row> + <row> + <entry><function>unlink</function> のサポート</entry> + <entry>No</entry> + </row> + <row> + <entry><function>rename</function> のサポート</entry> + <entry>No</entry> + </row> + <row> + <entry><function>mkdir</function> のサポート</entry> + <entry>No</entry> + </row> + <row> + <entry><function>rmdir</function> のサポート</entry> + <entry>No</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </section> + <section id="wrappers.ssh2"> <title>SSH2</title> <simpara>