3.1. Instalando una distribución de Symfony2

Las "distribuciones" de Symfony2, son aplicaciones totalmente funcionales que incluyen las librerías del núcleo de Symfony2, una selección de paquetes útiles, una estructura de directorios bien pensada y algunos archivos de configuración ya creados. Al descargar una distribución Symfony2, estás descargando el esqueleto de una aplicación funcional que puedes utilizar inmediatamente para comenzar a desarrollar tu aplicación.

Empieza por visitar la página de descarga de Symfony2 en symfony.com/download. En esta página, puedes encontrar la edición estándar de Symfony, que es la distribución principal de Symfony2. Existen dos formas de iniciar tu proyecto:

Opción 1 Composer

Composer es una librería que gestiona las dependencias de los proyectos PHP y que se puede utilizar para descargar la edición estándar de Symfony2.

Empieza por descargar Composer en cualquier directorio de tu ordenador. Si tienes la librería curl instalada, ejecuta el siguiente comando:

$ curl -s https://getcomposer.org/installer | php

Composer se distribuye en forma de archivo PHAR ejecutable, que puedes utilizar directamente para descargar la edición estándar de Symfony2 mediante el siguiente comando:

$ php composer.phar create-project symfony/framework-standard-edition /ruta/hasta/directorio-raiz-servidor-web/Symfony 2.4.0

Este comando puede tardar varios minutos en ejecutarse, ya que Composer descarga la distribución estándar de Symfony y todas las librerías que utiliza. Cuando finalice el comando, deberías tener la siguiente estructura de directorios:

www/ <-- este es el directorio raíz de tu servidor web
         (a veces se llama "htdocs" o "public")
    Symfony/ <-- el archivo descomprimido
        app/
            cache/
            config/
            logs/
        src/
            ...
        vendor/
            ...
        web/
            app.php
            ...

Opción 2 Descargar un archivo

También puedes descargar la edición estándar de Symfony mediante un archivo. En este caso, tendrás que tomar dos decisiones:

• Descargar o bien un archivo .tgz o .zip. Los dos son equivalentes, descarga aquel con el que te sientas más cómodo.
• Descargar la distribución con o sin vendors. Si tienes instalado Git en tu ordenador, debes descargar Symfony2 "sin vendors", ya que esa versión añade un poco más de flexibilidad cuando incluyas librerías de terceros.

Descarga uno de los archivos en algún lugar bajo el directorio raíz de tu servidor web local y descomprímelo. Si utilizas una línea de comandos, ejecuta las siguientes órdenes (sustituyendo ### por el nombre del archivo real):

# para un archivo .tgz
$ tar zxvf Symfony_Standard_Vendors_2.4.###.tgz

# para un archivo .zip
$ unzip Symfony_Standard_Vendors_2.4.###.zip

Si has descargado la versión sin vendors, no olvides leer la siguiente sección de este capítulo.

Todos los archivos públicos y el controlador frontal que procesa las peticiones en una aplicación Symfony2 se encuentran en el directorio Symfony/web/. Así que si has descomprimido Symfony en el directorio raíz del servidor web, las URL de tu aplicación empezarán siempre por http://localhost/Symfony/web/.

Para hacer que las URL sean más concisas, haz que el directorio raíz del servidor web apunte directamente al directorio Symfony/web/. Aunque esto no es necesario cuando estés desarrollando la aplicación, es muy recomendable cuando pases la aplicación a producción. Consulta la documentación de tu servidor web para saber cómo establecer otro valor para el directorio raíz.

3.1.1. Actualizando los vendors

Ahora que ya has descargado una versión completamente funcional de Symfony, ya puedes empezar a desarrollar tu aplicación. Los proyectos Symfony dependen de un montón de librerías externas. Todas estas librerías se descargan en el directorio vendor/ del proyecto mediante la herramienta Composer.

Dependiendo de cómo hayas descargado Symfony, puede ser obligatorio o no descargar sus vendors. En cualquier caso, actualizar los vendors siempre es algo recomendado, ya que te asegura que tienes las versiones más recientes de todas las librerías necesarias.

Primer paso: si no lo has hecho antes, descarga Composer ejecutando el siguiente comando:

$ curl -s http://getcomposer.org/installer | php

Asegúrate de descargar el archivo composer.phar en la misma carpeta donde se encuentra el archivo composer.json del proyecto (es decir, en el directorio raíz del proyecto).

Segundo paso: instala los vendors ejecutando el siguiente comando:

$ php composer.phar install

Este comando descarga tanto Symfony como todas sus librerías en el directorio vendor/ del proyecto.

$ php installer
$ php composer.phar install

"extra": {
    "symfony-app-dir": "app",
    "symfony-web-dir": "web",
    "symfony-assets-install": "symlink"
}

3.1.2. Instalando y configurando

En este punto, todas las librerías de terceros necesarias se encuentran en el directorio vendor/. También tienes una instalación predeterminada de la aplicación en app/ y algunos ejemplos de código dentro de src/.

Symfony2 incluye una interfaz visual para probar la configuración del servidor, lo que es muy útil para ayudarte a solucionar problemas relacionados con la configuración de tu servidor web y de PHP. Accede a la siguiente URL para examinar tu configuración:

http://localhost/config.php

Si hay algún problema, corrígelo antes de continuar.

// borra todo lo que contengan esos directorios
$ rm -rf app/cache/*
$ rm -rf app/logs/*

// cambia los permisos para el usuario del servidor web
$ HTTPDUSER=`ps aux | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\  -f1`
$ sudo chmod +a "$HTTPDUSER allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs

// cambia los permisos para el usuario de la consola
$ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs

$ HTTPDUSER=`ps aux | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\  -f1`
$ sudo setfacl -Rn -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX app/cache app/logs
$ sudo setfacl -dRn -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX app/cache app/logs

umask(0002); // Esto hace que los permisos sean 0775

// o

umask(0000); // Esto hace que los permisos sean 0777

Cuando todo esté listo, haz clic en el enlace "Visita la página de Bienvenida" para ver tu primera aplicación real en Symfony2:

http://localhost/app_dev.php/

En tu navegador deberías ver cómo Symfony2 te da la bienvenida y te felicita por tu arduo trabajo hasta el momento:

Figura 3.1 Página de bienvenida de Symfony2