CLIツールの使用

アーキテクチャ

レジストリ

include_pathのどこからでもプロバイダとマニフェストが由来するかもしれないので、 ツール・チェーンのいろいろな部分へのアクセスを単純化するためにレジストリが提供されます。 このレジストリはレジストリを認識するコンポーネントに注入されます。 そして、それから必要に応じてそれは彼らから依存性を引き出すかもしれません。 レジストリで登録される依存性の多くは、下位-構成要素に特有のリポジトリです。

レジストリのためのインターフェースは、以下の定義から成ります。:

  1. interface Zend_Tool_Framework_Registry_Interface
  2. {
  3.     public function setClient(Zend_Tool_Framework_Client_Abstract $client);
  4.     public function getClient();
  5.     public function setLoader(Zend_Tool_Framework_Loader_Abstract $loader);
  6.     public function getLoader();
  7.     public function setActionRepository(
  8.         Zend_Tool_Framework_Action_Repository $actionRepository
  9.     );
  10.     public function getActionRepository();
  11.     public function setProviderRepository(
  12.         Zend_Tool_Framework_Provider_Repository $providerRepository
  13.     );
  14.     public function getProviderRepository();
  15.     public function setManifestRepository(
  16.         Zend_Tool_Framework_Manifest_Repository $manifestRepository
  17.     );
  18.     public function getManifestRepository();
  19.     public function setRequest(Zend_Tool_Framework_Client_Request $request);
  20.     public function getRequest();
  21.     public function setResponse(Zend_Tool_Framework_Client_Response $response);
  22.     public function getResponse();
  23. }

レジストリが管理するいろいろなオブジェクトは、それらに該当する部分で論じられます。

レジストリを認識しなければならないクラスは、 Zend_Tool_Framework_Registry_EnabledInterfaceを実行しなければなりません。 このインターフェースは、単に対象クラスだけでレジストリの初期化を可能にします。

  1. interface Zend_Tool_Framework_Registry_EnabledInterface
  2. {
  3.     public function setRegistry(
  4.         Zend_Tool_Framework_Registry_Interface $registry
  5.     );
  6. }

プロバイダ

Zend_Tool_Framework_Providerは、 フレームワークの機能または「能力」面を表現します。 基本的に、Zend_Tool_Framework_Providerは 「プロバイダ」をもたらすために必要なインターフェース、 またはZend_Tool_Frameworkツール・チェーン内で呼ぶことができて、 使うことができる若干のツーリング機能を提供します。 このプロバイダ・インターフェースを実装することの割り切った性質によって、 開発者は機能/能力を「ワンストップサービス」で Zend_Tool_Frameworkに加えることができます。

プロバイダ・インターフェースは空のインターフェースで、メソッドを強制しません。 (これは、マーカ・インターフェース・パターンです):

  1. interface Zend_Tool_Framework_Provider_Interface
  2. {}

あるいは、もし望めば、Zend_Tool_Framework_Registryに アクセスできるようにする基底(または抽象)プロバイダを実装できます。:

  1. abstract class Zend_Tool_Framework_Provider_Abstract
  2.     implements Zend_Tool_Framework_Provider_Interface,
  3.                Zend_Tool_Registry_EnabledInterface
  4. {
  5.     protected $_registry;
  6.     public function setRegistry(
  7.         Zend_Tool_Framework_Registry_Interface $registry
  8.     );
  9. }

ローダ

ローダの目的は、Zend_Tool_Framework_Provider_InterfaceZend_Tool_Framework_Manifest_Interfaceを実装するクラスを含む プロバイダとマニフェスト・ファイルを見つけることです。 一旦これらのファイルがローダによって見つかると、 プロバイダはプロバイダ・リポジトリにロードされ、 マニフェスト・メタデータはマニフェスト・リポジトリにロードされます。

ローダを実装するために、以下の抽象クラスを拡張しなければなりません:

  1. abstract class Zend_Tool_Framework_Loader_Abstract
  2. {
  3.  
  4.     abstract protected function _getFiles();
  5.  
  6.     public function load()
  7.     {
  8.         /** ... */
  9.     }
  10. }

