Ya sea para iniciar un nuevo proyecto, o para empezar a hacer pruebas con Zend Framework y aprender, necesitamos primero instalar Zend Framework. La instalación puede ser muy simple con solo copiar la carpeta donde esta la librería; pero se puede utilizar la herramienta Zend_Tool que nos permite realizar operaciones como crear proyecto, módulo, controlador, … actualizando el profile del proyecto en todo momento.

El entorno en el que esta hecho este pequeño tutorial es en Windows, habiendo instalado como servidor el conjunto de servidores que contiene XAMPP (Apache, MySQL, PHP, …). Si se ha hecho una instalación por defecto, XAMPP estará instalado en la ruta “C:\xampp\” y dentro estará la carpeta “php” que contiene el módulo de PHP y la carpeta “htdocs” donde esta el sitio web por defecto. En esta última carpeta se ha creado una carpeta de prueba llamada “testzf” para realizar allí esta tutorial.

Una vez descargado Zend Framework (actualmente la versión 1.10), ya sea el paquete Full o Minimal, se puede proceder a seguir el tutorial:

• Del archivo comprimido de Zend Framework, extraer las carpetas “bin” y “library” y copiarlas a la carpeta “C:\xampp\htdocs\testzf“.
• Abrir una línea de comandos, pulsando Inicio->Ejecutar, escribir “cmd” y Aceptar.
• Situarse en la carpeta “C:\xampp\htdocs\testzf“:

  cd C:\xampp\htdocs\testzf

• Editar el PATH de Windows para que ejecute comandos de la carpeta “C:\xampp\php“:

  SET PATH=%PATH%;C:\xampp\php

• Para comprobar que ha funcionado, ejecutar los siguientes comandos que devuelven las versiones de PHP y de Zend Framework:

  php -version
  zf show version

• Como se puede ver, la versión Zend Framework que devuelve no coincide con la versión que se ha copiado. Esto se debe a que XAMPP, en los numerosos paquetes que trae, se incluye una versión de Zend Framework: con XAMPP 1.7.3, viene la versión 1.9.6. Físicamente, ese Zend Framework se encuentra en la carpeta “C:\xampp\php\PEAR\Zend“. Para hacer que PHP detecte la versión que se ha instalado, hay que editar el archivo “C:\xampp\php\php.ini” y buscar la siguiente línea:

  include_path = ".;C:\xampp\php\PEAR"

  Modificarla para añadir el path a la librería copiada:

  include_path = ".;C:\xampp\htdocs\testzf\library;C:\xampp\php\PEAR"

  CUIDADO! El orden de los paths importa, ya que sinó se pueden detectar conflictos al cargar ambas librerías a la vez. La regla es: primero la más nueva y después las siguientes.

• Si se vuelve a solicitar la versión de Zend Framework, ya tendría que salir la versión que se ha copiado:

  C:\xampp\htdocs\testzf\library> zf show version
  Zend Framework Version: 1.10.0

• Ahora hay que sustituir la herramienta Zend_Tool que viene con XAMPP. Primero hay que renombrar dos archivos para no perderlos, y después copiar los archivos de Zend_Tool de la nueva librería:

  rename C:\xampp\php\zf.bat zf.bat.bak
  rename C:\xampp\php\zf.php zf.php.bak
  copy C:\xampp\htdocs\testzf\bin\zf.bat C:\xampp\php
  copy C:\xampp\htdocs\testzf\bin\zf.php C:\xampp\php

• Una vez instalado todo, se puede proceder a utilitzar la herramienta Zend_Tool. Para poder ver las diferentes opciones que ofrece esta herramienta, hay que ejecutar:

  zf --help

• Lo primero es crear el proyecto, ejecutando:

  zf create project C:\xampp\htdocs\testzf

• En la carpeta del proyecto se ha construido la estructura de directorios del proyecto, y un archivo con nombre “.zfproject.xml“. Este archivo es el profile del proyecto.

Según la arquitectura de Zend Framework, todas las peticiones tienen que dirigirse al archivo “C:\xampp\htdocs\testzf\public\index.php“. Para ello, hay que crear un VirtualHost en el Apache, operación que se realiza en dos simples pasos:

• Primero hay que modificar el sistema de Windows para resolver DNSs. Se edita el archivo “C:\WINDOWS\system32\drivers\etc\hosts“, y al final del archivo se añade la siguiente línea:

  127.0.0.1       testzf

  Así, cuando se le solicite a Windows por este dominio (testzf), hará las peticiones a si mismo haciendo un loopback.

• Ahora hay que configurar Apache, para que las peticiones que reciba solicitando el dominio introducido antes (testzf), se dirijan hacia la carpeta pública según Zend Framework. Para ello, hay que editar el archivo “C:\xampp\apache\conf\extra\httpd-vhosts.conf“, y descomentar la línea:

  ##NameVirtualHost *:80

  Eliminando las almohadillas:

  NameVirtualHost *:80

  Y añadiendo al final las siguientes líneas que indican el dominio y la carpeta:

  <VirtualHost *:80>
  	ServerName localhost
  	DocumentRoot "C:/xampp/htdocs/"
  	ServerAdmin admin@localhost
  </VirtualHost>
   
  <VirtualHost *:80>
      ServerName testzf
      DocumentRoot "C:/xampp/htdocs/testzf/public"
      SetEnv APPLICATION_ENV "development"
   
      <Directory "C:\xampp\htdocs\testzf\public">
          DirectoryIndex index.php
          AllowOverride All
          Order allow,deny
          Allow from all
      </Directory>
  </VirtualHost>

Si todo ha ido correctamente y reiniciando el servidor Apache para que los cambios surjan efecto, al utilizar un navegador y solicitar la página web “http://testzf”, se tiene que obtener página como la siguiente:

Falta comentar que la modificación del PATH se pierde cuando se cierra la ventana de línea de comandos. Para hacer permanentes las modificaciones, hay que modificar las “Variables de entorno“.

Más información en los siguientes links:

• SlideShare – Extending Zend_Tool
• Zend Developer Zone – Zend_Tool and ZF 1.8
• ZF Reference Guide – Zend_Tool

Entradas relacionadas:

1. Instalar y configurar Zend Framework y Zend_Tool para construir proyectos en Ubuntu
2. Configurar Subversion para utilizar los repositorios externos de Zend Framework
3. Configurar PHPUnit y Zend Framework
4. Instalar PHPUnit en el XAMPP de Ubuntu
5. Error con Zend Tool y el fichero NetBeansCommandsProvider.php