cvs: phpdoc-ja /appendices ini.xml /features safe-mode.xml /internals2/buildsys environment.xml index.xml intro.xml skeleton.xml /language/oop5
reflection.xml /reference/filter reference.xml /reference/gnupg reference.xml /reference/image/functions getimagesize.xml
/reference/mcrypt/functions mcrypt-module-open.xml

takagi Mon Jun 18 20:11:44 2007 UTC Added files: /phpdoc-ja/internals2/buildsys skeleton.xml Removed files: /phpdoc-ja/internals2/buildsys intro.xml Modified files: /phpdoc-ja/reference/mcrypt/functions mcrypt-module-open.xml /phpdoc-ja/reference/image/functions getimagesize.xml /phpdoc-ja/reference/gnupg reference.xml /phpdoc-ja/reference/filter reference.xml /phpdoc-ja/language/oop5 reflection.xml /phpdoc-ja/internals2/buildsys index.xml environment.xml /phpdoc-ja/features safe-mode.xml /phpdoc-ja/appendices ini.xml Log: sync with en.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mcrypt/functions/mcrypt-module-open.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-ja/reference/mcrypt/functions/mcrypt-module-open.xml diff -u phpdoc-ja/reference/mcrypt/functions/mcrypt-module-open.xml:1.4 phpdoc-ja/reference/mcrypt/functions/mcrypt-module-open.xml:1.5 --- phpdoc-ja/reference/mcrypt/functions/mcrypt-module-open.xml:1.4 Sat Oct 22 00:55:12 2005 +++ phpdoc-ja/reference/mcrypt/functions/mcrypt-module-open.xml Mon Jun 18 20:11:43 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/mcrypt.xml, last change in rev 1.17 --> -<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> <refentry id="function.mcrypt-module-open"> <refnamediv> <refname>mcrypt_module_open</refname> @@ -104,13 +104,6 @@ </example> </para> <para> - 上の例の最初の行では、デフォルトのディレクトリから DES 暗号化を、 - そして <filename>/usr/lib/mcrypt-modes</filename> から EBC モードの - オープンを試みます。2 行目の例では暗号化形式とモードを文字列で - 指定しています。これは、libmcrypt 2.4.x あるいは 2.5.x に対して - 拡張モジュールがリンクされている場合にのみ使用可能です。 - </para> - <para> <function>mcrypt_module_close</function>、 <function>mcrypt_generic</function>、 <function>mdecrypt_generic</function>、 http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/image/functions/getimagesize.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-ja/reference/image/functions/getimagesize.xml diff -u phpdoc-ja/reference/image/functions/getimagesize.xml:1.8 phpdoc-ja/reference/image/functions/getimagesize.xml:1.9 --- phpdoc-ja/reference/image/functions/getimagesize.xml:1.8 Mon Feb 19 17:12:12 2007 +++ phpdoc-ja/reference/image/functions/getimagesize.xml Mon Jun 18 20:11:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.29 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.31 Maintainer: hirokawa Status: ready --> <!-- CREDITS: shimooka --> <refentry id="function.getimagesize"> <refnamediv> @@ -132,6 +132,9 @@ もしくは有効な画像でない場合、<function>getimagesize</function> は &false; を返し、<constant>E_WARNING</constant> レベルのエラーを発生させます。 + 読み込み時にエラーが発生した場合は、 + <function>getimagesize</function> は + <constant>E_NOTICE</constant> レベルのエラーを発生させます。 </para> </refsect1> <refsect1 role="changelog"> @@ -147,6 +150,14 @@ </thead> <tbody> <row> + <entry>5.2.3</entry> + <entry> + 読み込み時にエラーが発生した場合のエラーレベルが、 + <constant>E_WARNING</constant> から + <constant>E_NOTICE</constant> に変わりました。 + </entry> + </row> + <row> <entry>4.3.2</entry> <entry> <acronym>JPC</acronym>, <acronym>JP2</acronym>, http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/gnupg/reference.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-ja/reference/gnupg/reference.xml diff -u phpdoc-ja/reference/gnupg/reference.xml:1.4 phpdoc-ja/reference/gnupg/reference.xml:1.5 --- phpdoc-ja/reference/gnupg/reference.xml:1.4 Sun Jun 17 03:32:00 2007 +++ phpdoc-ja/reference/gnupg/reference.xml Mon Jun 18 20:11:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.6 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: takagi Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: pecl --> <!-- State: beta --> @@ -14,7 +14,6 @@ <para> このモジュールにより、<ulink url="http://www.gnupg.org/">gnupg</ulink> を扱うことが可能となります。 -<!--&warn.experimental;--> </para> </section> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/filter/reference.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-ja/reference/filter/reference.xml diff -u phpdoc-ja/reference/filter/reference.xml:1.7 phpdoc-ja/reference/filter/reference.xml:1.8 --- phpdoc-ja/reference/filter/reference.xml:1.7 Sat Jun 16 11:14:35 2007 +++ phpdoc-ja/reference/filter/reference.xml Mon Jun 18 20:11:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.9 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.10 Maintainer: takagi Status: ready --> <!-- Purpose: basic.vartype --> <!-- Membership: pecl --> <!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. --> @@ -21,7 +21,7 @@ の節を参照ください。 <table> <title>存在するフィルタ</title> - <tgroup cols="4"> + <tgroup cols="5"> <thead> <row> <entry>ID</entry> @@ -49,11 +49,20 @@ <entry><constant>FILTER_VALIDATE_BOOLEAN</constant></entry> <entry>"boolean"</entry> <entry></entry> - <entry></entry> <entry> - "1"、"true"、"on" および "yes" の場合に &true;、 - "0"、"false"、"off"、"no" および "" の場合に &false;、 - そしてそれ以外の場合に &null; を返します。 + <constant>FILTER_NULL_ON_FAILURE</constant> + </entry> + <entry> + <para> + "1"、"true"、"on" および "yes" の場合に &true;、 + それ以外の場合に &false; を返します。 + </para> + <para> + <constant>FILTER_NULL_ON_FAILURE</constant> が設定されている場合は、 + &false; が返されるのは + "0"、"false"、"off"、"no" および "" の場合のみとなります。 + boolean 以外の値については &null; を返します。 + </para> </entry> </row> <row> http://cvs.php.net/viewvc.cgi/phpdoc-ja/language/oop5/reflection.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-ja/language/oop5/reflection.xml diff -u phpdoc-ja/language/oop5/reflection.xml:1.16 phpdoc-ja/language/oop5/reflection.xml:1.17 --- phpdoc-ja/language/oop5/reflection.xml:1.16 Tue May 29 23:43:26 2007 +++ phpdoc-ja/language/oop5/reflection.xml Mon Jun 18 20:11:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.22 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.23 Maintainer: hirokawa Status: ready --> <!-- CREDITS: shimooka --> <sect1 id="language.oop5.reflection"> @@ -138,7 +138,7 @@ class ReflectionFunction extends ReflectionFunctionAbstract implements Reflector { final private __clone() - public object __construct(string name) + public void __construct(string name) public string __toString() public static string export(string name, bool return) public string getName() @@ -248,7 +248,7 @@ class ReflectionParameter implements Reflector { final private __clone() - public object __construct(string function, string parameter) + public void __construct(string function, string parameter) public string __toString() public static string export(mixed function, mixed parameter, bool return) public string getName() @@ -337,7 +337,7 @@ class ReflectionClass implements Reflector { final private __clone() - public object __construct(string name) + public void __construct(string name) public string __toString() public static string export() public string getName() @@ -510,7 +510,7 @@ class ReflectionObject extends ReflectionClass { final private __clone() - public object __construct(mixed object) + public void __construct(mixed object) public string __toString() public static string export(mixed object, bool return) } @@ -532,7 +532,7 @@ <?php class ReflectionMethod extends ReflectionFunctionAbstract implements Reflector { - public __construct(mixed class, string name) + public void __construct(mixed class, string name) public string __toString() public static string export(mixed class, string name, bool return) public mixed invoke(stdclass object, mixed args) @@ -665,7 +665,7 @@ class ReflectionProperty implements Reflector { final private __clone() - public __construct(mixed class, string name) + public void __construct(mixed class, string name) public string __toString() public static string export(mixed class, string name, bool return) public string getName() @@ -755,7 +755,7 @@ <?php class ReflectionExtension implements Reflector { final private __clone() - public __construct(string name) + public void __construct(string name) public string __toString() public static string export(string name, bool return) public string getName() http://cvs.php.net/viewvc.cgi/phpdoc-ja/internals2/buildsys/index.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-ja/internals2/buildsys/index.xml diff -u phpdoc-ja/internals2/buildsys/index.xml:1.1 phpdoc-ja/internals2/buildsys/index.xml:1.2 --- phpdoc-ja/internals2/buildsys/index.xml:1.1 Sun Jun 17 07:40:44 2007 +++ phpdoc-ja/internals2/buildsys/index.xml Mon Jun 18 20:11:43 2007 @@ -1,10 +1,20 @@ <?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 --> <chapter id="internals2.buildsys"> <title>PHP 5 ビルドシステム</title> - &internals2.buildsys.intro; + + <para> + PHP 5 のさまざまな機能と柔軟性を考えると、それが何千ものファイルの + 何百万行というコードから出来上がっていると聞いても驚かないことでしょう。 + また、そのようなデータを管理するには + 何らかのビルドシステムが必要となるのも無理もないことです。 + このセクションでは、拡張モジュール開発用に PHP をセットアップする方法や + PHP ソースツリー内における拡張モジュールの配置、 + そして拡張モジュールをビルドする方法を説明します。 + </para> + &internals2.buildsys.environment; &internals2.buildsys.skeleton; &internals2.buildsys.configunix; http://cvs.php.net/viewvc.cgi/phpdoc-ja/internals2/buildsys/environment.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-ja/internals2/buildsys/environment.xml diff -u phpdoc-ja/internals2/buildsys/environment.xml:1.1 phpdoc-ja/internals2/buildsys/environment.xml:1.2 --- phpdoc-ja/internals2/buildsys/environment.xml:1.1 Sun Jun 17 21:45:31 2007 +++ phpdoc-ja/internals2/buildsys/environment.xml Mon Jun 18 20:11:43 2007 @@ -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="internals2.buildsys.environment"> <title>拡張モジュール開発用に PHP をビルドする方法</title> <para> @@ -31,14 +31,6 @@ ]]> </programlisting> </para> - - <note> - <para> - Windows システムでは <literal>--enable-maintainer-zts</literal> フラグは不要です。 - Windows では常にスレッドセーフとなるからです。 - 同様に、常に有効となる設定が他にもいくつかあります。 - </para> - </note> </sect1> <!-- Write this later? http://cvs.php.net/viewvc.cgi/phpdoc-ja/features/safe-mode.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc-ja/features/safe-mode.xml diff -u phpdoc-ja/features/safe-mode.xml:1.21 phpdoc-ja/features/safe-mode.xml:1.22 --- phpdoc-ja/features/safe-mode.xml:1.21 Sat Jun 16 07:34:35 2007 +++ phpdoc-ja/features/safe-mode.xml Mon Jun 18 20:11:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.21 $ --> -<!-- EN-Revision: 1.67 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.22 $ --> +<!-- EN-Revision: 1.68 Maintainer: hirokawa Status: ready --> <!-- CREDITS: shimooka --> <chapter id="features.safe-mode"> <title>セーフモード</title> @@ -380,7 +380,7 @@ もし&php.ini;ファイルに以下を追加した場合: <programlisting role="ini"> <![CDATA[ -disable_functions readfile,system +disable_functions = readfile,system ]]> </programlisting> 以下のような結果になります: http://cvs.php.net/viewvc.cgi/phpdoc-ja/appendices/ini.xml?r1=1.31&r2=1.32&diff_format=u Index: phpdoc-ja/appendices/ini.xml diff -u phpdoc-ja/appendices/ini.xml:1.31 phpdoc-ja/appendices/ini.xml:1.32 --- phpdoc-ja/appendices/ini.xml:1.31 Thu May 24 22:10:06 2007 +++ phpdoc-ja/appendices/ini.xml Mon Jun 18 20:11:43 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.31 $ --> -<!-- EN-Revision: 1.55 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.32 $ --> +<!-- EN-Revision: 1.56 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi, shimooka --> <appendix id="ini"> @@ -3184,6 +3184,16 @@ これは、この例におけるディレクティブの設定で <literal>P</literal> が <literal>G</literal> より後になっているからです。 </para> + <warning> + <para> + CGI および FastCGI SAPI の両方で、 + <link linkend="reserved.variables.server">$_SERVER</link> + にも環境変数の値が格納されます。 + つまり、<literal>S</literal> を指定すると、 + <literal>ES</literal> と指定したのと同じ意味になります。 + これは、<literal>E</literal> が他のどこかで指定されていたとしても同じです。 + </para> + </warning> <note> <para> <link linkend="reserved.variables.request">$_REQUEST</link> http://cvs.php.net/viewvc.cgi/phpdoc-ja/internals2/buildsys/skeleton.xml?view=markup&rev=1.1 Index: phpdoc-ja/internals2/buildsys/skeleton.xml +++ phpdoc-ja/internals2/buildsys/skeleton.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <sect1 id="internals2.buildsys.skeleton"> <title>ext_skel スクリプト</title> <para> Zend 拡張モジュールには、共通に含まれるファイルがいくつかあります。 その多くは拡張モジュールの種類に関わらずほぼ同じ内容ですが、 毎回それをコピーするのは面倒です。 幸いなことに、そのような初期作業を代わりに行ってくれるスクリプトがあります。 それが <filename>ext_skel</filename> で、 PHP 4.0 以降に同梱されています。 </para> <para> PHP 5.2.2 で、何もパラメータを指定せずに <filename>ext_skel</filename> を実行した結果は、次のようになります。 <screen> <![CDATA[ php-5.2.2/ext$ ./ext_skel ../ext_skel --extname=module [--proto=file] [--stubs=file] [--xml[=file]] [--skel=dir] [--full-xml] [--no-help] --extname=module module is the name of your extension --proto=file file contains prototypes of functions to create --stubs=file generate only function stubs in file --xml generate xml documentation to be added to phpdoc-cvs --skel=dir path to the skeleton directory --full-xml generate xml documentation for a self-contained extension (not yet implemented) --no-help don't try to be nice and create comments in the code and helper functions to test if the module compiled ]]> </screen> 一般に、新しい拡張モジュールを開発する際に使うであろうパラメータは <literal>--extname</literal> と <literal>--no-help</literal> のみです。 拡張モジュールの構成に慣れるまでは、 <literal>--no-help</literal> を指定しないようにしましょう。 そうすることで、<filename>ext_skel</filename> が生成するファイルに有用なコメントがたくさん含められるようになります。 </para> <para> 残ったオプションは <literal>--extname</literal> です。 これは、作成する拡張モジュールの名前を <filename>ext_skel</filename> に伝えるためのものです。ここで指定する名前は、すべて小文字からなるものです。 使用できる文字は英字とアンダースコアのみで、PHP の <filename>ext/</filename> フォルダ配下で一意なものでなければなりません。 </para> <para> <literal>--proto</literal> オプションは、 作成したい PHP 関数の情報を含むヘッダファイルを指定するためのものです。 既存のライブラリを使用する拡張モジュールの開発時に使用できるということらしいですが、 最近のヘッダファイルではうまく機能しないことが多いようです。 試しに <filename>zlib.h</filename> を指定してみたところ、 <filename>ext_skel</filename> の出力に 空っぽで何の意味もないプロトタイプが大量に含まれてしまいました。 <literal>--xml</literal> と <literal>--full-xml</literal> は、まったく機能しません。<literal>--skel</literal> を使用すると、独自の雛形ファイル群を使用することができます。 このオプションは、このセクションでは対象外とします。 </para> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->