_getFiles()メソッドは、ファイル(絶対パス)の配列を返さなければなりません。 Zend Frameworkで供給されるビルトイン・ローダは、インクルードパス・ローダと呼ばれます。 デフォルトで、ツーリング・フレームワークは、 プロバイダまたはマニフェスト・メタデータ・オブジェクトを含むかもしれないファイルを見つけるために、 include_pathベースのローダを使います。 他のオプションが全く無くても、 Zend_Tool_Framework_Loader_IncludePathLoaderはインクルードパスの中で Mainfest.phpTool.phpまたはProvider.phpで 終わるファイルを探します Zend_Tool_Framework_Loader_Abstractload()メソッドによって一旦見つかると、 それらがサポートされたインターフェースのいずれかを実装するかどうか判定するためにそれらはテストされます。 もし実装していれば、見つかったクラスのインスタンスがインスタンス化されます、 そして、それは固有のリポジトリを付加されています。

  1. class Zend_Tool_Framework_Loader_IncludePathLoader
  2.     extends Zend_Tool_Framework_Loader_Abstract
  3. {
  4.  
  5.     protected $_filterDenyDirectoryPattern = '.*(/|\\\\).svn';
  6.     protected $_filterAcceptFilePattern = '.*(?:Manifest|Provider)\.php$';
  7.  
  8.     protected function _getFiles()
  9.     {
  10.         /** ... */
  11.     }
  12. }

ご覧の通り、インクルードパス・ローダは、$_filterAcceptFilePatternにマッチし、 $_filterDenyDirectoryPatternにマッチしないファイルを求めて、 すべてのinclude_pathsを検索します。

マニフェスト

要するに、マニフェストはプロバイダ・リポジトリにどんなさらなるプロバイダでもロードする役割を果たしうるばかりではなく、 どんなプロバイダまたはクライアントにとってでも有用である、指定された、または任意のメタデータを含みます。

空のZend_Tool_Framework_Manifest_Interfaceを実装して、 Zend_Tool_Framework_Manifest_Metadataを実装する オブジェクトの配列を返す getMetadata()メソッドを提供しさえすれば、 メタデータをマニフェスト・リポジトリにもたらすことができます。

  1. interface Zend_Tool_Framework_Manifest_Interface
  2. {
  3.     public function getMetadata();
  4. }

下記で定義されたローダによって、 メタデータ・オブジェクトはマニフェスト・リポジトリ(Zend_Tool_Framework_Manifest_Repository)にロードされます。 すべてのプロバイダがプロバイダ・リポジトリにロードされるとわかったあと、マニフェストは処理されます。 これによって、何が現在プロバイダ・リポジトリ内部にあるかに基づくメタデータ・オブジェクトをマニフェストは作成できます。

メタデータを記述するために用いることができる 多少の異なるメタデータ・クラスがあります。 Zend_Tool_Framework_Manifest_Metadataは、 基底メタデータ・オブジェクトです。 以下のコード・スニペットによってわかるように、 基底メタデータ・クラスは事実上かなり軽量で抽象的です:

  1. class Zend_Tool_Framework_Metadata_Basic
  2. {
  3.  
  4.     protected $_type        = 'Global';
  5.     protected $_name        = null;
  6.     protected $_value       = null;
  7.     protected $_reference   = null;
  8.  
  9.     public function getType();
  10.     public function getName();
  11.     public function getValue();
  12.     public function getReference();
  13.     /** ... */
  14. }

より分化したメタデータを記述するために同様に他のビルトイン・メタデータ・クラスがあります: ActionMetadata及びProviderMetadata。 これらのクラスは、アクションまたはプロバイダのいずれかに特有なメタデータをより詳細に記述する助けになります。 そして、参照はそれぞれアクションまたはプロバイダへの参照であることが期待されます。 これらのクラスは、以下のコード・スニペットで記述されます。

  1. class Zend_Tool_Framework_Manifest_ActionMetadata
  2.     extends Zend_Tool_Framework_Manifest_Metadata
  3. {
  4.  
  5.     protected $_type = 'Action';
  6.     protected $_actionName = null;
  7.  
  8.     public function getActionName();
  9.     /** ... */
  10. }
  11.  
  12. class Zend_Tool_Framework_Manifest_ProviderMetadata
  13.     extends Zend_Tool_Framework_Manifest_Metadata
  14. {
  15.  
  16.     protected $_type = 'Provider';
  17.     protected $_providerName  = null;
  18.     protected $_actionName    = null;
  19.     protected $_specialtyName = null;
  20.  
  21.     public function getProviderName();
  22.     public function getActionName();
  23.     public function getSpecialtyName();
  24.     /** ... */
  25. }

これらのクラスでの'Type'は、 オブジェクトが責を負うべきメタデータのタイプを記述するのに用いられます。 ActionMetadataのケースでは、タイプは'Action'です。 そして逆に、ProviderMetadataの場合は、タイプは'Provider'です。 これらのメタデータ・タイプは、 それらがこの新しいメタデータで参照しているオブジェクト( getReference())だけでなく、 それらが記述している「もの」についても、さらなる構造化情報を含みます。

