Introducción

Recientemente estuve trabajando en un proyecto con el framework Symfony. Veamos cómo instalarlo y hacer el hola mundo para comenzar a trabajar con el mismo.

Lecturas recomendadas

Únicamente te invito a ver cómo instalar XAMPP en caso de que no tengas un servidor instalado en tu PC.

Comenzar proyecto con Symfony

Debes tener instalado composer. Si no lo tienes, instálalo y agrégalo a la variable PATH. Una vez que lo tengas, navega en la terminal hasta un lugar arriba de donde quieres crear tu proyecto.

Por ejemplo, si tus proyectos los guardas en C:\xampp\htdocs, entonces navega ahí, ya que con el comando que veremos se creará una carpeta. En otras palabras, no es necesario crear la carpeta en donde guardarás tu proyecto.

Una vez ahí, ejecuta:

composer create-project symfony/website-skeleton probarsymfony

En ese caso le indicamos a composer crear un proyecto (create-project) basado en el paquete symfony/website-skeleton y lo más importante es que al final indicamos en cuál directorio instalará nuestro proyecto; lo cual en mi caso es probarsymfony.

Comenzará a instalar las dependencias…

Se llevará un poco, hay que esperar. Al final nos dice cómo configurar nuestras bases de datos y hacer tests:

Lo más importante es que indica cómo ejecutar el proyecto. Veamos qué opciones tenemos.

¿Servir con servidor web o con PHP?

Aquí tenemos dos opciones. Servir nuestro proyecto como se suele hacer normalmente, a través de Apache y todo eso usando XAMPP o un paquete similar. O hacer que PHP sirva el proyecto.

Nota: si elegimos al servidor web, tendremos que agregar index.php al final de la URL para que las rutas sean entendidas. En cambio, si usamos el servidor de PHP no tendremos que hacer nada. Más abajo entenderás esto.

Con servidor web

Si ya tenemos un servidor configurado, por ejemplo XAMPP, entonces creamos nuestro proyecto ahí y navegamos al locahost/nombredetuproyecto/public. En mi caso navego a:

http://localhost/probarsymfony/public/

Y ya está todo servido. Ahora en el navegador puedo ver mi página:

Con servidor de PHP

Si no tenemos un servidor web o queremos que PHP se encargue, entonces navegamos a donde se creó el proyecto y ejecutamos:

php -S 127.0.0.1:8080 -t public

Ahí iniciamos un servidor en la dirección 127.0.0.1 en el puerto 8080, sirviendo el directorio public. Ahora simplemente navegamos a:

http://127.0.0.1:8080/

Y estará todo servido. En el navegador se ve así:

Lo que recomiendo

Es gusto de cada quien, pero mejor usar el servidor web, no el de PHP.

Hola mundo

Independientemente de cómo hayamos servido nuestra app, es hora de hacer nuestro hola mundo. Para ello navegamos a src/Controller y creamos el archivo HolaController.php. Ponemos este contenido dentro de él:

Lo único que estamos haciendo es definir nuestro controlador. Dentro de él escribimos una función llamada hola que lo único que hace es regresar una respuesta HTML.

¿Y desde dónde se llaman estas funciones? desde la URL, es decir, cuando el usuario navega a una URL las rutas son traducidas para saber a cuáles funciones llamar.

Eso lo configuramos en config/routes.yaml. Al final del archivo agregamos:

Primero ponemos el nombre de la ruta, por ahora no es importante pero hay que darle un nombre. Y le decimos que su ruta será /hola, para que al ser ejecutada llame a la función hola dentro del controlador HolaController.

Aquí viene la parte que explicaba arriba sobre poner index.php al final de la ruta. Si lo servimos con un servidor web, la ruta es:

http://localhost/probarsymfony/public/index.php/hola

Es decir, tenemos que agregar un index.php entre public y la ruta que definimos en el fichero YAML. Así se ve cuando navegamos a ella:

En cambio, si estamos sirviendo con PHP navegamos a:

http://127.0.0.1:8080/hola

La cual es una ruta más corta y luce así:

Y ya hemos hecho nuestro hola mundo en Symfony.

Alternativa a rutas

Symfony sugiere que, en lugar de configurar todo en el archivo YAML, usemos Anotaciones para definir las rutas en symfony.

¿Qué sigue?

Podemos crear más controladores, y configurar más rutas dentro del fichero de configuración routes.yaml. Más tarde conectaremos estos controladores con Modelos para seguir el patrón MVC e interactuar con bases de datos.