O controlador ou Controller é a camada onde você faz as regras da sua aplicação, onde irá tratar as ações do usuário. Aqui você buscará os dados do model e tratará para a view, aplicando as regras de negócio, nada de códigos HTML, nada de CSS e nada de JavaScript, somente o poderoso PHP, códigos puros, sem misturas.


Como você deve ter visto na estrutura do Zeanwork, temos um diretório somente para armazenar os arquivos dos controllers, é localizado em App/Controllers/. Você também deve ter visto os padrões do Zeanwork, o nome do arquivo deve ser no padrão lowerCamelCase, seguindo com a extensão .php. Por exemplo: nomeDoController.php.

Todo controller deve ser uma classe, portando o nome da classe deve corresponder o nome do arquivo criado, acrescentando Controller. Por exemplo: Você criou um arquivo chamado nomeDoController.php, o nome da classe deve ser NomeDoControllerController, seguindo o padrão CamelCase.
Todos os controllers devem ser estendidos da classe AppController, pois o seu controller deve herdar os métodos do Zeanwork.

Veja exemplo de um controller chamado posts (post de um blog, por exemplo.):

class PostsController extends AppController {
}

Como o Zeanwork trabalha com a seguite estrutura de URL’s: /controller/action/..... Para executarmos este controller, devemos utilizar a seguinte URL: /posts.
Como você não definiu qual action será executada, o Zeanwork por padrão executará a action index, porem não criamos ela ainda, então será informado um erro.



As funcionalidades de um controller são separadas por métodos (functions) que são conhecidas como actions (ações). Cada action, como o nome já diz, executa uma ação no aplicativo.
É nas actions que você irá escrever os seus códigos que podem executar dirverços procedimentos, comunicar-se com o model e muito mais.
Estes métodos devem ser publicos, caso você deseja que um método não seja acessível pela URL, você deve definir este método como private ou protected.
O nome dos métodos devem seguir o padrão lowerCamelCase, por exemplo: nomeDaAction.

Veja exemplo:

class PostsController extends AppController {
	//Método acessível pela URL
	public function index(){
		//Procedimento qualquer.
	}

//Método acessível pela URL
	function view(){
		//Procedimento qualquer.
	}

//Método não acessível pela URL
	private function getPost(){
		//Procedimento qualquer.
	}
}

Veja como acessar as actions publicas:

/posts          //Acessará o método index
/posts/index    //Acessará o método index
/posts/view     //Acessará o método view

O Zeanwork possui algumas variáveis de configuração que determinam como proceder em determinadas situações.
Estas variáveis estão no nível da classe, portanto você pode seta-las em qualquer local do controller e até mesmo dentro de um método.

Veja as variáveis disponíveis:




Uma das funções do controller é comunicar-se com as views, para que isso venha acontecer devemos passar valores para as view quando necessário.

Veja os métodos e variáveis disponíveis:



Para receber dados de entrada (POST, GET, FILES...) o Zeanwok tem uma classe especialmente para isso. É a classe Input, ela esta disponível através da variável input nas classes Model, View e Controller.

Veja exemplo:

class PostsController extends AppController {
	public function index(){
		if($this->input->post()){
			$this->users->create($this->input->post());
		}
	}
}

Para saber mais sobre a classe Input, você deve buscar informações em: Classes >> Input



Pensando em velocidade, o Zeanwork trabalha com a tese de que não há necessidade de carregar o que não será utilizado, é por isso que temos algumas opções diferentes para carregar models, components, helpers e extensions.

Veja os métodos e variáveis disponíveis:



Os callbacks são métodos executadas em determinados momentos da execução da aplicação e do Zeanwork.

Veja os métodos disponíveis:

beforeExecution()	É executado antes de executar a action.
beforeRender()	É executado antes de renderizar a view.
afterExecution()	É executado depois de executar a action.

Para definir estes métodos, você deve criar estas funções no seu controller, também podem ser definidos no AppController.

Veja exemplo:

class PostsController extends AppController {
	public function beforeExecution(){
		$this->load->extension('date');
	}
}

Todos os controllers devem ser estendidos da classe AppController, pois o seu controller deve herdar os métodos do Zeanwork. Se você desejar criar métodos que serão utilizados em alguns dos seus controllers, você deve recriar o controller AppController no mesmo local dos controllers comuns, este controller deverá ser estentido da classe Model.

Veja exemplo:

class AppController extends Controller {
}

Caso você deseja definir components, helpers, extensions e cache para toda a aplicação, você deve fazer isso no AppController.

Veja as variáveis disponíveis:

Veja exemplo:

class AppController extends Controller {
	public $defaultsComponents = array('session', 'cookie');
	public $defaultsHelpers = array('html', 'pagination');
	public $defaultsExtensions = array('date');
	public $defaultCache = array('tweets' => array('index' => 300));
}