Para distribuir pedidos via cliente de linha de comando, primeiro você precisa configurar o cliente para que seu sistema possa manipular os comandos "zf". O cliente de linha de comando, para todos as intenções e propósitos, é o arquivo .sh ou .bat que é provido com a sua distribuição do Zend Framework. No trunk, ele pode ser encontrado aqui: http://framework.zend.com/svn/framework/standard/trunk/bin/.

Como você pode ver, existem 3 arquivos no diretório /bin/: zf.php, zf.sh, e zf.bat. O zf.sh e o zf.bat são os pacotes específicos do sistema operacional: zf.sh para ambientes *nix, e zf.bat para ambientes Win32. Estes empacotadores clientes são responsáveis por procurar o php.exe correto, achando o zf.php, e passando o pedido para o cliente. O zf.php, é responsável por manipular a identificação do seu ambiente, construindo um include_path adequado, e passar o que é fornecido na linha de comando para o componente de biblioteca adequado para a expedição.

Finalmente, você quer garantir duas coisas para fazer tudo funcionar independentemente do sistema operacional em que você está:

A configuração mais comum no ambiente *nix, é copiar o zf.sh e o zf.php no mesmo diretório que o seu binário PHP. Isto pode geralmente ser achado nos seguintes lugares:

/usr/bin
/usr/local/bin
/usr/local/ZendServer/bin/
/Applications/ZendServer/bin/

Para achar a localização do seu binário PHP, você pode executar 'which php' na linha de comando. Isto retornará a localização do binário do PHP que você está usando para rodar scripts PHP no seu ambiente.

O próximo passo é certificar que a biblioteca Zend Framework está configurada corretamente dentro do sistema de include_path do PHP. Para achar onde seu include_path está localizado, você pode executar php -i e olhar para a variável include_path, o mais sucintamente, executar php -i | grep include_path. Uma vez que você tenha achado onde seu include_path está localizado (isto irá geralmente estar em algum lugar como /usr/lib/php, /usr/share/php, /usr/local/lib/php, ou similar), certifique que o conteúdos do diretório /library/ estão colocados dentro do seu diretório include_path especificado.

Uma vez que você tenha terminado estas duas coisas, você deve ser capaz de digitar um comando e obter devolta a resposta adequada como:

Se vocÊ não ver isto digitado na saída, volte e verifique sua configuração para ter certeza que tem todas as partes necessárias in devido lugar.

Existem uma combinação de configurações alternativas que você pode querer empregar dependendo das configurações dos servidores, seu nível de acesso, ou por outras razões.

Configuração Alternativa envolve guardar o download do Zend Framework junto como está, e criar um link de um local PATH para o zf.sh. O que isto significa é que você coloca o conteúdo do download do Zend Framework em uma localização tal como /usr/local/share/ZendFramework, ou mais localmente como /home/username/lib/ZendFramework, e cria um link simbólico para o zf.sh.

Assumindo que você quer colocar o link dentro de /usr/local/bin (isto pode também funcionar colocando o link dentro de /home/username/bin/ por exemplo) você poderia dgitar um comando similar a este:

ln -s /usr/local/share/ZendFramework/bin/zf.sh /usr/local/bin/zf

# OU (por exemplo)
ln -s /home/username/lib/ZendFramework/bin/zf.sh /home/username/bin/zf

Isto irá criar um link que você poderá ser capaz de acessar globalmente na linha de comando.

A confuguração mais comum no ambiente Win32, é copiar o zf.bat e o zf.php para dentr do mesmo diretório do seu binário PHP. Este pode geralmente ser achado nos seguintes lugares:

C:\PHP
C:\Program Files\ZendServer\bin\
C:\WAMP\PHP\bin

Você deve ser capaz de rodar php.exe na linha de comando. Se você não for capaz, primeiro verifique a documentação que veio com sua distribuição PHP, ou tenha certeza que o caminho para o php.exe está na sua variável de ambiente PATH do Windows.

O próximo passo é ter certeza que a biblioteca do Zend Framework está configurada corretamente dentro do sistema de include_path do PHP. Para achar onde seu include_path está localizado, você pode digitar php -i e olhar para a variável include_path, ou mais sucintamente executar php -i | grep include_path se você tem um Cygwin configurado com grep disponível. Uma vez você tenha achado onde seu include_path está localizado(isto irá geralmente ser algo como C:\PHP\pear, C:\PHP\share,C:\Program%20Files\ZendServer\share ou similar), verifique que os conteúdos do diretório library/ estão postos dentro do seu diretório include_pathespecificado.

