上記の例の "Hello World" は、単純なコマンドとして有名です、 しかし、より進んだ何かについてはどうでしょうか？ スクリプトを書くこととツーリングの必要性が高まるにつれ、 変数を扱う能力を必要とすると気付くかもしれません。 だいたいのファンクション・シグニチャにはパラメータがあるように、 ツーリング・リクエストはパラメータを受け入れることもできます。

各々のツーリング・リクエストがクラス内でメソッドに分離されることができると、 ツーリング・リクエストのパラメータはきわめて周知の立場で分離されることもできます。 プロバイダのアクション・メソッドのパラメータは、 クライアントがそのプロバイダとアクションの組合せを呼ぶとき、 利用することを望む同じパラメータを含むことができます。 たとえば、あなたが上記の例で名前を扱いたいならば、 あなたは多分オブジェクト指向コードでこうするでしょう:

class My_Component_HelloProvider
    implements Zend_Tool_Framework_Provider_Interface
{
    public function say($name = 'Ralph')
    {
        echo 'Hello' . $name . ', from my provider!';
    }
}

それから上記の例は、コマンドラインzf say hello Joeによって呼ぶことができます。 "Joe" は、メソッド呼び出しのパラメータとして、プロバイダに供給されます。 また注意すべきこととして、 パラメータが任意だとあなたがわかるように、 zf say helloがさらに機能して、名前 "Ralph" にデフォルト設定するように、 コマンドライン上で選択できることを意味します。

There are cases when the workflow of your provider requires to prompt the user for input. This can be done by requesting the client to ask for more the required input by calling:

class My_Component_HelloProvider
    extends Zend_Tool_Framework_Provider_Abstract
{
    public function say($name = 'Ralph')
    {
        $nameResponse = $this->_registry
                             ->getClient()
                             ->promptInteractiveInput("Whats your name?");
        $name = $nameResponse->getContent();

        echo 'Hello' . $name . ', from my provider!';
    }
}

This command throws an exception if the current client is not able to handle interactive requests. In case of the default Console Client however you will be asked to enter the name.

あなたが実装したいかもしれないもう一つの面白い特徴は、擬態性です。 擬態性は、 まるでそれがリクエストされたアクションとプロバイダの組み合わせを実行しているように擬態して、 実際にそれを実行せずに、それが実行するであろうことについて沢山の情報をユーザーに与えることを プロバイダでできるようにします。 これ以外の場合にはユーザーが実行したくないかもしれない重いデータベースや、 ファイルシステム修正をするときに重要な小道具であるかもしれません。

擬態性は簡単に実装できます。 このフィーチャーには2つの要素があります: 1) プロバイダが「擬態する」能力を持つことを示します。 2) 現在のリクエストが本当に、 「擬態する」よう要求されたことを確実にするために、リクエストをチェックします。 このフィーチャーは下記のコードサンプルで示されます。

class My_Component_HelloProvider
    extends    Zend_Tool_Framework_Provider_Abstract
    implements Zend_Tool_Framework_Provider_Pretendable
{
    public function say($name = 'Ralph')
    {
        if ($this->_registry->getRequest()->isPretend()) {
            echo 'I would say hello to ' . $name . '.';
        } else {
            echo 'Hello' . $name . ', from my provider!';
        }
    }
}

擬態モードでプロバイダを実行してちょっと呼び出し

% zf --pretend say hello Ralph
I would say hello Ralph.

You can also run your provider actions in "verbose" or "debug" modes. The semantics in regard to this actions have to be implemented by you in the context of your provider. You can access debug or verbose modes with:

class My_Component_HelloProvider
    implements Zend_Tool_Framework_Provider_Interface
{
    public function say($name = 'Ralph')
    {
        if($this->_registry->getRequest()->isVerbose()) {
            echo "Hello::say has been called\n";
        }
        if($this->_registry->getRequest()->isDebug()) {
            syslog(LOG_INFO, "Hello::say has been called\n");
        }
    }
}

Using the Enviroment variable ZF_CONFIG_FILE or the .zf.ini in your home directory you can inject configuration parameters into any Zend_Tool provider. Access to this configuration is available via the registry that is passed to your provider if you extend Zend_Tool_Framework_Provider_Abstract.

class My_Component_HelloProvider
    extends Zend_Tool_Framework_Provider_Abstract
{
    public function say()
    {
        $username = $this->_registry->getConfig()->username;
        if(!empty($username)) {
            echo "Hello $username!";
        } else {
            echo "Hello!";
        }
    }
}

The returned configuration is of the type Zend_Tool_Framework_Client_Config but internally the __get and __set magic methods proxy to a Zend_Config of the given configuration type.

The storage allows to save arbitrary data for later reference. This can be useful for batch processing tasks or for re-runs of your tasks. You can access the storage in a similar way like the configuration:

class My_Component_HelloProvider
    extends Zend_Tool_Framework_Provider_Abstract
{
    public function say()
    {
        $aValue = $this->_registry->getStorage()->get("myUsername");
        echo "Hello $aValue!";
    }
}

ストレージ API はとても簡単です。

class Zend_Tool_Framework_Client_Storage
{
    public function setAdapter($adapter);
    public function isEnabled();
    public function put($name, $value);
    public function get($name, $defaultValue=null);
    public function has($name);
    public function remove($name);
    public function getStreamUri($name);
}