Back-End

7 mar, 2013

ZFTool: uma ferramenta de linha de comando para ZF2

Publicidade

O ZFTool é uma ferramenta de linha de comando para gerenciar aplicativos escritos em Zend Framework 2. Ela ainda está em desenvolvimento e nós acabamos de lançar uma versão inicial que você já pode começar a usar. Com essa versão você pode:

  • criar um projeto ZF2, instalando um aplicativo skeleton;
  • criar um novo módulo dentro de um aplicativo já existente;
  • obter a lista de todos os módulos instalados dentro de um aplicativo;
  • obter o arquivo de configuração de um aplicativo ZF2;
  • instalar a biblioteca ZF2 escolhendo uma versão específica.

Você pode instalar a ferramenta ZFTool usando composer ou github. Além disso, nós a compilamos em um arquivo PHAR. Você pode baixar o zftool.phar a partir daqui. Se você quiser usar o zftool.phar, sugiro adicioná-lo em seu ambiente PATH. Dessa forma, você pode executar o script zftool.phar de onde estiver.

Para instalar usando composer, você tem que executar o seguinte comando em um ambiente shell:

$ composer require zendframework/zftool:dev-master

Você também pode instalar manualmente usando github, seguindo os seguintes passos:

  1. clonar usando “git clone https://github.com/zendframework/ZFTool.git” ou download zipball;
  2. extrair para “vendor/ZFTool” no seu aplicativo ZF2;
  3. editar o seu “config/application.config.php” e acrescentar “ZFTool” para módulos de chave de array.

Após a instalação, você pode executar o arquivo zf.php dentro da pasta raiz da ZFTool ou pode usar o zftool.phar (se você tiver instalado ZFTool usando composer ou github, você precisa compilar o zftool.phar executando o script “bin/create-phar”.

Criar um novo projeto ZF2

Você pode criar um novo projeto ZF2 usando o seguinte comando:

$ zf.php create project <path>
// or
$ zftool.phar create project <path>

Esse comando irá instalar o Zend Skeleton Application dentro do caminho especificado.

Criar um novo módulo

Imagine que você queira criar um novo módulo “Test” em um aplicativo ZF2 local; você pode executar o seguinte comando:

$ zf.php create module Test
// or
$ zftool.phar create module Test

Se você deseja criar um novo módulo dentro de um aplicativo instalado em um caminho diferente, você pode adicionar o caminho como o último parâmetro:

$ zf.php create module Test <path>
// or
$ zftool.phar create module Test <path>

Obter a lista de módulos instalados

Você pode obter a lista de todos os módulos instalados em um projeto ZF2 usando o seguinte comando:

$ zf.php modules<path>
// or
$ zftool.phar modules<path>

Esse comando deve ser executado a partir da pasta raiz de um aplicativo ZF2.

Obter o arquivo de configuração de um aplicativo ZF2

Você pode ler o arquivo de configuração (application.config.php) de uma aplicativo ZF2 usando o comando:

$ zf.php config<path>
// or
$ zftool.phar config<path>

A configuração de saída é reportada usando a função print_r do PHP.

Instalar a biblioteca ZF2

Usando a ZFTool, você pode instalar a biblioteca Zend Framework 2 escolhendo uma versão específica.

Por exemplo, você pode instalar a versão mais recente da ZF em um caminho específico, utilizando o seguinte comando:

$ zf.php install zf <path>
// or
$ zftool.phar install zf <path>

Se quiser instalar uma versão específica, você precisa especificar a versão como último parâmetro.

Por exemplo, você pode instalar a versão 2.0.4 da ZF usando o seguinte comando:

$ zf.php install zf <path> 2.0.4
// or
$ zftool.phar install zf <path> 2.0.4

Basicamente, você pode instalar toda a versão tag especificada no repositório github ZF2 (o nome usado para a versão é obtido removendo a string “release-“ do nome da tag; por exemplo, a tag “release-2.0.0” é equivalente ao número de versão “2.0.0”).

Compilar o zftool.phar

Você pode compilar o arquivo zftool.phar executando o seguinte comando:

$ bin/create-phar

Esse comando irá compilar o projeto ZFTool no arquivo zftool.phar na pasta bin.

Para mais informações sobre ZFTool, você pode ler o README.md no github.

***

Artigo traduzido pela Redação iMasters, com autorização do autor. Publicado originalmente em http://www.zimuel.it/en/zftool/