付録 O. マニュアルについて

目次
フォーマット
ユーザノートについて
関数の定義(プロトタイプ)を読むには
PHP versions documented in this manual
PHPに関する更なる情報を得るには
ドキュメントの改善を手助けするには
各種フォーマットを生成する方法
Translations

フォーマット

PHPのマニュアルはいくつかのフォーマットで提供されています。 大まかに言うとフォーマットには2つの種類があります。オンラインで 読むことのできるフォーマットとダウンロード可能なパッケージです。

注意: いくつかの出版社は印刷されたマニュアルを提供しています。私たち としてはそれらをお勧めすることは出来ません。何故ならそういった ものはすぐに古いものなってしまいがちだからです。

オンラインマニュアルはhttp://www.php.net/ や、いくつかのミラーサイトで読むことができます。このタイプの フォーマットのマニュアルを快適に読むためには、一番近い場所にある ミラーサイトを選択すると良いでしょう。マニュアルはシンプルな (プリンタフレンドリーな)HTMLフォーマットか、PHPのウェブサイト のデザインに統合されたHTMLフォーマットかのいずれかを選んで 閲覧することが出来ます。

オンラインマニュアルのオフラインのマニュアルに対する主な利点は ユーザノートが統合されている ことでしょう。不利な点は、当然ですがマニュアルを見るためには 常にオンラインでいる必要があることです。

オフラインフォーマットにはいくつかのタイプがあるので、使用している OSや読み方にあわせて最適なものを選択してください。これらの異なった フォーマットのドキュメントをどのように生成しているかという 情報については、この付録の 各種フォーマットを生成する方法の項を読んでください。

テキストビューワやブラウザはどんなOSにも有るものなので、 HTMLとテキストファイルはほとんどプラットフォームを問わずに 利用できるフォーマットです。HTMLフォーマットは一つのHTMLファイルに まとめられたものと、章ごとに分割されたファイルのパッケージ (その結果、総数は数千にもなっています)の両方があります。 HTMLとテキストファイルは圧縮されたbzip2で圧縮されたtarアーカイブ として提供されています。

PDF(またの名をAdobe Acrobat)もまたクロスプラットフォームな フォーマットで、印刷するのに最適です。しかし、勢い込んで このフォーマットをダウンロードして印刷ボタンを押す前に、 このマニュアルは2000ページもの長さを持ち、常に更新されて いる、ということについてよく考えてみてください。

注意: もしPDFファイルを閲覧するプログラムが無い場合は、Adobe Acrobat Readerを ダウンロードする必要があります。

Palm互換のデバイスを持っている人にとっては、Palmドキュメントや iSiloが理想的なフォーマットです。Palmを日々の通勤で持ち歩き、 DOCiSiloを使用してPHPの知識に 磨きをかけたり、クイックリファレンスとして使用することが できます。

Windows上では、WindowsヘルプでWindows HTMLヘルプ版のマニュアルを 使用すると非常に便利です。このバージョンは全文検索、完全な目次、 そしてブックマーク機能を提供します。多くの有名なWindows上での PHP開発環境ではこのバージョンのマニュアルを統合する機能を備えて いて、間単にアクセスすることが出来ます。