Instalando e iniciandose con Symfony 1.4

Symfony es un framework para desarrollar aplicaciones web de manera rápida bajo PHP.

Actualmente se encuentra en su versión 1.4, y a la fecha es uno de los frameworks más populares para desarrollar con PHP (junto con CakePHP y el Zend Framework...)

El sitio web de Symfony presume su framework como uno de los más rápidos, no sólo para desarrollar, sino también para aprender. Según ellos, siguiendo sus tutoriales en un programa sencillo de aprendizaje, se podría decir que se toman exactamente 2 días (48 horas) en aprender Symfony. En realidad se podría llevar un poco más, dependiendo el tiempo libre que se tenga (además de que hay que dormir, comer y demás...)

La instalación, configuración y levantamiento de un primer proyecto en Symfony es, en realidad, sencillo:



Requisitos previos
Un entorno LAMP podría ser suficiente (GNU/Linux  /  Apache  /  MySQL  /  PHP), o WAMP si se prefiere. En vez de MySQL, Symfony también puede trabajar, gracias a Doctrine, su ORM por defecto, con PostgreSQL, SQLite entre otros.

El script localizado en:

http://sf-to.org/1.4/check.php

Permite verificar si las características de la máquina corresponden con las necesarias para instalar y utilizar Symfony. Se baja el script y se ejecuta en el equipo con:

php check_configuration.php

Instalación
Lo primero es descargar Symfony. En http://www.symfony-project.org/installation se encuentra una pequeña guía para bajar la versión que se desee instalar.

Una vez con el paquete, debe descomprimirse (con tar -xzvf archivo.tar.gz) El directorio en donde se descomprime el paquete será el lugar en donde los proyectos de Symfony consultarán para los archivos que comparten dichos proyectos. El directorio en donde queda descomprimido Symfony se puede renombrar a symfony para simplificar.

Hecha la instalación, se puede verificar que todo está en orden con:

php ruta_donde_se_descomprimio_symfony/symfony/data/bin/symfony -V

lo cual debe mostrar la versión instalada de Symfony.

Si no se le pasan parámetros a symfony, se muestran todos los comandos disponibles para Symfony.


Creación de un proyecto
Ubicados ya en el lugar en donde se desea crear el proyecto Symfony, se escribe:

php ruta_donde_se_descomprimio_symfony/symfony/data/bin/symfony generate:project NOMBRE_PROYECTO

Lo cual creará dentro del directorio actual la estructura de un proyecto Symfony, que incluye varios directorios, utilizados por el framework para acceder a los recursos: la aplicación, el MVC, la base de datos, etc.

También se crea un acceso directo a symfony, para no tener que teclear toda la ruta donde se descomprimió el framework.

Configuración de la Base de Datos
La conexión a la Base de Datos se configura con un simple comando de Symfony:

php symfony configure:database "mysql:host=localhost;dbname=nombrebd" usuario password

Por default, Symfony utiliza Doctrine como ORM. Aunque también se puede utilizar Propel.

Creación de una aplicación
En Symfony, los proyectos se componen de aplicaciones (que a su vez se componen de módulos, y estos de tareas -o tasks-).

La aplicación principal, el portal por así decirlo, se llama frontend (mientras que la aplicación de administración se llama backend). La creación de una aplicación es un proceso sencillo:

php symfony generate:app frontend

Esto creará, dentro del directorio del proyecto, en el subdirectorio apps, un subdirectorio llamado frontend, con la estructura que el framework utiliza para sus aplicaciones.

Otras configuraciones
Hay algo que debe tenerse en cuenta también, y es que los subdirectorios cache y log del proyecto deben poder ser vistos y escritos por cualquier usuario del sistema. En GNU/Linux:

chmod 777 cache/ log/

Configuración del servidor web
Para poder acceder al proyecto, ya sea en desarrollo o en producción, el servidor web debe configurarse para que se pueda ver dicho proyecto. Una forma sencilla, pero poco elegante, es crear el proyecto directamente en el directorio en donde el servidor web publica, por ejemplo /var/www. Sin embargo, la mejor manera es utilizando VirtualHosts:

NameVirtualHost 127.0.0.1:8080
Listen 127.0.0.1:8080
<VirtualHost 127.0.0.1:8080>
  DocumentRoot "ruta_al_proyecto/web"
  DirectoryIndex index.php
  <Directory "ruta_al_proyecto/web">

    AllowOverride All
    Allow from All 

  </Directory>

  Alias /sf ruta_donde_se_descomprimio_symfony/symfony/data/web/sf 

  <Directory "ruta_donde_se_descomprimio_symfony/symfony/data/web/sf">
    AllowOverride All
    Allow from All  

  </Directory>
</VirtualHost>

Con lo cual, se podrá acceder a la aplicación en http://localhost:8080. Obviamente, se puede configurar otro puerto, y los directorios deben apuntar a donde se encuentre en realidad el proyecto. Nótese el segundo alias, el que dice /sf, este apunta a donde se instaló Symfony. Esto se debe a que todo proyecto espera encontrar en su ruta /sf todo aquello que Symfony pone a disposición de todos los proyectos. En vez de descromprimir Symfony intacto proyecto por proyecto, un Alias simplifica esta labor.

Y precisamente, lo único que queda es probar.

Accediendo a:
http://localhost:8080/index.php/

Se debe de poder ver la pantalla de bienvenida por default que Symfony le pone a todos sus proyectos.

En:

http://localhost:8080/frontend_dev.php/

se accede a la misma aplicación pero en la versión de desarrollo. Podrán notarse (si se configuró correctamente el VirtualHost), que aparecen en la parte superior derecha los iconos para diversa información útil a un desarrollador.


Symfony tiene muchas características interesantes. Es un framework que puede dar mucho de sí mismo, sólo es cosa de ponerse a aprenderlo, en un proceso que de por sí no es complicado. Una buena guía se puede encontrar en el tutorial Jobeet, para aprender Symfony en 48 horas...

Nota: este tutorial, salió prácticamente intacto de lo que establece la guía Getting started del sitio de Symfony.