基底Zend_Tool_Framework_Manifest_Metadataクラスを拡張して、 クラス/オブジェクト・ローカル・マニフェストを通してこれらの新しいメタデータ・オブジェクトを返しさえすれば、 あなた自身のメタデータ・タイプを構築できます。 これらのユーザー・ベースのクラスは、マニフェスト・リポジトリの中に残ります

もし、これらのメタデータ・オブジェクトがリポジトリならば、 リポジトリでそれらを探すために利用できる2つの異なるメソッドがあります。

  1. class Zend_Tool_Framework_Manifest_Repository
  2. {
  3.     /**
  4.      * 検索するメソッドを使うために、
  5.      * $searchPropertiesはマニフェストの範囲内でマッチさせたい
  6.      * キーと値のペアの名前と値を含まなければなりません。
  7.      *
  8.      * 例:
  9.      *     $manifestRepository->findMetadatas(array(
  10.      *         'action' => 'Foo',
  11.      *         'name'   => 'cliActionName'
  12.      *         ));
  13.      *
  14.      * 値'Foo'と名前'action'でキーを持つどんなメタデータ・オブジェクトも見つけます。
  15.      * そして、キーは'cliActionName'の'name'値と名づけられました。
  16.      *
  17.      * 注意:
  18.      * 検索基準の中に存在するが、オブジェクトに現れない名前と値のペアを除外するか、
  19.      * または含むために、$includeNonExistentPropertiesにブール値を渡してください
  20.      */
  21.     public function findMetadatas(Array $searchProperties = array(),
  22.                                   $includeNonExistentProperties = true);
  23.  
  24.     /**
  25.      * どれくらいが返されたかに関係なく、
  26.      * マッチしている検索基準のうちのちょうど1つを以下は返します。
  27.      * マニフェストの最初の1つは、何が返されるかということです。
  28.      */
  29.     public function findMetadata(Array $searchProperties = array(),
  30.                                  $includeNonExistentProperties = true)
  31.     {
  32.         $metadatas = $this->getMetadatas($searchProperties,
  33.                                          $includeNonExistentProperties);
  34.         return array_shift($metadatas);
  35.     }
  36. }

上記のサーチ方式を見ると、シグニチャはとても柔軟に検索することを許します。 メタデータ・オブジェクトを見つけるために、 制約にマッチする配列を単に配列によって渡してください。 データがプロパティ・アクセッサ (オブジェクト・メタデータの上で実装される getSomething()メソッド) によってアクセスできるならば、 それは「見つかった」オブジェクト・メタデータとしてユーザーへ渡されます。

クライアント

クライアントは、Zend_Tool_Frameworkシステムと ユーザーまたは外部ツールとの橋渡しをするインターフェースです。 クライアントは、すべての形とサイズに伝わることができます: RPCエンドポイント、コマンド・ライン・インタフェースまたはウェブ・インターフェースさえ。 Zend_Toolは、Zend_Tool_Frameworkシステムと相互に作用するための デフォルト・インターフェースとして、コマンド・ライン・インタフェースを実装しました。

クライアントを実装するためには、以下の抽象クラスを拡張する必要があります。:

  1. abstract class Zend_Tool_Framework_Client_Abstract
  2. {
  3.     /**
  4.      * このメソッドは、カスタム・ローダ、リクエストとレスポンス・オブジェクトを構成して、
  5.      * セットするために、クライアント実装によって実装されなければなりません。
  6.      *
  7.      * (必須ではありませんが、提案されます)
  8.      */
  9.     protected function _preInit();
  10.  
  11.     /**
  12.      * このメソッドは解析するクライアント実装によって実装されなければなりません。
  13.      * リクエスト・オブジェクト・アクション、
  14.      * プロバイダ及びパラメータ情報を準備しなければなりません。
  15.      */
  16.     abstract protected function _preDispatch();
  17.  
  18.     /**
  19.      * このメソッドは、レスポンス・オブジェクトを出力して、
  20.      * それをツーリング・クライアントに(クライアントに特有の手段で)返すために、
  21.      * クライアント実装によって実装されなければなりません。
  22.      *
  23.      * (必須ではありませんが、提案されます)
  24.      */
  25.     abstract protected function _postDispatch();
  26. }

ご覧の通り、そこで、1つのメソッドはクライアントの必要を満たすことを要求されます。 (他の2つは提案されます) 初期化、前処理と後処理 コマンド・ライン・クライアントが動く方法についてより深く研究するには、 » ソースコード を見てください。


CLIツールの使用