PHP Commons †
- PHP Commonsは、PHPのより良いコーディングをサポートするための共通ライブラリ群です。
- Apache Commonsの中でPHPでも必要度が高いものからPHPライクに移植していきます。
News †
インストール †
# pear channel-discover phpcommons.sourceforge.jp/pear
# pear install commons/Commons
# pear install commons/log4php-beta
基本方針 †
- コーディングの良い習慣を引き継ぎ、容易にベストプラクティスを実現できるように、Apache Commons のインタフェイスを可能な限り変更せずに移植します。
- 型付け(主にタイプヒンティング)については、PHPには暗黙に継承されるルートクラスが存在しないので、クラスタイプの指定は緩めに、インタフェイスタイプの指定は通常通り行うものとします。array によるタイプヒンティングは、5.1.0からの導入なので、互換性を考慮して使用しないものとします。
- 文字列処理に関係するすべてのメソッドが、マルチバイト文字列モジュール(mbstring)が有効な環境では、透過的にマルチバイト文字列を正しく扱えるようにします。マルチバイト文字列は、内部エンコーディングの設定に基づき扱われるものとし、メソッド単位でのエンコーディング指定は行わないものとします。
- 文字列の扱いは、PHPの基本型である string (オブジェクト型ではない)を基本とします。複雑な文字列処理の必要から便宜的に文字列バッファクラス(Commons_Lang_StringBuffer?)も用意していますが、Javaのように文字ストリームを扱えるわけではないので、パフォーマンスに寄与することはありません*1。
- コレクションの扱いは、PHPの基本型である array (オブジェクト型ではない配列およびハッシュマップ)を基本とします。オブジェクトとしてコレクションを提供するかは一時保留とします。
- DIコンテナのコンポーネントとして利用できるように、インスタンスを生成する必要のないユーティリティクラス(*Utilsなど)にも public なコンストラクタメソッドを用意し、さらにそのインスタンスを取得しやすいように、静的な getInstance メソッドを用意しています*2。
- Javaのプラットフォームについては、必要な範囲で移植するものとします。