Skip to content

1. Introducción

El PDF del documento está |AQUÍ|.

Los códigos del documento están |AQUÍ|.

Este documento es un producto de la IA Claude de Anthropic. Sigue al documento “Introducción paso a paso al framework web [Laravel]” (2026), que a su vez siguió a los documentos “Introducción paso a paso al framework web [Flask],” "Introducción paso a paso al framework web [Spring MVC]," "Introducción paso a paso al framework web [ASP.NET Core MVC]" y "Introducción paso a paso al framework web [NestJS]" (2026). Este documento permanece dentro del universo [PHP] pero cambia de framework:

  • el framework [Laravel] se reemplaza por el framework [Symfony] 8.1, que sigue utilizando el lenguaje [PHP] (versión 8.4 o posterior);
  • las vistas [Blade] se reemplazan por vistas [Twig], el motor de vistas de [Symfony];
  • la validación mediante las reglas de [Laravel] y las solicitudes de formulario ([FormRequest]) se reemplaza por el componente Validator de [Symfony] (restricciones, escritas como atributos de [PHP]) y por su componente Form, que describe los formularios mediante clases;
  • los guardias, los middleware y los componentes [Gate] de [Laravel] se reemplazan por el componente Security de [Symfony]: firewalls, autenticadores, roles, hash de contraseñas y un limitador de intentos, complementado con la biblioteca [firebase/php-jwt] para los tokens JWT;
  • Sin embargo, los componentes middleware no existen en [Symfony]: los listeners de eventos se utilizan para intervenir en el procesamiento de la solicitud;
  • el ORM [Eloquent] se reemplaza por [Doctrine], un ORM utilizado con [Symfony], que a su vez se apoya en [MySQL].

El documento sigue de cerca la estructura del curso de [Laravel]: primero, numerosos proyectos pequeños, cada uno centrado en un solo concepto, seguidos de un caso de estudio completo (una aplicación web para agendar citas en un consultorio médico) con todos los archivos comentados en detalle. Los ejemplos tienen los mismos números y abordan los mismos temas que en los cursos de [Laravel], [Flask], [Spring MVC], y [ASP.NET Core MVC]: un lector familiarizado con alguno de estos cursos puede comparar los frameworks ejemplo por ejemplo. Sin embargo, esto no es indispensable: este documento se basta a sí mismo y no supone ningún conocimiento previo de esos frameworks. Los únicos requisitos son una comprensión básica de la programación web (el protocolo HTTP, el lenguaje HTML) y los fundamentos del lenguaje [PHP] (variables, arreglos, funciones, clases). El curso “Introducción al lenguaje PHP7 mediante ejemplos” (2019) presenta el lenguaje en sí para quienes necesiten aprenderlo primero; las novedades de [PHP] 8 que se usan aquí (propiedades promovidas, clases [readonly], atributos, enumeraciones, argumentos con nombre, el operador nullsafe, etc.) se explican la primera vez que aparecen.

1.1. El papel de Symfony en una aplicación web

Una aplicación web suele construirse en capas, y cada capa se comunica únicamente con las capas vecinas:

Image

  • la capa web recibe las solicitudes HTTP del navegador y le devuelve páginas HTML. Es la capa que [Symfony] nos ayuda a escribir;
  • la capa de negocio contiene las reglas de negocio de la aplicación (por ejemplo, “un paciente solo puede tener una cita próxima”). No sabe nada de la web: podría servir igualmente a una aplicación de línea de comandos;
  • la capa de acceso a datos (capa DAO, por Data Access Object) lee y escribe en la base de datos. Usaremos [Doctrine], el ORM (Object Relational Mapper) asociado con [Symfony], que asigna las filas de las tablas a objetos [PHP].

