# O Básico de Zend_Controller

O sistema `Zend_Controller` é projetado para ser leve, modular, e extensível. É um projeto minimalista para permitir uma flexibilidade e alguma liberdade para usuários enquanto provê estrutura suficiente para os sistemas construídos envolta do `Zend_Controller` compartilhar algumas convenções comuns e layout de código.

O diagrama seguinte representa o processo, e a narrativa subseqüente descreve detalhadamente as interações:

O processo do `Zend_Controller` é implementado por vários componentes. Enquanto não é necessário entender completamente os por menores de todos estes componentes do sistema, ter um conhecimento básico do processo é útil.

- `Zend_Controller_Front` orquestra todo o processo do sistema `Zend_Controller`. Ele é o interpretador do padrão FrontController. `Zend_Controller_Front` processa todas as requisições recebidas pelo servidor e é o responsável direto pela delegação dos pedidos dos ActionControllers (`Zend_Controller_Action`).

- `Zend_Controller_Request_Abstract` (muitas vezes chamado de Request Object) representa o ambiente de pedido e fornece métodos para colocação e recuperação do controlador e nomes de ações e qualquer parâmetros passados. Adicionalmente ele guarda o registro de que a ação foi despachada ou não pelo `Zend_Controller_Dispatcher`. Extensões do objeto de requisição abstrata podem ser usadas para encapsular todo o ambiente de requisição, permitindo aos roteadores colocarem informações no ambiente de requisição para estabelecer o controlador e nomes de ação.

  Por padrão, `Zend_Controller_Request_Http` é usado, para fornecer acesso a todo o ambiente de pedido de HTTP.

- `Zend_Controller_Router_Interface` é usado para definir os roteadores. Roteamento é o processo de examinação da requisição do ambiente para determinar qual controlador e ação do controlador, devem receber a requisição. Este controlador, ação e parâmetros opcionais são incluídos no objeto de requisição para serem processados pelo `Zend_Controller_Dispatcher_Standard`. O roteamento ocorre somente uma vez: quando a requisição é inicialmente recebida e antes do primeiro controlador ser despachado.

  O roteador padrão, `Zend_Controller_Router_Rewrite`, pega uma URI no ponto especificado em `Zend_Controller_Request_Http` e a decompõe em um controlador, ação e parâmetros baseado na informação do caminho da URL. Por exemplo, a URL `http://localhost/foo/bar/key/value` pode ser decomposta para usar o controlador foo, a ação bar, e o parâmetro especificado key com o valor igual a value.

  `Zend_Controller_Router_Rewrite` também pode ser usado para combinar caminhos arbitrários; veja a documentação do roteador para mais informações.

- `Zend_Controller_Dispatcher_Interface` é usado para definir despachantes. Despachar é o processo de pegar o controlador e a ação do objeto de requisição e mapeá-lo para um arquivo de um controlador (ou classe) e método de ação na classe do controlador. Se o controlador ou ação não existir, ele determina o controlador e ação padrão para despachar.

  O processo atual de despacho consiste em instanciar a classe do controlador e chamar o método de ação nesta classe. Diferente do roteamento, que ocorre somente uma vez, o despacho ocorre em um laço. Se o status do objeto de requisição despachado é reiniciado em algum ponto, o laço irá se repetir, chamando qualquer ação atualmente estabelecida no objeto de requisição. A primeira vez que o laço do objeto de requisição terminar com o status ativado (Boolean `TRUE`), ele irá finalizar o processo.

  O despachador padrão é o `Zend_Controller_Dispatcher_Standard`. Ele define os controladores como MixedCasedClasses terminados com a palavra Controller, e os métodos de ações como camelCasedMethods terminadas com a palavra Action: `FooController::barAction()`. Neste caso, o controlador será chamado como foo e a ação como bar.

  ## Convenções de Nomenclatura para Maiúsculas e Minúsculas

  Desde que os seres humanos são notoriamente incapazes de preservar maiúsculas e minúsculas ao digitar links, o Zend Framework atualmente normaliza as informações sobre o caminho para minúsculas. Isto, naturalmente, afetará a forma como você nomeia o seu controlador e suas ações... ou referir-se a eles em links.

  Se você deseja que o nome de seu controlador de classe ou do método de ação tenham múltiplas MixedCasedWords ou camelCasedWords, você precisará, para separar as palavras na url, um '-' ou '.' (embora você pode configurar o caractere utilizado).

  Por exemplo, se você estava indo para a ação em `FooBarController::bazBatAction()`, você irá se referir a ela em uma url como `/foo-bar/baz-bat` ou `/foo.bar/baz.bat`.

- `Zend_Controller_Action` é o componente base do controlador de ação. Cada controlador é uma classe única que extende a classe `Zend_Controller_Action` e deve conter um ou mais métodos de ação.

- `Zend_Controller_Response_Abstract` define a classe básica de resposta usada para coletar e retornar repostas dos controladores de ação. Ela coleta tanto cabeçalhos como conteúdos de corpo.

  A classe de resposta padrão é `Zend_Controller_Response_Http`, que é conveniente para uso em um ambiente HTTP.

O processo do `Zend_Controller` é relativamente simples. Uma requisição é recebida pelo `Zend_Controller_Front`, que por sua vez chama `Zend_Controller_Router_Rewrite` para determinar qual controlador (e ação deste controlador) será chamado. `Zend_Controller_Router_Rewrite` decompõe o URI para poder determinar os nomes do controlador e da ação da requisição. `Zend_Controller_Front` então entrar em um laço de despacho. Ele chama `Zend_Controller_Dispatcher_Standard`, passando-lhe a requisição, para ser despachada para o controlador e ação especificados na requisição (ou usa os padrões). Depois que o controlador termina, o controle retorna para `Zend_Controller_Front`. Se o controlador indicar outro controlador para ser despachado através do reinicio do status de requisição, o laço continua e outro despacho é executado. De outra maneira, o processo termina.