Este documento descreve a estrutura do projeto Snep utilizando o framework Zend. Ele explica a organização de arquivos, o uso do padrão MVC, bibliotecas como Zend_Db para acesso a dados e Zend_Forms para criação de formulários. Também aborda internacionalização com Zend_Translate e o registro de objetos com Zend_Registry.

1. Estrutura do Projeto: Amim Knabben < [email_address] > Rafael Bozzetti <rafael@thesource.com.br>

3. Zend Framework

4. Estrutura de arquivos do SNEP

5. Bootstrapping & Configuração

6. MVC & Forms

7. Bibliotecas de Apoio

9. A partir da versão 1.3.0 o ambiente Zend foi introduzido gradualmente no projeto.

10. A série 1.3.x convive com dois ambientes, o legado PHP e a nova estrutura Zend.

11. A série 1.4 foi totalmente reescrita utilizando o Zend Framework.

13. Visa a padronização e a reutilização de código.

14. É um padrão da indústria.

15. Possui parceiros tecnológicos como: IBM, Google e Microsoft.

16. Licença New BSD.

17. Versão estável: 1.11.3

19. `-- scripts

21. A configuração da estrutura do projeto é realizada no arquivo application.ini , e a interna do SNEP em /includes/setup.conf .

22. Ao final, o Zend_Application despacha a requisição para o Front Controller através do método run().

23. Diagrama de Sequência do Bootstrap

25. [production] resources.frontController.params.displayExceptions = 1 resources.frontController.controllerDirectory = APPLICATION_PATH &quot;/modules/default/controllers&quot; resources.frontController.moduleDirectory = APPLICATION_PATH &quot;/modules&quot; resources.layout.layoutPath = APPLICATION_PATH &quot;/modules/default/views/layouts&quot;

27. Pode ser lido pelo Zend_Registry::( 'config' )

28. O arquivo é lido com Zend_Config_Ini e armazenado no Registry. $config = Zend_Registry::get( 'config' ); echo $config -> system -> path -> base

30. Divide de forma organizada as categorias de: Apresentação, Lógica de Negócio e Acesso de Dados do projeto.

32. Atualmente utilizamos a biblioteca PHP-AGI juntamente com uma camada de abstração para facilitar o acesso do Zend a mesma.

34. São classes que manipulam as entidades através de rotinas para acesso aos dados e alguma lógica de negócio. /lib/Snep/ /lib/PBX/ /lib/Zend Acl.php Trunks.php Auth.php Alerts.php Interfaces.php Auth/Result.php Billing/Manager.php Rule.php Db.php Carrier/Manager.php Rule/Action.php Db/Select.php ... ... ...

36. O SNEP mantêm uma instância da classe Zend_Db no Zend_Registry, permitindo que seja recuperada e utilizada em qualquer ponto da aplicação.

37. Permite que qualquer tipo de consulta ou manipulação do banco de dados seja feita utilizando o padrão de desenho Table Data Gateway .

38. Zend_Db // Instância do registro db $db = Zend_Registry::get( “db” ); $select = $db ->select() ->from( “peers” ) ->where( “name != 'admin'” ) ->order( “id” ); $stmt = $db ->query( $select ); $resultado = $stmt ->fetchAll( );

40. system_data.sql – Contém os dados iniciais do banco.

41. cnl_data.sql – Contém os dados de localização de chamadas.

43. A atualização do banco de dados deve ser gradual, versão a versão. install/update/ ├── 1.1.0 │ └── database.sql ├── 1.1.3 │ └── database.sql ├── 1.1.6 │ └── database.sql ├── 1.2.0 │ └── database.sql ├── 1.3.0 │ └── database.sql ├── 1.3.1 │ └── database.sql └── 1.3.2 └── database.sql

45. Uma classe de controlador deve estender a classe Zend_Controller_Action .

46. O método indexAction() é necessário sendo este a ação padrão do Zend.

47. Cada método terá a uma ou mais Views .

48. Um controlador e seus métodos definem as URL's da aplicação.

49. Controllers // Definição de uma classe de controlador // Deve informar o módulo e ter um nome class Agents Controller extends Zend_Controller_Action { // Métodos de ação da Classe public function index Action() { } public function add Action() { } public function remove Action() { } public function edit Action() { } }

50. Controllers A estrutura do Controlador e seus métodos definem a URL da aplicação. $base_url = http://localhost/snep/index.php/ agents / index / indexAction() agents / add / addAction() agents / remove / removeAction() agents / edit / editAction()

52. No Snep utilizamos PHP , HTML e Javascript .

53. São divididas em pastas com o nome do controlador e um arquivo de template .phtml para cada método.

54. /modules/default/views/scripts/controller/action.phtml

55. Views

57. Cada form é definido em XML seguindo um padrão.

58. Define tipo e validação do elementos do formulário. $xml = new Zend_Config_Xml( &quot;./default/forms/example.xml&quot; )

59. $form = new Snep_Form( $xml );

60. $this -> view -> form = $form ;

61. Forms <?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?> <form> <elements> <nome> <type>text</type> <options> <label> Nome </label> <required> true </required> </options> </nome> <id> <type> hidden </type> </id> </elements> </form>

63. O método isValid () é responsável por validar os dados do formulário.

64. $isValid = $form -> isValid ( $_POST ); if ( $isValid ) { echo “Form Válido!” ; } else { echo “Form Inválido!” ; }

66. Esse mecanismo substitui o uso de variáveis globais. register_globals = Off. // Armazenando um objeto no Zend_Registry Zend_Registry::set( 'index' , $value ); // Armazenando um objeto no Zend_Registry $value = Zend_Registry::get( 'index' );

68. Toda e qualquer string deve ser definida com Zend_Translate(), desta forma ela torna-se dinâmica.

69. Como o Zend_Translate é um atributo da View, seu uso é diferente na Visão, Controlador e Modelo.

70. Zend_Translate // Uso na Visão echo $this ->translate( “Texto” ); // Uso no Controlador echo $this -> view ->translate( “Texto” ); // No Model deve-se recuperar a instancia. $i18n = Zend_Registry::get( 'i18n' ); $i18n ->translate( “Texto” );

71. Obrigado!