このドキュメントは 2003 年 11 月 4 日に発行されたもので、 PEAR パッケージで使用しなければならないディレクトリ構造について説明しています。 このドキュメントの目標は、CVS 上でのディレクトリ名と インストール後のディレクトリ名を統一することです。
The_Package_Name
というパッケージがあり、
その中にはいくつかのサブクラス
(例. The_Package_Name_Module
)
とドキュメント (README
や
RFC のコピーなど)、そしてテストスクリプト
(単体テスト、回帰テストなど) やデータファイル
(ローカライズ用文字列など) があるものとしましょう。
ディレクトリの構造は次のようになります。
The_Package_Name |-- Name (Module.php を含みます) |-- data |-- docs | `-- examples |-- misc |-- scripts `-- tests
Name
は
The_Package_Name
の最後の部分からとったもので、
すべてのサブクラスをこのディレクトリかそのサブディレクトリに配置しなければなりません。
http://cvs.php.net/cvs.php/pear/Cache_Lite/ のディレクトリ
Lite
が参考になるでしょう (これは、
基本的に現在私たちが行っていることをそのまま書いたものです)。
ディレクトリ data
および misc
はオプションです。PEAR のすべてのパッケージにこのディレクトリがあったとしても、
あまり意味がないからです。
必須となるディレクトリは docs/examples
および tests
です。
そのパッケージには追加のドキュメントがないかもしれませんが、
少なくともひとつはサンプルがなければなりません。
また、基本的なテストによって
パッケージの動作確認ができるようになっていなければなりません。
テスト用スクリプトは、PHPUnit あるいは .phpt を用いることを推奨します。
しかし、現時点では、とりあえず何らかのテストがあればよいものとします。
scripts
内のファイルは、
$PATH
の中のディレクトリ、たとえば
/usr/local/bin
にインストールされます。
いままでのいずれにも当てはまらないものは、
misc
ディレクトリに配置します。
パッケージのメンテナは、 既存のパッケージをこの標準に従って変更していくようにしましょう。