sercomi’s Blog

En el último post hablaba de cómo organizar un proyecto para Zend Framework, cómo crear directorios para diversos componentes, como son los índices para lucene, caché, logs y demás.

Pues hoy 17 de Marzo de 2008 ha sido presentada oficialmente la nueva versión de este Framework, la versión 1.5, que viene con las mejoras que ya expliqué en la entrada de la primera versión, la Preview release.

Uno de los añadidos que más se había esperado era el Zend_Layout, que es el componente que nos permite crear un Template para nuestro sitio y así favorecer enormemente la tarea de hacer el site lo más uniforme posible, a la vez que facilita mucho la programación.

Aunque la documentación, fuera del manual, aún deja un poco que desear os dejo unos enlaces a unos tutoriales que enseñan tanto a empezar con Zend Framework 1.5, como a utilizar Zend_Form y Zend _Layout.

• Getting Started with Zend Framework 1.5
• Simple Zend_Form example
• Simple Zend_Layout example

Y junto con la presentación de esta nueva versión también se ha efectuado una remodelación del sitio de Zend Framework para hacerlo más accesible.

Tutoriales de la página Akra’s DevNotes (en Inglés)

Con la llegada de la nueva versión de Zend Framework, la 1.5, se han añadido nuevos componentes para facilitarnos el desarrollo de aplicaciones php con dicho framework.

Una de las características más importantes que incorpora es la que nos permite desarrollar la aplicación diseñando con el patrón Two-Step-View o lo que es lo mismo diseñando la aplicación con Layouts.

Antes de empezar a picar código debemos pensar un poco en la estructura de directorios para nuestro proyecto, cómo organizar los archivos php, javascript, css, templates,… porque, si lo vamos haciendo sobre la marcha, nos pasará puede pasar que acabemos creando archivos donde no toca o directorios con archivos php que no tienen nada que ver entre sí y esto nos dará muchos problemas a la hora de llevar a cabo el mantenimiento de la aplicación.

En el manual de Zend Framework nos enseñan dos maneras de organizar los directorios, una estructura básica y la otra estructurada en modulos. Pero estás dos soluciones se quedan un poco cortas a medida que la aplicación va creciendo, y después no sabemos donde crear los helpers para controllers, archivos temporales de la caché.

En esta entrada quería enseñar una forma un poco más completa (que no tiene que ser la mejor) de estructurar un proyecto web basado en este Zend Framework.
Los directorios están pensados para la utilización de los componentes que nos aporta Zend Framework (caché, Lucene, locales,…) y también para guardar otros archivos que no están directamente relacionados con Zend pero sí con nuestro proyecto, como son los scripts SQL, scripts de línea de comandos CLI, PHPUnit, documentación.

zfApp/
    app/
        config/
        controllers/
        layouts/
        models/
        views/
            filters/
            helpers/
            scripts/
    data/
        cache/
        indexes/
        locales/
        logs/
        sessions/
        uploads/
    docs/
    html/
        css/
        images/
        js/
        .htaccess
        index.php
    lib/
        zfApp/
        Zend/
    scripts/
    tests/
    tmp/

Una vez enseñada la estructura voy a dar una pequeña explicación de algunos directorios y archivos:

• zfApp: Nombre de la aplicación
• app: Directorio de la aplicación donde irá la estructura MVC (Modelo Vista Controlador).
• config: Configuraciones Globals.php, config.ini.
• controllers: Controladores de MVC.
• layouts: Templates para las vistas si utilizamos el componente Zend_Layout.
• models: Modelos de los objetos.
• views: Páginas HTML que se generarán a partir de los controladores.
• data: Archivos de datos, organizados por carpetas según el tipo de datos a guardar.
• cache: Donde se guardarán los archivos de caché.
• indexes: Archivos de índices del buscador.
• locales: Archivos de internacionalización de la aplicación.
• logs: Directorio para se guardarán los archivos de log.
• sessions: Directorio donde guardar las sesiones.
• uploads: Directorio donde se podrán subirán archivos.
• docs: Documentación de la aplicación con phpDoc, pdf.
• html: Directorio público.
• css: Archivos de estilos.
• images: Imágenes.
• js: Archivos javascript.
• .htaccess: Archivo de Apache para la configuración módulo mod-rewrite.
• index.php: Archivo bootstrap, archivo PHP de entrada a nuestra aplicación.
• lib: Librerías Zend y propias.
• zfApp: Clases y funciones desarrolladas por nosotros, helpers de controllers,… (mismo nombre que la aplicación).
• Zend: Librería Zend Framework.
• scripts: Scripts CLI, generar indices Lucene, limpias cachés, SQL.
• tests: Archivos de test de la aplicación (PHPUnit).
• tmp: Archivos temporales.

Esta es mi propuesta de cómo se puede organizar un proyecto con Zend Framework.