フォーマット

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

オンラインマニュアルは PHP.net Web サイト や、いくつかのミラーサイトで読むことができます。このタイプの フォーマットのマニュアルを快適に読むためには、一番近い場所にある ミラーサイトを選択すると良いでしょう。オンライン版の PHP マニュアルには、現在二種類の CSS スタイルシートが提供されています。それぞれ、 ウェブでの閲覧に適したものと、プリンタでの印刷に適したものです。

オンラインマニュアルがオフライン版より優れている点は、 ユーザノートと 見たいマニュアルのページを速やかに入手できる URL ショートカットが 統合されていることでしょう。不利な点は、当然ですがマニュアルを見るためには 常にオンラインでいる必要があることです。

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

最もプラットフォーム依存性が少いマニュアルのフォーマットは HTML 版です。このマニュアルは、一つのファイルにまとめられたものと、 章ごとに分割されたファイルのパッケージ (その結果、総数は数千にもなっています)の両方があります。 これらの HTML 版は圧縮された状態で提供されているため、 アーカイブの中のファイルを取得するには解凍用ユーティリティ が必要です。

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

拡張 CHM 版も使用可能です。 その更新頻度はより少なくなっていますが、より多くの追加機能があります。 これは、ヘルプページを構築する際に使用される技術のために Microsoft Windows でのみ動作します。