Uma vez tenha terminado aquilas duas coisas, você deve ser capaz de enviar um comando e receber o devida resposta como:

Se você não ver isto digitado na saída, volte e verifique sua configuração para ter certeza que você tem todas as partes necessárias no lugar correto.

Existe uma combinação de configurações alternativas que você pode querer empregar dependendo das configurações do seu servidor, do seu nível de acesso, ou de outras razões.

Configuração Alternativa envolve guardar o download do Zend Framework junto como está, e alterar ambos seu sistema de PATH bem como o arquivo php.ini. No seu ambiente de usuário, tenha certeza de adcionar C:\Path\To\ZendFramework\bin, então seu arquivo zf.bat será executável. Também, altere o arquivo php.ini certificando que C:\Path\To\ZendFramework\library está no seu include_path.

Se por alguma razão você não quiser a biblioteca do Zend Framework dentro do seu include_path, existe uma outra opção. Existem duas variáveis de ambiente especiais que o zf.php irá utilizar para determinar a localização da sua instalação do Zend Framework.

A primeira é ZEND_TOOL_INCLUDE_PATH_PREPEND, que irá preceder o valor da variável de ambiente para o sistema de (php.ini) include_path include_path antes da carga do cliente.

Alternativamente, você pode querer usar ZEND_TOOL_INCLUDE_PATH para substituir completamente o sistema de include_path para um que faça sentido especialmente para a ferramente de linha de comando zf.

Por padrão Zend_Tool usa o BasicLoader para encontrar todos os providers que você pode rodar. Ele itera recursivamente todos os diretórios do include path e abre todos os arquivos que terminam com "Manifest.php" ou "Provider.php". Todas as classes naqueles arquivos são inspecionadas se implementam ou Zend_Tool_Framework_Provider_Interface ou Zend_Tool_Framework_Manifest_ProviderManifestable. Instancias da interface do provider implementam a real funcionalidade e todos os métodos públicos estão acessíveis como actions do provider. A interface ProviderManifestable de qualquer forma requer a implementação de um metodo getProviders() que reforna um array de instâncias da interface provider.

As seguintes regras de nomeação aplicaveis em como você pode acessar os providers que foram encontrados pelo IncludePathLoader:

class My_Component_Manifest
    implements Zend_Tool_Framework_Manifest_ProviderManifestable
{
    public function getProviders()
    {
        return array(
            new My_Component_HelloProvider()
        );
    }
}

Como um exemplo, se um desenvolvedor quer adicionar a capacidade de apresentar a versão de um arquivos de dados que seu componente de terceiros está usando, exite apenas uma classe que o desenvolvedor precisaria implementar. Asumindo que o componente é chamado My_Component, Ele poderia criar uma classe chamada My_Component_HelloProvider em um arquivo nomeado de HelloProvider.php em algum lugar no include_path. Esta classe implementaria Zend_Tool_Framework_Provider_Interface, e o corpo deste arquivo apenas teria que parecer com o seguinte:

class My_Component_HelloProvider
    implements Zend_Tool_Framework_Provider_Interface
{
    public function say()
    {
        echo 'Hello from my provider!';
    }
}

Dado o códifo acima, e assumindo que o desenvolvedor deseja acessar esta funcionalidade através do cliente de console, a chamada se pareceria com isto:

% zf say hello
Hello from my provider!

Como assumido na arquitetura da sessão Zend_Tool permite unir diferentes cliente para usar o seus providers Zend_Tool. Para manter a conformidade com diferentes clientes você deve usar o objeto de resposta para retornar mensagens de seus providers em vez de usar echo() ou um mecanismo de saída semelhante. Reescrevendo nosso provider hello com este conhecimento isto vai se parecer com:

class My_Component_HelloProvider
    extends Zend_Tool_Framework_Provider_Abstract
{
    public function say()
    {
        $this->_registry
             ->getResponse()
             ->appendContent("Hello from my provider!");
    }
}

Como você pode ser ele extende o Zend_Tool_Framework_Provider_Abstract para ter acesso ao Registry que guarda a instância do Zend_Tool_Framework_Client_Response.