La capa web sigue a su vez el patrón MVC (Model-View-Controller):

  • el controlador (C) es una clase [PHP] cuyos métodos, llamados acciones, se encargan cada uno de un tipo específico de solicitud (por ejemplo, [GET /schedule]). Una acción lee los parámetros de la solicitud, procesa la solicitud a través de la capa de negocio y luego selecciona la vista que se mostrará;
  • el modelo (M) es el conjunto de datos que la acción pasa a la vista;
  • la vista (V) es un archivo [Twig] (extensión [.html.twig]): una página HTML que contiene expresiones [{{ ... }}] e instrucciones [{% if %}], [{% for %}]..., que el motor [Twig] reemplaza por los datos del modelo.

Una nota sobre la terminología, para evitar confusiones: en [Symfony], las clases que representan las tablas de la base de datos se llaman entidades (carpeta [src/Entity]). En este documento, el término “modelo” se referirá siempre al modelo de la vista (los datos que se pasan a una vista) o, en el capítulo 2, al modelo de la acción (los datos que esta recibe). El término “plantilla” designa la vista común de la que heredan otras páginas (capítulo sobre las vistas).

El procesamiento de una solicitud sigue los pasos numerados del diagrama:

  • 1: El navegador envía una solicitud, por ejemplo HTTP o [GET /schedule?doctorId=1&day=2026-09-26];
  • 2: El servidor web recibe la solicitud y la pasa a la aplicación [Symfony] a través del archivo [public/index.php]. Durante el desarrollo, este servidor es el que incluye [PHP], iniciado con el comando [php -S localhost:8000 -t public]; en producción, será un servidor como [nginx] o [Apache], asociado con [PHP-FPM]. El archivo [public/index.php] pasa la solicitud al núcleo (kernel) de la aplicación, que la hace pasar por una serie de eventos: intervienen clases de [Symfony] y de la aplicación, así como listeners (sesión, seguridad, idioma, etc.). Uno de ellos compara la ruta solicitada con las rutas de la aplicación y selecciona la acción responsable de esta solicitud: es el enrutamiento;
  • 3: La acción solicita a la capa de negocio los datos que necesita; si es necesario, la capa de negocio recurre a la capa DAO, que consulta en SQL la base de datos [MySQL];
  • 4: La acción construye el modelo M de la vista e indica al motor [Twig] que genere la página (método [render]);
  • 5: La página HTML generada por la vista es la respuesta de la acción, que [Symfony] devuelve al navegador.

