cvs: phpdoc-ja /appendices about.xml ini.xml

From: Date: Sat, 20 Aug 2005 03:38:45 +0000
Subject: cvs: phpdoc-ja /appendices about.xml ini.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-1138@lists.php.net to get a copy of this message
takagi Fri Aug 19 23:38:45 2005 EDT Modified files: /phpdoc-ja/appendices ini.xml about.xml Log: sync with en.

http://cvs.php.net/diff.php/phpdoc-ja/appendices/ini.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/appendices/ini.xml diff -u phpdoc-ja/appendices/ini.xml:1.5 phpdoc-ja/appendices/ini.xml:1.6 --- phpdoc-ja/appendices/ini.xml:1.5 Mon Jun 20 19:36:00 2005 +++ phpdoc-ja/appendices/ini.xml Fri Aug 19 23:38:42 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.19 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.25 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <appendix id="ini"> <title>&php.ini; ディレクティブ</title> @@ -51,7 +52,7 @@ <row> <entry>apc.enabled</entry> <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> @@ -81,7 +82,7 @@ <row> <entry>apc.optimization</entry> <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> @@ -211,6 +212,12 @@ <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> + <entry>birdstep.max_links</entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>blenc.key_file</entry> <entry>"/usr/local/etc/blenckeys"</entry> <entry>PHP_INI_ALL</entry> @@ -223,6 +230,36 @@ <entry></entry> </row> <row> + <entry><link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.cgi.force-redirect">cgi.force_redirect</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>cgi.nph</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.cgi.redirect-status-env">cgi.redirect_status_env</link></entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry><link linkend="ini.child-terminate">child_terminate</link></entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> @@ -301,30 +338,36 @@ <entry></entry> </row> <row> - <entry>date.default_latitude</entry> + <entry><link linkend="ini.date.default-latitude">date.default_latitude</link></entry> <entry>"31.7667"</entry> <entry>PHP_INI_ALL</entry> <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> - <entry>date.default_longitude</entry> + <entry><link linkend="ini.date.default-longitude">date.default_longitude</link></entry> <entry>"35.2333"</entry> <entry>PHP_INI_ALL</entry> <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> - <entry>date.sunrise_zenith</entry> + <entry><link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link></entry> <entry>"90.83"</entry> <entry>PHP_INI_ALL</entry> <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> - <entry>date.sunset_zenith</entry> + <entry><link linkend="ini.date.sunset-zenith">date.sunset_zenith</link></entry> <entry>"90.83"</entry> <entry>PHP_INI_ALL</entry> <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> + <entry><link linkend="ini.date.timezone">date.timezone</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry>PHP 5.1.0以降で利用可能。</entry> + </row> + <row> <entry>dba.default_handler</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> @@ -487,6 +530,18 @@ <entry></entry> </row> <row> + <entry><link linkend="ini.fastcgi.impersonate">fastcgi.impersonate</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>fastcgi.logging</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>fbsql.allow_persistent</entry> <entry>"1"</entry> <entry>PHP_INI_SYSTEM</entry> @@ -502,7 +557,7 @@ <entry>fbsql.batchsize</entry> <entry>"1000"</entry> <entry>PHP_INI_ALL</entry> - <entry>PHP 5-cvs以降で利用可能。</entry> + <entry>PHP 5.1.0以降で利用可能。</entry> </row> <row> <entry>fbsql.default_database</entry> @@ -577,6 +632,12 @@ <entry></entry> </row> <row> + <entry><link linkend="ini.from">from</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry><link linkend="ini.syntax-highlighting">highlight.bg</link></entry> <entry>"#FFFFFF"</entry> <entry>PHP_INI_ALL</entry> @@ -619,6 +680,18 @@ <entry>PHP_INI_SYSTEM in PHP &lt;= 4.2.3. PHP 4.0.2以降で利用可能。</entry> </row> <row> + <entry>http.allowed_methods</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>http.cache_log</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>hyperwave.allow_persistent</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> @@ -691,12 +764,18 @@ <entry></entry> </row> <row> - <entry>ibm_db2.binmode</entry> - <entry>"0"</entry> + <entry><link linkend="ini.ibm-db2.binmode">ibm_db2.binmode</link></entry> + <entry>"1"</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> + <entry><link linkend="ini.ibm-db2.instance-name">ibm_db2.instance_name</link></entry> + <entry>NULL</entry> + <entry>PHP_INI_SYSTEM</entry> + <entry></entry> + </row> + <row> <entry>iconv.input_encoding</entry> <entry>"ISO-8859-1"</entry> <entry>PHP_INI_ALL</entry> @@ -817,6 +896,12 @@ <entry>PHP 4.0.2以降で利用可能。</entry> </row> <row> + <entry>ingres.cursor_mode</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>ingres.default_database</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> @@ -847,6 +932,12 @@ <entry>PHP 4.0.2以降で利用可能。</entry> </row> <row> + <entry>ingres.report_db_warnings</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>ircg.control_user</entry> <entry>"nobody"</entry> <entry>PHP_INI_ALL</entry> @@ -1057,6 +1148,24 @@ <entry>PHP 4.3.0以降で利用可能。</entry> </row> <row> + <entry><link linkend="ini.msql.allow-persistent">msql.allow_persistent</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.msql.max-links">msql.max_links</link></entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.msql.max-persistent">msql.max_persistent</link></entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>mssql.allow_persistent</entry> <entry>"1"</entry> <entry>PHP_INI_SYSTEM</entry> @@ -1351,6 +1460,24 @@ <entry></entry> </row> <row> + <entry>oracle.allow_persistent</entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>oracle.max_links</entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>oracle.max_persistent</entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry><link linkend="ini.output-buffering">output_buffering</link></entry> <entry>"0"</entry> <entry>PHP_INI_PERDIR</entry> @@ -1363,6 +1490,12 @@ <entry>PHP 4.0.4以降で利用可能。</entry> </row> <row> + <entry>pdo_odbc.connection_pooling</entry> + <entry>"strict"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry>pfpro.defaulthost</entry> <entry>"test-payflow.verisign.com"</entry> <entry>PHP_INI_ALL</entry> @@ -1462,13 +1595,13 @@ <entry>realpath_cache_size</entry> <entry>"16K"</entry> <entry>PHP_INI_SYSTEM</entry> - <entry>PHP 5-cvs以降で利用可能。</entry> + <entry>PHP 5.1.0以降で利用可能。</entry> </row> <row> <entry>realpath_cache_ttl</entry> <entry>"120"</entry> <entry>PHP_INI_SYSTEM</entry> - <entry>Available since PHP 5-cvs.</entry> + <entry>PHP 5.1.0以降で利用可能。</entry> </row> <row> <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry> @@ -1501,6 +1634,12 @@ <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> + <entry>runkit.superglobal</entry> + <entry>""</entry> + <entry>PHP_INI_PERDIR</entry> + <entry></entry> + </row> + <row> <entry><link linkend="ini.safe-mode">safe_mode</link></entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM</entry> @@ -1855,6 +1994,48 @@ <entry>PHP 5.0.0以降で利用可能。</entry> </row> <row> + <entry><link linkend="ini.sybase.allow-persistent">sybase.allow_persistent</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>PHP 4.0.3以降で利用可能。</entry> + </row> + <row> + <entry><link linkend="ini.sybase.compatability-mode">sybase.compatability_mode</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>sybase.interface_file</entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.sybase.max-links">sybase.max_links</link></entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>PHP 4.0.3以降で利用可能。</entry> + </row> + <row> + <entry><link linkend="ini.sybase.max-persistent">sybase.max_persistent</link></entry> + <entry>"-1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>PHP 4.0.3以降で利用可能。</entry> + </row> + <row> + <entry><link linkend="ini.sybase.min-error-severity">sybase.min_error_severity</link></entry> + <entry>"10"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.sybase.min-message-severity">sybase.min_message_severity</link></entry> + <entry>"10"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry><link linkend="ini.sybct.allow-persistent">sybct.allow_persistent</link></entry> <entry>"1"</entry> <entry>PHP_INI_SYSTEM</entry> @@ -1903,6 +2084,24 @@ <entry>PHP 4.0.4以降で利用可能。</entry> </row> <row> + <entry>sybct.packet_size</entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.sybct.timeout">sybct.timeout</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry>sysvshm.init_mem</entry> + <entry>"10000"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> <entry><link linkend="ini.tidy.clean-output">tidy.clean_output</link></entry> <entry>"0"</entry> <entry>PHP_INI_PERDIR</entry> @@ -2844,7 +3043,13 @@ </term> <listitem> <para> - 常に$HTTP_RAW_POST_DATA変数にアクセス可能とします。 + 常に <varname>$HTTP_RAW_POST_DATA</varname> にアクセス可能とします。 + この変数には生の POST データが格納されています。指定しなかった場合は、 + データの MIME 型が判別できない場合のみこの変数にアクセス可能となります。 + しかし、生の POST データにアクセスする方法としては + <link linkend="wrappers.php">php://input</link> のほうが推奨されます。 + <varname>$HTTP_RAW_POST_DATA</varname> は、 + <literal>enctype="multipart/form-data"</literal> の場合には無効です。 </para> </listitem> </varlistentry> @@ -2918,32 +3123,32 @@ </row> <row> <entry>cgi.fix_pathinfo</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>cgi.force_redirect</entry> <entry>"1"</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>cgi.redirect_status_env</entry> - <entry>""</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>fastcgi.impersonate</entry> <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>cgi.rfc2616_headers</entry> <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> + <entry>PHP_INI_ALL</entry> <entry></entry> </row> </tbody> http://cvs.php.net/diff.php/phpdoc-ja/appendices/about.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc-ja/appendices/about.xml diff -u phpdoc-ja/appendices/about.xml:1.10 phpdoc-ja/appendices/about.xml:1.11 --- phpdoc-ja/appendices/about.xml:1.10 Wed May 25 19:11:49 2005 +++ phpdoc-ja/appendices/about.xml Fri Aug 19 23:38:43 2005 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.41 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.42 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <appendix id="about"> <title>マニュアルについて</title> @@ -8,7 +9,7 @@ <sect1 id="about.formats"> <title>フォーマット</title> <para> - PHPのマニュアルはいくつかのフォーマットで提供されています。 + PHP のマニュアルはいくつかのフォーマットで提供されています。 大まかに言うとフォーマットには2つの種類があります。オンラインで 読むことのできるフォーマットとダウンロード可能なパッケージです。 </para> @@ -20,39 +21,42 @@ </para> </note> <para> - オンラインマニュアルは<ulink url="&url.php;">PHP.net Webサイト + オンラインマニュアルは <ulink url="&url.php;">PHP.net Web サイト </ulink> や、いくつかのミラーサイトで読むことができます。このタイプの フォーマットのマニュアルを快適に読むためには、一番近い場所にある ミラーサイトを選択すると良いでしょう。マニュアルはシンプルな - (プリンタフレンドリーな)HTMLフォーマットか、PHPのウェブサイト - のデザインに統合されたHTMLフォーマットかのいずれかを選んで + (プリンタフレンドリーな) HTML フォーマットか、PHP のウェブサイトの + デザインに統合された HTML フォーマットかのいずれかを選んで 閲覧することが出来ます。 </para> <para> オンラインマニュアルのオフラインマニュアルの多くに二つの利点は、 <link linkend="about.notes">ユーザノート</link>と 見たいマニュアルのページを速やかに入手できる - <ulink url="&url.php.urlhowto;">URLショートカット</ulink>が + <ulink url="&url.php.urlhowto;">URL ショートカット</ulink>が 統合されていることでしょう。不利な点は、当然ですがマニュアルを見るためには 常にオンラインでいる必要があることです。 </para> <para> オフラインフォーマットにはいくつかのタイプがあるので、使用している - OSや読み方にあわせて最適なものを選択してください。これらの異なった + OS や読み方にあわせて最適なものを選択してください。これらの異なった フォーマットのドキュメントをどのように生成しているかという 情報については、この付録の<link linkend="about.generate"> 各種フォーマットを生成する方法</link>の項を読んでください。 </para> <para> - 最もプラットフォーム依存性が少いマニュアルのフォーマットはHTML + 最もプラットフォーム依存性が少いマニュアルのフォーマットは HTML 版です。このマニュアルは、一つのファイルにまとめられたものと、 章ごとに分割されたファイルのパッケージ (その結果、総数は数千にもなっています)の両方があります。 - これらのHTML版は圧縮された状態で提供されているため、 + これらの HTML 版は圧縮された状態で提供されているため、 アーカイブの中のファイルを取得するには解凍用ユーティリティ が必要です。 </para> + <!-- + PDF バージョンの PHP マニュアルは「現在は」存在しません。 + いつの日か出来上がるでしょう。 <para> PDF(またの名をAdobe Acrobat)もまたクロスプラットフォームな フォーマットで、印刷するのに最適です。しかし、勢い込んで @@ -62,43 +66,44 @@ </para> <note> <para> - もしPDFファイルを閲覧するプログラムが無い場合は、<ulink - url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>を - ダウンロードする必要があります。 + PDFファイルを閲覧するプログラムには、<ulink + url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink> + など多くのものがあります。 </para> </note> + --> <para> - Windows上では、<productname>Windows HTML Help</productname>で + Windows 上では、<productname>Windows HTML Help</productname> で <productname>Windows HTML Help</productname> 版のマニュアルを使用すると非常に便利です。このバージョンは全文検索、完全な目次、 - そしてブックマーク機能を提供します。多くの有名なWindows上での - PHP開発環境ではこのバージョンのマニュアルを統合する機能を備えて - いて、間単にアクセスすることが出来ます。Linuxデスクトップ用のCHMビューワーも + そしてブックマーク機能を提供します。多くの有名な Windows 上での + PHP 開発環境ではこのバージョンのマニュアルを統合する機能を備えていて、 + 間単にアクセスすることが出来ます。Linux デスクトップ用の CHM ビューワも 利用可能です。 - <ulink url="&url.xchm;">xCHM</ulink>または - <ulink url="&url.gnochm;">GnoCHM</ulink>を参照してください。 + <ulink url="&url.xchm;">xCHM</ulink> または + <ulink url="&url.gnochm;">GnoCHM</ulink> を参照してください。 </para> <para> - <ulink url="&url.php.echm;">拡張CHM版</ulink>も使用可能です。 - その更新頻度はより少なくなっていますが、より多くの機能があります。 + <ulink url="&url.php.echm;">拡張 CHM 版</ulink>も使用可能です。 + その更新頻度はより少なくなっていますが、より多くの追加機能があります。 これは、ヘルプページを構築する際に使用される技術のために - <productname>Microsoft Windows</productname>でのみ動作します。 + <productname>Microsoft Windows</productname> でのみ動作します。 </para> </sect1> <sect1 id="about.notes"> <title>ユーザノートについて</title> <para> - ユーザノートはPHPマニュアルを作成していく上で重要な役割を + ユーザノートは PHP マニュアルを作成していく上で重要な役割を 持っています。マニュアルの読者が実例、警告そしてさらに詳しい 説明をブラウザから提供できるようにすることで、そうした フィードバックをマニュアルの本文に取り込むことが出来るのです。 そして記事が本文に取り入れられるまでの間は、その内容をオンライン、 - もしくはいくつかのオフラインフォーマットで参照することが出来ます。 + もしくはいくつかのオフラインフォーマットで参照できるでしょう。 </para> <para> - ユーザノートがPHPのサイトに表示される際に、何らかの + ユーザノートが PHP のサイトに表示される際に、何らかの 査閲がされているわけではない、ということに注意してください。 従って、そこに書かれた内容、実例の質については保証 されません(とはいえ、マニュアルの本文そのものの @@ -106,10 +111,10 @@ </para> <note> <para> - 著作権の適用範囲として、ユーザノートはPHPマニュアルの一部と見なされます。 - それゆえ、このドキュメンテーションのライセンス(現状はOpen Publication + 著作権の適用範囲として、ユーザノートは PHP マニュアルの一部と見なされます。 + それゆえ、このドキュメンテーションのライセンス(現状は Open Publication License)が適用されます。 - 詳細は<link linkend="copyright">Manual's Copyright</link>をご覧ください。 + 詳細は <link linkend="copyright">Manual's Copyright</link> をご覧ください。 </para> </note> </sect1> @@ -118,21 +123,21 @@ <title>関数の定義(プロトタイプ)を読むには</title> <para> 各関数についてクイックリファレンスが記述されているので、 - マニュアルを読み理解するノウハウはPHPの利用をより簡単にしてくれます。 + マニュアルを読み理解するノウハウは PHP の利用をより簡単にしてくれます。 例示やカットアンドペーストに頼るより、関数の定義(プロトタイプ)を - 読む方法を知りたいと思うでしょう。やってみましょう: + 読む方法を覚えるべきです。やってみましょう: </para> <note> <title> 前提条件: <link linkend="language.types">型</link>の基本的な理解 </title> <para> - PHPは型についてルーズな言語ですが、重要な意味があるので、 + PHP は型についてルーズな言語ですが、重要な意味があるので、 <link linkend="language.types">型</link>の基本を理解することは重要です。 </para> </note> <para> - 関数の定義には<link linkend="functions.returning-values">戻り値</link>が + 関数の定義には<link linkend="functions.returning-values">返り値</link>が どんな型であるかが示されています。最初の例として、 <function>strlen</function>の定義を考えてみましょう。 </para> @@ -175,7 +180,7 @@ (PHP 3, PHP 4, PHP 5) </entry> <entry> - strlen()はPHP3とPHP4の両方で使用できる + strlen()は PHP 3 と PHP 4 の両方で使用できる </entry> </row> <row> @@ -212,7 +217,7 @@ </screen> </para> <para> - 多くの関数は複数の引数を取ります。例えば<function>in_array</function>。 + 多くの関数は複数の引数を取ります。例えば <function>in_array</function>。 このプロトタイプは次のようになります: </para> <para> @@ -223,29 +228,29 @@ </screen> </para> <para> - これは何を意味しているのでしょう? in_array()は - <link linkend="language.types.boolean">boolean</link>の値を返します。 - 成功した場合は&true;(<parameter>needle</parameter>が - <parameter>haystack</parameter>の中にある場合)、失敗した場合は - &false;(<parameter>needle</parameter>が<parameter>haystack</parameter> - の中にない場合)です。最初の引数は<parameter>needle</parameter> + これは何を意味しているのでしょう? in_array() は + <link linkend="language.types.boolean">boolean</link> の値を返します。 + 成功した場合は &true;(<parameter>needle</parameter> が + <parameter>haystack</parameter> の中にある場合)、失敗した場合は + &false; (<parameter>needle</parameter> が <parameter>haystack</parameter> + の中にない場合)です。最初の引数は <parameter>needle</parameter> と名づけられており、それは多くの違った<link linkend="language.types"> 型</link>をとることができます。その場合"<emphasis>mixed</emphasis>"と 呼ばれます。 - <parameter>needle</parameter>(我々が探しているもの)はスカラー値(文字列,整数, - 又は<link linkend="language.types.float">float</link>)でも、 + <parameter>needle</parameter> (我々が探しているもの)はスカラー値(文字列,整数, + 又は <link linkend="language.types.float">float</link>)でも、 <link linkend="language.types.array">配列</link>でもかまいません。 - <parameter>haystack</parameter>(対象を探す配列)は二番目の引数です。 - 三番目の<emphasis>オプション</emphasis>の引数は<parameter>strict</parameter> + <parameter>haystack</parameter> (対象を探す配列)は二番目の引数です。 + 三番目の<emphasis>オプション</emphasis>の引数は <parameter>strict</parameter> と名づけられています。全てのオプション引数は <emphasis>[</emphasis> ブラケット <emphasis>]</emphasis>の中に表現されます。 - <parameter>strict</parameter>パラメータはデフォルトではbooleanの - &false;であるとマニュアルに述べられています。機能の詳細については + <parameter>strict</parameter> パラメータはデフォルトでは boolean の + &false; であるとマニュアルに述べられています。機能の詳細については 各関数のマニュアルをご覧ください。 </para> <para> より複雑なバージョンとの関係を有する関数もあります。以下が - <function>html_entity_decode</function>の例です。 + <function>html_entity_decode</function> の例です。 </para> <para> <screen> @@ -253,74 +258,73 @@ </screen> </para> <para> - これは、この関数はPHP 3では利用できず、 - PHP 4.3.0以降のバージョンでのみ利用可能であることを意味します。 + これは、この関数は PHP 3 では利用できず、 + PHP 4.3.0 以降のバージョンでのみ利用可能であることを意味します。 </para> </sect1> <sect1 id="about.phpversions"> - <title>本マニュアルに記載されたPHPのバージョン</title> + <title>本マニュアルに記載された PHP のバージョン</title> <para> - このドキュメントはPHP 4およびPHP 5に関する情報と、PHP3からの移行と - 互換性に関する注釈が含まれています。異なるバージョンのPHPにおける、動作、引数、 + このドキュメントは PHP 4 および PHP 5 に関する情報と、PHP3 からの移行と + 互換性に関する注釈が含まれています。異なるバージョンの PHP における、動作、引数、 戻り値の違い等についてはマニュアルのノートやインラインテキストに 記述されています。 </para> <para> - CVSバージョンのPHPに関するドキュメントを見かけるかもしれません。 - これはCVSバージョン管理システム上での最新の開発バージョンにおいて - 有効であることを示しています。 - あなたがPHP自体の開発者ではなく、またPHPの最新の開発バージョンには - 関心が無い場合、"available in CVS"という言い回しのある機能には - あなたはアクセスできません。これらの機能は次期安定バージョンのPHP - で利用可能になります。CVSバージョンをダウンロードしたい場合、 + 一部に CVS バージョンの PHP に関するドキュメントも存在します。これは + 最新の開発バージョンのことです。まだ公開されておらず、CVS バージョン + 管理システムか <ulink url="&url.php.snapshots;">スナップショット</ulink> + を用いてのみ取得可能です。つまり、"available in CVS" とされている + 機能は、一般的にはまだ使えないということです。 + しかし、おそらく次期安定バージョンの PHP では利用可能になるでしょう。 + CVS バージョンをダウンロードする方法は <ulink url="&url.php.anoncvs;">anonymous CVS access page</ulink> - をご覧ください。 + を参照ください。 </para> <para> - リリースされていないバージョンのPHP(例えばPHP 5.0.0、 - 最新の安定版は4.3.x)に関するドキュメントに出あうかもしれません。 + リリースされていないバージョンの PHP (例えば PHP 5.0.0、 + 最新の安定版は 4.3.x)に関するドキュメントに出あうかもしれません。 ほとんどの場合、これはドキュメントのミスではありません。 - 現在のPHPリリースでは有効ではない説明もしばしば追加されるのです。 + 現在の PHP リリースでは有効ではない説明もしばしば追加されるのです。 それらは将来のバージョンで有効になります。 - 通常、PHPではメジャーリリースでのみ新しい機能の追加が行われ、 + 通常、PHP ではメジャーリリースでのみ新しい機能の追加が行われ、 その他のバージョンではバグ修正のみが行われます。 - A.B.Cの形式でバージョンは記述され、メジャーリリースではAまたはBが増加、 - マイナーリリースではCが増加します。 - 例えば、最新のリリースがPHP x.0.xである時に、PHP x.1.xで利用可能となる + A.B.C の形式でバージョンは記述され、メジャーリリースでは A または B が増加、 + マイナーリリースでは C が増加します。 + 例えば、最新のリリースが PHP x.0.x である時に、PHP x.1.x で利用可能となる 機能が文書化されることはまれではありません。 また、このマニュアルは過去形ではなく現在形で書かれていることにも注意してください。 </para> <para> - しばしばPHPマニュアルでは、PHPディレクティブの"デフォルト値"の一覧が示されます。 - これらの値は、<filename>php.ini-recommended</filename>ではなく、 - <filename>php.ini-dist</filename>に基いています。 - また、これらの値は、PHPの最新版に基いています。 + しばしば PHP マニュアルでは、PHP ディレクティブの"デフォルト値"の一覧が示されます。 + これらの値は、<filename>php.ini-recommended</filename> ではなく、 + <filename>php.ini-dist</filename> に基いています。 + また、これらの値は、PHP の最新版に基いています。 これらの値と変更の詳細については、 <link linkend="ini.list">付録:PHPディレクティブ</link>を参照してください。 </para> </sect1> <sect1 id="about.more"> - <title>PHPに関する更なる情報を得るには</title> + <title>PHP に関する更なる情報を得るには</title> <para> このマニュアルは一般的なプログラミングの解説を提供しよう としているわけではありません。従って、もしあなたが全く初めて プログラミングを行う、もしくはほとんど初心者である、と言う場合は - このマニュアルだけを使って、PHPのプログラミングを習得するのは + このマニュアルだけを使って、PHP のプログラミングを習得するのは 難しいでしょう。そうした場合には初心者向けの本を探したほうが - よいかもしれません。PHP関連の書籍は<ulink - url="&url.php.books;">&url.php.books;</ulink>で見つけることが + よいかもしれません。PHP 関連の書籍は<ulink + url="&url.php.books;">&url.php.books;</ulink> で見つけることが できます。 </para> <para> - PHPに関する様々な側面について活発に議論しているメーリングリスト - も多数あります。もし問題にぶつかって、自分自身では解決できない - 場合はこれらのメーリングリストに参加している他の誰かの助けを - 得ることができるかもしません。メーリングリストとそのアーカイブ、 - またその他のリソースのの一覧が<ulink url="&url.php.support;"> - PHP.netサポートページ</ulink>にあります。さらに<ulink - url="&url.php.links;">PHP.netリンクページ</ulink>にはPHP関連の記事や + PHP に関する様々な側面について活発に議論しているメーリングリストも + 多数あります。もし問題にぶつかったら、これらのメーリングリストの + 利用を考えてください。メーリングリストを含むサポート情報は + <ulink url="&url.php.support;">PHP.net サポートページ</ulink> + にあります。さらに<ulink + url="&url.php.links;">PHP.net リンクページ</ulink>には PHP 関連の記事や 掲示板、コードギャラリーを提供しているサイトの一覧があります。 </para> </sect1> @@ -328,20 +332,20 @@ <sect1 id="about.howtohelp"> <title>ドキュメントの改善を手助けするには</title> <para> - ドキュメントを改善していくには2つの方法があります。 + ドキュメントを改善していくには 3 つの方法があります。 </para> <para> - もし(どの言語でかかれたものでも)マニュアルに間違いを見つけたら - <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>にある - bug systemを使ってその問題を報告してください。バグの種別は - "Documentation Problem"にしてください。特定のフォーマット - でのみ起こる問題もここから送信することが出来ます。 + もし(どの言語でかかれたものでも)マニュアルに間違いが見つかったら + <ulink url="&url.php.bugs;">&url.php.bugs;</ulink> にある + bug system を使ってその問題を報告してください。バグの種別は + "Documentation Problem"にしてください。マニュアルのフォーマットを + 含め、ドキュメントに関する問題はすべてここから送信してください。 </para> <note> <para> - bug systemに助けを要求することでシステムを無駄に使用しないでください。 - そういった場合は前述したメーリングリストやコミュニティサイトを - 利用してください。 + bug system に助けを要求することでシステムを無駄に使用しないでください。 + かわりに、たくさんの<ulink url="&url.php.support;">サポートオプション</ulink> + の中のひとつを利用してください。 </para> </note> <para> @@ -352,11 +356,18 @@ 項を読んでください。 </para> <para> - 英語や他の外国語がわかる方なら翻訳を手伝うこともできます。 - 新しく翻訳を始めたい場合や、翻訳プロジェクトを手伝えおうと + PHP マニュアルは多くの言語に翻訳されています。英語とその他の外国語が + わかる方なら、翻訳チームを手伝うことで PHP マニュアルの改善に協力できます。 + 新しく翻訳を始めたい場合や、現在翻訳されているバージョンを手伝えおうと 思ったら、<ulink url="&url.php.dochowto;">&url.php.dochowto;</ulink> を是非読んでください。 </para> + <para> + PHP ドキュメント作成プロジェクトの IRC チャネルには、マニュアルの + 作者の多くが参加しています。<literal>irc.freenode.net</literal> + の <literal>#phpdoc</literal> で、PHP ドキュメントを改善する方法に + ついて議論しましょう。 + </para> </sect1> <sect1 id="about.generate"> @@ -365,57 +376,51 @@ このマニュアルはXMLで書かれていて、<ulink url="&url.docbook.xml;"> DocBook XML DTD</ulink>、<ulink url="&url.dsssl;"><acronym>DSSSL </acronym></ulink> (Document Style and Semantics Specification - Language)をフォーマットに使用しています。また、実験的に<ulink + Language) をフォーマットに使用しています。また、実験的に <ulink url="&url.xslt;"><acronym>XSLT</acronym></ulink> (Extensible - Stylesheet Language Transformations)をメンテナンスとフォーマットに + Stylesheet Language Transformations) をメンテナンスとフォーマットに 使用しています。 </para> <para> - <acronym>XML</acronym>をソースファイルのフォーマットとして + <acronym>XML</acronym> をソースファイルのフォーマットとして 使用することで、一つのソースファイルを管理するだけで、 多くの出力形式を生成することができるようになっています。 - <acronym>HTML</acronym>と<acronym>TeX</acronym>版で使用している - ツールは<ulink url="&url.jclark;">James Clark</ulink>に - よって書かれた<ulink url="&url.jade;">Jade</ulink>と、 - <ulink url="&url.nwalsh;">Norman Walsh</ulink>によって - 書かれた<ulink url="&url.dbstyle;">The Modular DocBook - Stylesheets</ulink>です。Windows HTMLヘルプを作成するためには + <acronym>HTML</acronym> と <acronym>TeX</acronym> 版で使用している + ツールは <ulink url="&url.jclark;">James Clark</ulink> によって + 書かれた <ulink url="&url.jade;">Jade</ulink> と、 + <ulink url="&url.nwalsh;">Norman Walsh</ulink> によって + 書かれた <ulink url="&url.dbstyle;">The Modular DocBook + Stylesheets</ulink> です。Windows HTML ヘルプを作成するためには <ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink> を使用しています。またちょっとした変換処理やフォーマットの - 処理にはもちろんPHPを使っています。 - </para> - <para> - 様々な言語の、(テキスト形式、シンプルな<acronym>HTML</acronym>形式、 - <acronym>PDF</acronym>、PalmPilot DOC、PalmPilot iSilo、 - Windows HTML Help等を含む)様々な形式の最新のマニュアルを<ulink - url="&url.php.docs;">&url.php.docs;</ulink>からダウロード - することができます。 - 技術的な問題により、いくつかのフォーマットは利用できません。 + 処理にはもちろん PHP を使っています。 </para> <para> - このドキュメントの<acronym>XML</acronym>ソースコードのダウンロード - に関する情報は<ulink url="&url.php.cvs;">&url.php.cvs;</ulink>に - あります。ドキュメントは<literal>phpdoc</literal>モジュールに格納 - されています。 + PHP マニュアルは多くの言語とフォーマットで作成されています。詳しい + 情報は <ulink url="&url.php.docs;">&url.php.docs;</ulink> を参照ください。 + このドキュメントの <acronym>XML</acronym> ソースコードは、CVS から + のダウンロードしたり <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> + で閲覧したりできます。ドキュメントは <literal>phpdoc</literal> + モジュールに格納されています。 </para> </sect1> <sect1 id="about.translations"> <title>Translations</title> <para> - PHPマニュアルはさまざまな形式で読めるだけでなく、さまざまな言語で + PHP マニュアルはさまざまな形式で読めるだけでなく、さまざまな言語で 読むことができます。マニュアルの文章はまず最初に英語で書かれ、 その後世界中のチームによってそれぞれの母国語に翻訳されます。 もし特定の関数や章がまだ翻訳されていない場合、マニュアル生成システム はその英語版を自動的に挿入します。 </para> <para> - 翻訳に携わる人は<ulink url="&url.php.cvs;">&url.php.cvs;</ulink>から - アクセスできる<acronym>XML</acronym>ソースコードを母国語に - 翻訳することから始めます。<acronym>HTML</acronym>やプレーンテキスト、 - または<acronym>PDF</acronym>バージョンを扱うことは - <emphasis>ありません</emphasis>。<acronym>XML</acronym>を人間が読める形式に - 変換する処理をしてくれるのはがビルドシステムです。 + 翻訳に携わる人は <ulink url="&url.php.cvs;">&url.php.cvs;</ulink> から + アクセスできる <acronym>XML</acronym> ソースコードを母国語に + 翻訳することから始めます。生成されたバージョン(<acronym>HTML</acronym> + やプレーンテキストなど)を扱うことは<emphasis>ありません</emphasis>。 + <acronym>XML</acronym>を人間が読める形式に変換する処理をしてくれるのが + ビルドシステムです。 </para> <note> <para> @@ -423,7 +428,7 @@ phpdocメーリングリストに加入してドキュメント/翻訳チームと連絡を取ってください。 <ulink url="mailto:&email.php.doc.subscribe;">&email.php.doc.subscribe;</ulink> に空のメールを送るだけです。 - メーリングリストのアドレスは<literal>&email.php.doc;</literal>です。 + メーリングリストのアドレスは <literal>&email.php.doc;</literal> です。 マニュアルの翻訳に関心があることをメッセージに書いてください。 誰かから返事をもらって新しい言語への翻訳をスタートする手助けをしてもらうか、 あるいは、その言語について既に活動している翻訳チームと連絡が取れます。 @@ -431,14 +436,14 @@ </note> <para> 現在のところ以下の言語において全て又は一部のマニュアルが利用できます。 - Brazilian Portuguese, Chinese (Simplified),Chinese (Hong Kong Cantonese), - Chinese (Traditional), Czech, - Dutch, Finnish, French, German, Hebrew, Hungarian, Italian, Japanese, - Korean, Polish, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, そして、 - Turkish. + (ブラジルの)ポルトガル語、中国語(簡体字)、中国語(香港 広東語)、 + 中国語(繁体字)、チェコ語、オランダ語、フィンランド語、フランス語、 + ドイツ語、ヘブライ語、ハンガリー語、イタリア語、日本語、韓国/朝鮮語、 + ポーランド語、ルーマニア語、ロシア語、スロバキア語、スロベニア語、 + スペイン語、スウェーデン語、そしてトルコ語。 </para> <para> - 全てここからダウンロードできます:<ulink url="&url.php.docs;">&url.php.docs;</ulink> + 全てここからダウンロードできるでしょう: <ulink url="&url.php.docs;">&url.php.docs;</ulink> </para> </sect1>
« previous php.doc.ja (#1138) next »