zf create form User

• username: Nome do usuário do sistema, login de acesso.
• fullName: Nome completo do usuário
• email: Endereço de e-mail do sujeito
• password: Senha de acesso ao sistema
• submit: Botão de submit

• username
  • O campo é obrigatório
  • Qualquer tag deverá ser removida
  • Espaços em branco das extremidades serão removidos
  • Não pode ser submetido em branco/vazio
  • Deverá contér entre 5 e 30 caracteres.

• fullName
  • O campo é obrigatório
  • Qualquer tag deverá ser removida
  • Espaços em branco das extremidades serão removidos
  • Não pode ser submetido em branco/vazio
  • Deverá contér entre 5 e 90 caracteres.

• email
  • O campo é obrigatório
  • Qualquer tag deverá ser removida
  • Espaços em branco das extremidades serão removidos
  • Deverá validar se o valor informado é compatível com um endereço de e-mail válido

• - password
  • O campo é obrigatório
  • Qualquer tag deverá ser removida
  • Espaços em branco das extremidades serão removidos
  • Não pode ser submetido em branco/vazio
  • Deverá contér entre 5 e 30 caracteres.

No primeiro capítulo desta série eu mostrei como configurar o seu ambiente de desenvolvimento para utilizar o Zend Framework com o Zend_Tool.

Model, View, Controller

O Zend Framework utiliza o pattern MVC, que permite que as camadas das aplicações sejam separadas em camadas.

Basicamente, as camadas do MVC são 3: Model (Modelo), View (Visão) e Controller (Controle) e cada uma dessas camadas devem implementar especificamente aquilo que diz respeito à funcionalidade em questão; Mas você deve estar se perguntando: “WTF esse cara tá falando? Até agora ele falou, falou e falou mas não disse diretamente o que é o Model, o View e nem o Controller”. E eu responderia: “Relaxa… , vou falar sobre isso agora.”.

Enfim, Vamos lá:

• A camada de modelo é onde nós implementamos a lógica de negócios, acesso a tabelas e banco de dados e a manipulação direta (INSERT, UPDATE, DELETE) desses dados.
• A camada de visão é aquela onde nós recebemos informação fornecida pelo usuário e também onde nós mostramos informações ao usuário proveniente da camada de modelo por exemplo.
• A camada de controle é a camada que nós usamos para unir os dados das duas camadas citadas anteriormente. Por exemplo: No controller nós podemos trabalhar com dados provenientes do modelo, prepara-lo e em seguida passa-los para a view que apresentará estas informações ao usuário; Nós podemos também por meio do controller, receber informações da camada de visão e passa-las à camada de modelo. Eu costumo dizer que esta camada trabalha como uma espécie de atravessador.

Não é minha intenção e nem pretensão falar tudo sobre MVC aqui e sim somente aquilo que é necessário para que você possa implementar uma aplicação utilizando este pattern em conjunto com o Zend Framework e mostrar como este framework o implementa.

Caso você queira saber mais sobre MVC siga os links abaixo:

• http://ootips.org/mvc-pattern.html
• http://pt.wikipedia.org/wiki/MVC

O MVC com Zend Framework

Eu prefiro mostrar como este padrão é implementado no Zend Framework na prática pois este é meu jeito e é isso que pretendo fazer neste tutorial, então, neste capítulo, sempre que eu for trabalhar com uma das camadas eu vou deixar isso bem explícito.

Será implementado algum projeto neste Tutorial?

Sim e como já existem vários tutoriais por aí que implementam Blog, Agenda, etc, nós implementaremos um sistema básico de contas a pagar utilizando o SQLite como SGBD.

• Entender o conceito de MVC aplicado ao Zend Framework.
• Criar Controllers, Actions e Views usando Zend Framework.

Estrutura de uma aplicação

• form_incluir_usuario.php -> Form de inclusão de usuários
• incluir_usuario.php -> Incluir usuário
• form_alterar_usuario.php -> Form de alteração de usuários
• alterar_usuario.php -> Alterar usuário
• excluir_usuario.php -> Excluir usuário
• listar_usuarios.php -> Listar usuários

• formAction -> Tela com formulário para inclusão e alteração de dados de usuário
• saveAction -> Realiza os procedimentos necessários para salvar um usuário
• deleteAction -> Exclui usuário
• indexAction -> Tela padrão que neste caso mostrará a listagem de usuários cadastrados.

class IndexController extends Zend_Controller_Action
{
	public function init()
	{
		/* Initialize action controller here */
	}
 
	public function indexAction()
	{
		// action body
	}
 
}

A primeira coisa que observamos é que o nome da classe é exatamente igual ao nome do arquivo (excluíndo o sufixo .php) e isso é uma regra.

Como vimos anteriormente, actions podem (e são na maioria dos casos) se relacionar a telas do nosso projeto, para isso nós temos que ter uma view template correspondente para que possa ser renderizada e apresentada na tela para o usuário.

