Symfony para PHP: guía completa con ejemplos

¿Qué es Symfony y para qué sirve?

Symfony es un potente, maduro y uno de los frameworks de componentes más populares para el lenguaje PHP. Está diseñado para crear aplicaciones web, desde sitios pequeños hasta complejos sistemas empresariales. A diferencia de los frameworks monolíticos, Symfony se basa en el principio de modularidad: consiste en un conjunto de componentes (bibliotecas) independientes, bien documentados y reutilizables. Puede usar todo el framework completo o solo algunos de sus componentes (por ejemplo, solo el componente de solicitud HTTP o enrutamiento) en cualquier otro proyecto PHP.

¿Para qué sirve?

\n
• Aceleración del desarrollo: Symfony proporciona soluciones listas para tareas típicas: enrutamiento, trabajo con bases de datos (a través de Doctrine ORM), plantillas (Twig), autenticación, procesamiento de formularios, almacenamiento en caché y mucho más. No necesita reinventar la rueda.
\n
• Estructuración y mantenibilidad: El framework impone una arquitectura clara (MVC — Modelo-Vista-Controlador), lo que hace que el código sea organizado, predecible y fácil de mantener por otros desarrolladores.
\n
• Fiabilidad y seguridad: Symfony tiene mecanismos integrados de protección contra vulnerabilidades comunes (CSRF, XSS, inyección SQL). Es utilizado por gigantes como Drupal, phpBB y muchos proyectos empresariales.
\n
• Comunidad y ecosistema: Una enorme comunidad, miles de bundles (extensiones) listos, excelente documentación y soporte a largo plazo (versiones LTS).
\n
• Flexibilidad: Puede comenzar con un micro-framework (Symfony MicroKernel) para APIs e ir conectando gradualmente los componentes necesarios a medida que el proyecto crece.
\n

Instalación de Symfony

A diferencia de Python (donde se usa pip), en PHP se utiliza Composer para la gestión de dependencias. La instalación de Symfony consta de dos pasos: instalar el instalador en sí (Symfony CLI) y crear el proyecto.

1. Instalación de Composer

Si aún no tiene Composer, descárguelo e instálelo desde el sitio oficial getcomposer.org. Es una herramienta global para PHP.

# Verificar la instalación de Composer\ncomposer --version

2. Instalación de Symfony CLI (recomendado)

Symfony CLI es una herramienta conveniente para crear, gestionar y ejecutar proyectos.

# Instalación en macOS/Linux (a través de curl)\ncurl -sS https://get.symfony.com/cli | bash\n\n# Instalación en Windows (a través de Chocolatey)\nchoco install symfony-cli\n\n# Verificación\nsymfony --version

3. Creación de un nuevo proyecto

Use el comando symfony new para crear el esqueleto de la aplicación.

# Crear una aplicación web completa (con Symfony Flex)\nsymfony new my_project --full\n\n# Crear una micro-aplicación (para API)\nsymfony new my_api_project

Si no desea instalar CLI, puede usar Composer directamente:

composer create-project symfony/skeleton:"7.0.*" my_project\n# O para una aplicación completa:\ncomposer create-project symfony/website-skeleton:"7.0.*" my_project

Inicio rápido con un ejemplo de código

Vamos a crear una página simple "¡Hola, Mundo!" usando Symfony.

1. Crear un controlador

Un controlador es una clase PHP que procesa una solicitud y devuelve una respuesta. Cree el archivo src/Controller/HelloController.php:

<?php\n// src/Controller/HelloController.php\n\nnamespace App\\Controller;\n\nuse Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController;\nuse Symfony\\Component\\HttpFoundation\\Response;\nuse Symfony\\Component\\Routing\\Annotation\\Route;\n\nclass HelloController extends AbstractController\n{\n    #[Route('/hello/{name}', name: 'hello_page')]\n