[Symfony] es, junto con [Laravel], uno de los dos grandes frameworks web del mundo [PHP]. Gratuito y de código abierto, creado en 2005 por Fabien Potencier (y la empresa francesa SensioLabs), funciona en cualquier lugar donde funcione [PHP] ([Windows], [Linux], [macOS]), y [PHP] funciona con casi todos los proveedores de alojamiento web. [Symfony] es, ante todo, una colección de unos cincuenta componentes, bibliotecas independientes (solicitudes y respuestas HTTP, enrutamiento, consola, formularios, validación, seguridad, etc.), tan apreciadas que otros proyectos las utilizan: [Laravel] mismo se construye sobre varias de ellas, y los lectores del curso anterior ya las han encontrado. El framework [Symfony] ensambla estos componentes mediante bundles (paquetes de integración) y un contenedor de servicios que crea los objetos de la aplicación. En comparación con [Laravel], [Symfony] toma decisiones claras: nada de fachadas ni funciones globales, sino servicios obtenidos mediante inyección de dependencias; configuración explícita en archivos YAML; atributos de [PHP] ([#[Route]], [#[Assert\NotBlank]]...) para describir el código; un ORM, [Doctrine], que separa los objetos de su persistencia. Es un framework reconocido por su rigor, su documentación y su política de versiones: una versión menor cada seis meses, una versión de “soporte a largo plazo” cada dos años y la garantía de que una aplicación sin advertencias de obsolescencia pasará a la siguiente versión mayor sin modificaciones. [Symfony] puede crear servidores que devuelven JSON a un cliente [JavaScript] ([Angular], [React], [Vue.js], [Flutter]...) así como aplicaciones web tradicionales, donde el servidor genera las páginas HTML y el navegador se limita a mostrarlas. Es este segundo caso de uso el que examina este documento.

Una particularidad de [PHP] explica buena parte de [Symfony]: la aplicación se reconstruye en cada solicitud y luego se descarta (ejemplo 01). [Symfony] compensa este costo compilando su configuración una sola vez en código [PHP], que se almacena en un caché (carpeta [var/cache]). Volveremos a esto con frecuencia.

1.2. Herramientas utilizadas

Los ejemplos se escribieron y probaron con las siguientes herramientas (su instalación se describe en el apéndice):

  • [PHP] 8.4 (sirve cualquier versión 8.4 o posterior), con las extensiones [intl], [mbstring], [openssl], y [pdo_mysql];
  • [Composer] 2, el administrador de bibliotecas de [PHP];
  • el editor [Visual Studio Code], con las extensiones [PHP Intelephense] (análisis de código), [Twig Language 2] (vistas) y [YAML] (archivos de configuración);
  • un navegador moderno ([Chrome], [Firefox], [Edge]);
  • la herramienta de línea de comandos [curl], que muestra las respuestas HTTP sin procesar (viene incluida con [Windows] 10 y 11);
  • un SGBD, [MySQL] (o [MariaDB]), por ejemplo, el de [Laragon] en [Windows], a partir del capítulo sobre el acceso a datos y para el caso de estudio. En [Windows], [Laragon] instala [PHP], [Composer], y [MySQL] de una sola vez.

[Symfony] y las demás bibliotecas no forman parte de [PHP]: [Composer] las descarga del repositorio [Packagist] durante la instalación (por lo tanto, ese día debe estar conectado a Internet) y las coloca en una carpeta [vendor]. Cada proyecto describe sus bibliotecas en un archivo [composer.json]. La siguiente tabla enumera las principales, junto con las versiones utilizadas:

[symfony/framework-bundle]
el framework: núcleo, enrutamiento, controladores, contenedor de servicios, configuración, sesión, caché; instala los componentes que necesita ([symfony/http-foundation], [symfony/http-kernel], [symfony/routing], [symfony/dependency-injection]...)
8.1.7
[symfony/twig-bundle], [twig/twig]
las vistas [Twig] (capítulo sobre las vistas)
8.1.7, 3.30.0
[symfony/validator], [symfony/form]
Validación (a partir del ejemplo 08) y formularios (a partir del ejemplo 17)
8.1.7
[symfony/security-bundle]
Autenticación y autorización (capítulo de seguridad)
8.1.7
[symfony/translation]
Traducciones (ejemplos 09 y 22)
8.1.7
[doctrine/orm], [doctrine/dbal], [doctrine/doctrine-bundle]
acceso a la base de datos (ejemplo 28 y caso de estudio)
3.7.2, 4.5.0, 3.3.2
[firebase/php-jwt]
tokens JWT (capítulo sobre la autenticación)
7.2.0

[Symfony] se instala normalmente creando un proyecto completo con el comando:

composer create-project symfony/skeleton my-project

o con la herramienta de línea de comandos de [Symfony] (el programa [symfony]; véanse los apéndices): [symfony new my-project --webapp]. [Composer] descarga entonces el esqueleto de una aplicación [Symfony], seguido de sus bibliotecas. El esqueleto contiene además [Symfony Flex], un plugin de [Composer] que, cada vez que se instala una biblioteca ([composer require twig]), escribe sus propios archivos de configuración a partir de plantillas publicadas en línea. Así es como se inicia un proyecto real. Con fines de aprendizaje, este método tiene un inconveniente: los archivos aparecen solos, sin que se sepa para qué sirven. Por ello, los ejemplos de este documento parten del otro extremo: el ejemplo 01 es la aplicación [Symfony] más pequeña posible, y cada ejemplo añade solo los archivos que necesita, escritos y comentados a mano. El caso de estudio final sigue la estructura de una aplicación [Symfony] estándar.

1.3. Ejecutar el caso de estudio

1.3.1. Instalación de Laragon

El caso de estudio requiere un SGBD, MySQL, un intérprete de PHP y el instalador de paquetes PHP [composer]. Laragon puede proporcionar todo esto y más. A septiembre de 2026, Laragon está disponible en la URL y [Download Laragon – Fast & Modern Dev Environment ]. Laragon incluye herramientas que permiten instalar un servidor PHP y el SGBD y [MySQL]:

Image

  • en [1], un servidor web Apache;
  • en [2], el SGBD y [MySQL];
  • en [3], una herramienta de mensajería que no usaremos;
  • [4] inicia todos los servicios (Apache, [MySQL], MailPit);
  • [5] muestra la página web de la URL y [http://localhost]. De forma predeterminada, esta URL hace referencia a la carpeta <laragon-install>\www, donde <laragon-install> es la carpeta de instalación de Laragon;
  • en [6], inicia la herramienta HeidiSQL, que permite administrar bases de datos MySQL. Usaremos esta herramienta para crear la base de datos que utiliza el caso de estudio;
  • En [7], abre un terminal; todos los binarios necesarios para Laragon están en el PATH;
  • En [8], abre una ventana del Explorador de Windows en la carpeta asociada con la URL y [http://localhost];

La carpeta de instalación de Laragon contiene los siguientes elementos:

 
  • En [1], la carpeta [bin] contiene numerosas aplicaciones:
  • En [1], el servidor web Apache;
  • en [2], un terminal de línea de comandos;
  • en [3], un cliente [git] que permite administrar las diferentes versiones de un proyecto;
  • en [4], un administrador de bases de datos;
  • en [5], un administrador de correo;
  • en [6], el SGBD y [MySQL];
  • [7], otro servidor web;
  • en [8], [node.js] para ejecutar scripts JavaScript;
  • [9], un editor de texto;
  • [10], el intérprete de PHP;
  • [11], el intérprete de [Python];
  • [12], un servidor de caché;

Laragon incluye un entorno de desarrollo completo. En este curso usaremos:

  • el SGBD, [MySQL], [6], y la herramienta [heidisql] para la administración gráfica;
  • el intérprete de PHP 8.5;
  • el instalador de paquetes [composer];

El README del caso de estudio indica que debe ingresar los siguientes comandos en un terminal:

composer install

para instalar los paquetes PHP necesarios para los ejemplos y el caso de estudio.

php -S localhost:8000 -t public

para ejecutar uno de los ejemplos o el caso de estudio. Si usa un terminal [PowerShell] dentro de VSCode, se encontrará con el siguiente problema: ni [composer] ni [php] están presentes en el directorio PATH de la máquina Windows después de instalar Laragon. Por lo tanto, estos comandos no serán reconocidos en un terminal de VSCode.

Para incluir [composer] y [php] en el PATH de la máquina Windows, abra un terminal PowerShell en modo [administrator] y luego escriba los siguientes comandos:

[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\laragon\bin\composer","Machine")
[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path", "Machine") + ";C:\laragon\bin\php\php-8.5.11-nts-Win32-vs17-x64","Machine")

Ajuste las dos rutas resaltadas según su entorno.

Deberá reiniciar VSCode para que estos cambios surtan efecto.

Para crear la base de datos [MySQL] necesaria para el caso de estudio, proceda de la siguiente manera:

 
  • En [1], todos los servicios deben estar iniciados;
  • en [2], la opción [Database] permite administrar la base de datos;

La opción [Database] inicia una utilidad llamada HeidiSQL:

  • En [1], puede seleccionar diversas opciones de SGBD. El valor predeterminado es SGBD MySQL. Es aceptable;
  • en [2], inicia sesión en HeidiSQL;
  • En [1-2], ejecute el archivo SQL y luego seleccione el archivo [dbrdvmedecins2.sql], que encontrará en la carpeta [symfony-sept-2026/rdvmedecins2-symfony/database]:

Image

Al ejecutar el archivo [3] se creará la base de datos [dbrdvmedecins2] que utiliza el caso de estudio. Para verla, ejecute F5 dentro de HeidiSQL para actualizar la pantalla:

Nota del editor: Las siguientes capturas de pantalla muestran una base de datos llamada [dbrdvmedecins], mientras que la base de datos del caso de estudio se llama [dbrdvmedecins2]. Las dos bases de datos son prácticamente idénticas, por lo que consideramos innecesario tomar nuevas capturas.

Fin de la nota

Image

La base de datos [dbrdvmedecins] se ha creado. Este es su contenido:

Image

  • en [1-3], la tabla [clients];
    • [id] es la clave primaria de la tabla;
    • [version] es el número de versión de la fila. Este número se incrementa cada vez que se modifica la fila;
    • [titre, nom, prenom] identifica a la persona;

Image

  • en [1-3], la tabla [medecins];
    • [id] es la clave primaria de la tabla;
    • [version] es el número de versión de la fila;
    • [titre, nom, prenom] identifica a la persona;

Image

  • En [1-3], la tabla de los intervalos de citas de los médicos:
    • [id]: clave primaria;
    • [version]: número de versión de la fila;
    • [id-medecin]: clave externa que referencia la clave primaria del médico;
    • [hdebut, mdebut]: hora y minutos de inicio de la cita. Así, [8,20] significa 8:20 a. m.
    • [hfin, mfin]: hora y minutos de finalización de la consulta.

Image

  • En [1-3], la tabla [rv] de las citas agendadas;
    • [id]: clave primaria;
    • [version]: número de versión;
    • [jour]: fecha de la cita;
    • [id_creneau]: clave externa que referencia la clave primaria del intervalo de la cita. Como un intervalo está vinculado a un médico, sabemos qué médico atiende esta cita;
    • [id_client]: clave externa al número (clave primaria) del paciente que asiste a la cita;

Image

  • en [1-3], la tabla [users] enumera los usuarios autorizados a utilizar la aplicación RdvMedecins;
    • [id, version]: clave primaria, número de versión;
    • [login, password]: credenciales del usuario;
    • [nom]: nombre del usuario;
    • [role]: el rol del usuario. [ADMIN] tiene todos los derechos de acceso. [USER] tiene acceso de solo lectura. Este usuario puede consultar la agenda de un médico, pero no puede agendar ni cancelar una cita;

1.3.2. Ejecución del caso de estudio

Nota del revisor: Aconsejo al lector ejecutar de inmediato el caso de estudio como se describe a continuación. Una vez que haya comprendido bien el propósito de esta aplicación de agenda de citas, pida a su IA favorita que modifique la aplicación de la siguiente manera: a partir de ahora, cada médico podrá:

  • definir sus propios intervalos de citas entre dos fechas. Esto le permitirá ajustar su agenda según sea necesario;
  • quitar ciertos intervalos del calendario en un día determinado, por ejemplo, si no está disponible por motivos personales;

La modificación no es trivial porque implica un cambio en la estructura de la base de datos. Pida a la IA que le proporcione el nuevo código de la aplicación y el script SQL para crear la nueva base de datos. Para ello, deberá entregarle el archivo ZIP con el proyecto completo, así como el script SQL de la base de datos anterior.

Además, no he revisado el curso creado por Claude. Él ya había producido los cursos [NestJS], [ASP.NET Core MVC], [Spring MVC] y [Flask], todos perfectos. Supuse que lo mismo ocurriría con este. Si tiene problemas para entender algo, la solución es siempre la misma: pida a su IA favorita que le explique lo que no entiende. Claude, por ejemplo, es muy bueno en esto. Quizá deba “subirle” el ejemplo que no entiende.

Fin de la nota.

El caso de estudio al final de este documento es una aplicación completa. Es probable que el lector quiera verla en acción antes de profundizar en los detalles del framework: así es como se ejecuta. Se encuentra en la carpeta [rdvmedecins2-symfony], junto a la carpeta [examples]:

1
2
3
symfony-sept-2026/
├── examples/
└── rdvmedecins2-symfony/

Debe tener instalados [PHP] (versión 8.4 o posterior), [Composer], [Visual Studio Code] y [MySQL] (véanse los apéndices). Luego:

  • Cree la base de datos [dbrdvmedecins2] ejecutando el script [rdvmedecins2-symfony/database/dbrdvmedecins2.sql]. Con [Laragon], abra la herramienta [HeidiSQL] (botón Database) y luego ejecute el script desde el menú File / Run SQL. En la línea de comandos, desde la carpeta [rdvmedecins2-symfony]:
mysql -u root < database/dbrdvmedecins2.sql
  • Abra la carpeta [rdvmedecins2-symfony] en [Visual Studio Code] (menú File / Open Folder) y luego abra un terminal (menú Terminal / New Terminal);
  • Instale las bibliotecas de la aplicación: [Composer] lee el archivo [composer.json], descarga [Symfony] y las demás bibliotecas, y las coloca en la carpeta [vendor] de la aplicación (tarda unas decenas de segundos):
composer install
  • Verifique la conexión a la base de datos. La aplicación se conecta a [MySQL] en [127.0.0.1], puerto 3306, con el usuario [root] sin contraseña (la configuración predeterminada de [Laragon]). Si su cuenta [root] tiene contraseña, ingrésela en el archivo [.env] de la aplicación, en la línea [DATABASE_URL]: [mysql://root:myPassword@127.0.0.1:3306/dbrdvmedecins2...];
  • Ejecute la aplicación:
php -S localhost:8081 -t public
  • [PHP] muestra:
[Sun Sep 27 18:40:12 2026] PHP 8.4.21 Development Server (http://localhost:8081) started

El servidor de desarrollo escucha en el puerto 8081 de la máquina ([localhost]). Cada solicitud recibida se registrará en la consola, junto con los mensajes de [Symfony] (la ruta seleccionada, los comandos SQL enviados a la base de datos);

  • Abra la dirección [http://localhost:8081] en un navegador:

Image

  • Inicie sesión con una de las cuentas de demostración, cuya contraseña es igual al nombre de usuario: [admin] (administrador), [pelissier], [tatou], [dupont] (médicos), [martin], [durand], [bistrou], [german] (pacientes). También debe ingresar los caracteres de la imagen, en mayúsculas o minúsculas.

Una aplicación con el identificador [PHP] no lee la base de datos al iniciar: un error de conexión solo aparece en la primera página que consulta la base de datos, es decir, en el momento de la conexión. [Symfony] muestra entonces su página de error detallada y registra el error en la consola del servidor. Si el mensaje es [SQLSTATE[HY000] [2002] Connection refused], significa que [MySQL] no se ha iniciado; con [[1045] Access denied for user 'root'@'localhost'], significa que la contraseña es incorrecta; con [[1049] Unknown database 'dbrdvmedecins2'], significa que no se ejecutó el script SQL; con [could not find driver], que la extensión [pdo_mysql] de [PHP] no está habilitada. Si la página muestra [Failed opening required '.../vendor/autoload_runtime.php'], significa que [composer install] no se ejecutó; si el comando [php -S] falla con el mensaje [Failed to listen on localhost:8081 (reason: Address already in use)], significa que el puerto 8081 ya está en uso (por otra versión de la aplicación, por ejemplo). El archivo [README.md] de la aplicación describe otros escenarios. Detenga la aplicación con [Ctrl-C] en el terminal.

El caso de estudio al final del documento muestra cómo usar la aplicación y luego explica cada uno de sus archivos.

1.4. Ejemplos

Los ejemplos se almacenan en la carpeta [examples], con una subcarpeta por ejemplo:

examples/
├── 01-structure/
├── 02-routing/
├── ...
├── 28-layers/
├── common/
│   ├── bootstrap/
│   ├── BootstrapController.php
│   └── README.md
└── composer.json

Cada ejemplo es una pequeña aplicación ([Symfony]) que se ejecuta por sí sola. Todos los ejemplos usan las mismas bibliotecas, descritas en el archivo [examples/composer.json]:

{
    "name": "course/symfony-examples",
    "description": "The 28 examples of the course [Step-by-step introduction to the Symfony web framework]: a single vendor folder, shared by all the examples",
    "type": "project",
    "license": "MIT",
    "require": {
        "php": ">=8.4",
        "ext-intl": "*",
        "ext-pdo_mysql": "*",
        "doctrine/doctrine-bundle": "^3.3",
        "doctrine/orm": "^3.7",
        "firebase/php-jwt": "^7.2",
        "symfony/asset": "^8.1",
        "symfony/console": "^8.1",
        "symfony/dotenv": "^8.1",
        "symfony/form": "^8.1",
        "symfony/framework-bundle": "^8.1",
        "symfony/intl": "^8.1",
        "symfony/lock": "^8.1",
        "symfony/rate-limiter": "^8.1",
        "symfony/security-bundle": "^8.1",
        "symfony/serializer": "^8.1",
        "symfony/translation": "^8.1",
        "symfony/twig-bundle": "^8.1",
        "symfony/validator": "^8.1",
        "symfony/yaml": "^8.1",
        "twig/intl-extra": "^3.30",
        "twig/twig": "^3.30"
    },
    "autoload": {
        "psr-4": {
            "Common\\": "common/"
        }
    },
    "config": {
        "optimize-autoloader": true,
        "sort-packages": true
    },
    "minimum-stability": "stable",
    "prefer-stable": true
}
  • Líneas 6–29: lo que requieren los ejemplos: [PHP] 8.4 o posterior, las extensiones [intl] (formato de números y fechas según el idioma, ejemplo 16) y [pdo_mysql] (acceso a [MySQL], ejemplo 28), seguidas de las bibliotecas, en orden alfabético: [Doctrine] (ejemplo 28), [firebase/php-jwt] (los tokens JWT, ejemplo 25) y los componentes y bundles de [Symfony] que utilizan los ejemplos. [^8.1] se lee “versión 8.1, o una versión posterior dentro de la versión mayor 8”;
  • líneas 30–34: las clases del espacio de nombres [Common] se encuentran en la carpeta [common] (la regla PSR-4, mostrada en el ejemplo 01): es el controlador compartido que sirve [Bootstrap] (ejemplo 15);
  • las demás líneas configuran el comportamiento de [Composer]: el cargador de clases está optimizado, las bibliotecas se ordenan por nombre y solo se aceptan versiones estables.

Para ejecutar los ejemplos, primero instale sus bibliotecas (una sola vez) en una ventana de terminal abierta en la carpeta [examples]:

composer install

[Composer] crea la carpeta [examples/vendor], compartida por los 28 ejemplos, y el archivo [composer.lock], que registra las versiones exactas instaladas (véase el caso de estudio). La carpeta [common] contiene el framework CSS [Bootstrap] ([common/bootstrap]), compartido por los ejemplos que dan formato a sus páginas (a partir del ejemplo 15), y el controlador que lo sirve ([common/BootstrapController.php]; véase el ejemplo 15).

Casi todos los ejemplos tienen la misma estructura, la de una aplicación [Symfony] estándar reducida a lo esencial. Por ejemplo, la del ejemplo 13:

13-first-view/
├── bin/
│   └── console
├── config/
│   ├── packages/
│   │   ├── framework.yaml
│   │   └── twig.yaml
│   ├── bundles.php
│   ├── routes.yaml
│   └── services.yaml
├── public/
│   └── index.php
├── src/
│   ├── Controller/
│   │   └── ViewsController.php
│   ├── Model/
│   │   └── PageModel.php
│   └── Kernel.php
├── templates/
│   └── views/
│       ├── unknown.html.twig
│       └── index.html.twig
├── var/
├── .env
└── composer.json
  • [public/index.php]: el punto de entrada de todas las solicitudes; [src/Kernel.php]: el núcleo de la aplicación; [bin/console]: la herramienta de línea de comandos de [Symfony] (ejemplo 01);
  • [config]: configuración: los bundles de la aplicación ([bundles.php]), la configuración de cada uno (carpeta [packages]), las rutas ([routes.yaml], ejemplo 02), los servicios ([services.yaml], ejemplo 06);
  • [src]: las clases de la aplicación: controladores ([src/Controller]), modelos, servicios, etc.;
  • [templates]: las vistas [Twig] (a partir del capítulo sobre las vistas);
  • [.env]: la configuración específica del ejemplo (ejemplo 01); [var]: los archivos que [Symfony] escribe por sí mismo (el caché, la sesión).

Para ejecutar un ejemplo, abra un terminal en su carpeta (en [Visual Studio Code]: haga clic con el botón derecho en la carpeta del ejemplo y seleccione “Open in Integrated Terminal”) y escriba:

php -S localhost:8000 -t public

Todos los ejemplos escuchan en el puerto 8000: solo puede ejecutar uno a la vez (o debe cambiar el puerto: [php -S localhost:8001 -t public]). Detenga el servidor con [Ctrl-C] en el terminal. No es necesario reiniciar el servidor después de modificar un archivo [PHP], una vista o la configuración: los cambios surten efecto en la siguiente solicitud (ejemplo 01).

Cuando abre la carpeta [examples] en [Visual Studio Code], la extensión [PHP Intelephense] analiza todos los archivos, incluidos los de [Symfony] en la carpeta [vendor]: en cada archivo, puede aprovechar la finalización de código, la navegación a la definición de una clase o método (tecla [F12]) y el reporte de errores. Como todos los ejemplos tienen sus clases en el espacio de nombres [App], la extensión puede señalar clases “duplicadas”: esto no tiene efecto en la ejecución, ya que cada ejemplo se ejecuta de forma independiente. Para evitar estas advertencias, basta con abrir la carpeta del propio ejemplo.

1.5. Contenido del documento

El documento está organizado de la siguiente manera:

Acciones, enrutamiento, respuestas
De la solicitud a la acción: rutas, controladores, respuestas, redirecciones, servicios compartidos
01 a 06
El modelo de la acción
Parámetros de la solicitud: enlace, conversión, validación, solicitudes POST
07 a 12
La vista y su plantilla
[Twig], plantilla, macros, formularios de [Symfony], validación, PRG, protección anti-CSRF
13 a 21
Internacionalización
Una aplicación en francés y en inglés
22
Ámbitos de datos
solicitud, sesión, caché, cookies
23
El ciclo de vida de una solicitud
Eventos del kernel, resolvedores de argumentos, manejo de excepciones
24
Autenticación y autorización
Firewall, autenticador JWT en una cookie, roles, CAPTCHA, límites de intentos
25–27
Arquitectura en capas y acceso a datos
Web / Negocio / DAO con [Doctrine] y [MySQL]
28
Caso de estudio
La aplicación RdvMedecins, explicada archivo por archivo
-

Cada ejemplo introduce solo unos pocos conceptos nuevos, y los capítulos se construyen unos sobre otros: lo mejor es leerlos en orden. El caso de estudio, por su parte, recurre a todos los conceptos de los capítulos anteriores: siempre que corresponde, su comentario remite al ejemplo donde se introdujo el concepto. Los apéndices describen cómo instalar las herramientas: [PHP], [Composer], [Visual Studio Code] y sus extensiones, [MySQL] junto con [Laragon], [curl] y la herramienta [symfony].