Criando o UsersController

zf create controller users

Após executar este comando, o resultado será parecido com o trecho abaixo:

Creating a controller at /usr/local/zend/apache2/htdocs/zf-series/application/controllers/UsersController.php

Creating an index action method in controller Users

Creating a view script for the index action method at /usr/local/zend/apache2/htdocs/zf-series/application/views/scripts/users/index.phtml

Creating a controller test file at /usr/local/zend/apache2/htdocs/zf-series/tests/application/controllers/UsersControllerTest.php

Updating project profile ‘/usr/local/zend/apache2/htdocs/zf-series/.zfproject.xml’

Pronto! Nosso novo controller está criado, o nome dele é UsersController.php e ele também implementou para nós o indexAction e seu template. Dê uma olhada nos diretórios para você ver a mágica.

Como exercício, edite o arquivo de template index.phtml que está em application/views/scripts/users e coloque uma frase que te agrade lá. O meu ficou assim:

class UsersController extends Zend_Controller_Action
{
	public function init()
	{
		/* Initialize action controller here */
	}
 
	public function indexAction()
	{
		// action body
		$this->view->minhaFrase = "Os programadores são a Elite da TI";
	}
}

<!--?php echo $this--->minhaFrase ?&gt;

Pronto. Como nós estamos acessando o objeto diretamente da view, então basta manipularmos o atributo minhaFrase que criamos quando estávamos no controller diretamente usando $this.

Como exercício, crie mais alguns desses atributos na action em seu controller e mostre os valores em sua view. Beleza?Criando um Layout com Zend_Layout

Quando nós desenvolvemos sites/sistemas web com PHP nós costumamos usar código que se repete por meio de includes não é mesmo? Dessa forma se um dia essas informações precisarem ser modificadas nós modificamos em apenas um local.

 

O Zend Framework nos provê um componente para facilitar este trabalho e eu digo facilitar porque ele vai nos poupar até mesmo o trabalho de ter de realizar o include dos arquivos que devem ser reaproveitados.

 

Um caso bem comum é criarmos um arquivo chamado header.php (ou cabecalho.php) e outro chamado footer.php (ou rodape.php) e inclui-los em todas as páginas, certo? Bom, nós criaremos um layout com estas informações e todas as nossas telas serão mescladas com este layout e em seguida apresentado na tela para o usuário.

 

Vamos lá? Adivinha o que iremos usar agora? Acertou, o Zend_Tool.

 

Execute o seguinte comando em seu terminal/prompt do DOS:

 

zf enable layout

 

O resultado é o seguinte:

 

Layouts have been enabled, and a default layout created at /usr/local/zend/apache2/htdocs/zf-series/application/layouts/scripts/layout.phtml

A layout entry has been added to the application config file.

 

Isso tudo é muito lindo

 

Bom, vamos editar o arquivo que foi gerado em application/layouts/scripts/layout.phtml para deixa-lo mais ou menos assim:

 

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Zend Framework Tutorial Series</title>
<meta name="generator" content="TextMate http://macromates.com/">
<meta name="author" content="Adler  Medrado">
<!-- Date: 2010-02-15 -->
</head>
<body>
<div id="header">
<h1>Zend Framework Tutorial Series</h1>
</div>
<div id="content">
<p>Este é o layout do nosso sistema. Em breve nós iremos modifica-lo.</p>
<?php echo $this->layout()->content; ?>
</div>
<div id="footer">
<p>&copy; 2010 - Adler Medrado - http://adlermedrado.com.br</p>
</div>
</body>
</html>

 

 

No nosso layout nós definimos uma mensagem de título que está no header e uma mensagem de copyright no footer. Se você analisar bem este código, você verá que é feita uma chamada a um método chamado layout(); Este método é na verdade um Zend_View_Helper que faz a mesclagem do template do action que é executado no momento do request com o restante do layout.

Não se preocupe com o Zend_View_Helper pois em outros capítulos nós abordaremos justamente este recurso.

 

Simples o uso do layout né? Como exercício, execute novamente http://zf-series/users e veja o resultado.

Considerações Finais

Neste capítulo nós abordamos um pouco do C e do V (Controllers e Views) do MVC.

No próximo capítulo nós trabalharemos com formulários, filtraremos input, trataremos saídas e algumas cositas mas.

Espero que você tenha aproveitado este capítulo e espero também reve-lo no próximo.

A propósito, eu criei um grupo de discussão no Google Groups para que aqueles que estão seguindo a série de tutoriais possam discutir os exercícios. Caso você deseje participar deste grupo basta inscrever-se em: http://groups.google.com/group/zend-framework-series-br

Os fontes do tutorial encontram-se no github. Acesse: http://github.com/adlermedrado/Zend-Framework-Tutorial-Series

Abraços e até o próximo capítulo.