Creando un controlador

Siendo perezosos con el Maker Bundle

Para generar controladores sin esfuerzo, podemos usar el paquete symfony/maker-bundle, que ha sido instalado como parte del paquete webapp.

Maker bundle te ayuda a generar muchas clases diferentes. Lo usaremos todo el tiempo en este libro. Cada "generador" se define en un comando y todos los comandos forman parte del espacio de nombres del comando make.

El comando list incorporado en la consola de Symfony muestra un listado con todos los comandos disponibles bajo un espacio de nombres dado; utilízalo para descubrir todos los generadores proporcionados por el bundle maker:

1

$ symfony console list make

Seleccionando un formato de configuración

Antes de crear el primer controlador del proyecto, tenemos que decidir los formatos de configuración que queremos utilizar. Symfony soporta YAML, XML, PHP y atributos de PHP desde el primer momento.

Para la configuración relacionada con los paquetes, YAML es la mejor opción. Este es el formato utilizado en el directorio config/. A menudo, cuando instales un nuevo paquete, la receta de ese paquete agregará un nuevo archivo que termina en .yaml en ese directorio.

Para la configuración relacionada con el código PHP, los atributos son una mejor opción ya que se definen junto al código. Permíteme explicarlo con un ejemplo. Cuando llega una petición, alguna configuración necesita decirle a Symfony que la ruta de la petición debe ser gestionada por un controlador específico (una clase PHP). Cuando se utilizan formatos de configuración YAML, XML o PHP, hay dos archivos implicados (el archivo de configuración y el archivo PHP del controlador). Si se utilizan atributos, la configuración se realiza directamente en la clase de controlador.

Puede que te preguntes cómo puedes adivinar el nombre del paquete que se necesita instalar para una característica. La mayoría de las veces, no necesitas saberlo. En muchos casos, Symfony indica el paquete a instalar en sus mensajes de error. Ejecutar symfony console make:message sin el paquete messenger por ejemplo habría terminado con una excepción que contiene una pista sobre la instalación del paquete correcto.

Generando un controlador

Crea tu primer Controlador a través del comando make:controller:

1

$ symfony console make:controller ConferenceController

El comando crea una clase ConferenceController bajo el directorio src/Controller/. La clase generada contiene código base listo para ser personalizado:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

final class ConferenceController extends AbstractController
{
    #[Route('/conference', name: 'app_conference')]
    public function index(): Response
    {
        return $this->render('conference/index.html.twig', [
            'controller_name' => 'ConferenceController',
        ]);
    }
}

El atributo #[Route('/conference', name: 'app_conference')] es lo que hace al método index() un controlador (la configuración está junto al código que configura).

Cuando accedes a /conference en un navegador, se ejecuta el controlador y se devuelve una respuesta.

Modifica la ruta para que coincida con la página de inicio:

1
2
3
4
5
6
7
8
9
10
11

--- i/src/Controller/ConferenceController.php
+++ w/src/Controller/ConferenceController.php
@@ -8,7 +8,7 @@ use Symfony\Component\Routing\Attribute\Route;

 final class ConferenceController extends AbstractController
 {
-    #[Route('/conference', name: 'app_conference')]
+    #[Route('/', name: 'homepage')]
     public function index(): Response
     {
         return $this->render('conference/index.html.twig', [

La ruta name será útil cuando queramos hacer referencia a la página de inicio en el código. En lugar de incluir el camino / en el código, usaremos el nombre de la ruta.

En lugar de la página mostrada por defecto, devolvamos una página HTML sencilla:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

--- i/src/Controller/ConferenceController.php
+++ w/src/Controller/ConferenceController.php
@@ -11,8 +11,13 @@ final class ConferenceController extends AbstractController
     #[Route('/', name: 'homepage')]
     public function index(): Response
     {
-        return $this->render('conference/index.html.twig', [
-            'controller_name' => 'ConferenceController',
-        ]);
+        return new Response(<<<EOF
+            <html>
+                <body>
+                    <img src="/images/under-construction.gif" />
+                </body>
+            </html>
+            EOF
+        );
     }
 }

Actualiza la página en el navegador:

La responsabilidad principal de un controlador es devolver una Response (respuesta) HTTP para la petición.

Como el resto del capítulo trata sobre código que no vamos a conservar, hagamos un commit con nuestros cambios ahora:

1
2

$ git add .
$ git commit -m'Add the index controller'

Agregando un huevo de Pascua

Para demostrar cómo puede aprovechar la información de la solicitud una respuesta, agreguemos un pequeño huevo de Pascua . Cada vez que la página de inicio contenga una cadena de consulta como ?hello=Fabien, añadiremos algún texto para saludar a la persona:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

--- i/src/Controller/ConferenceController.php
+++ w/src/Controller/ConferenceController.php
@@ -3,17 +3,24 @@
 namespace App\Controller;

 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;

 final class ConferenceController extends AbstractController
 {
     #[Route('/', name: 'homepage')]
-    public function index(): Response
+    public function index(Request $request): Response
     {
+        $greet = '';
+        if ($name = $request->query->get('hello')) {
+            $greet = sprintf('<h1>Hello %s!</h1>', htmlspecialchars($name));
+        }
+
         return new Response(<<<EOF
             <html>
                 <body>
+                    $greet
                     <img src="/images/under-construction.gif" />
                 </body>
             </html>

Symfony expone los datos de la solicitud a través de un objeto Request. Cuando Symfony ve un argumento en el controlador con este tipo determinado (type-hint), automáticamente sabe que debe pasárselo. Podemos usarlo para obtener el elemento name de la cadena de consulta y añadir un título <h1>.

Intenta acceder a / y luego a /?hello=Fabien en un navegador para ver la diferencia.

También podríamos haber hecho que el nombre formara parte de la URL:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

--- i/src/Controller/ConferenceController.php
+++ w/src/Controller/ConferenceController.php
@@ -9,11 +9,11 @@ use Symfony\Component\Routing\Attribute\Route;

 final class ConferenceController extends AbstractController
 {
-    #[Route('/', name: 'homepage')]
-    public function index(Request $request): Response
+    #[Route('/hello/{name}', name: 'homepage')]
+    public function index(string $name = ''): Response
     {
         $greet = '';
-        if ($name = $request->query->get('hello')) {
+        if ($name) {
             $greet = sprintf('<h1>Hello %s!</h1>', htmlspecialchars($name));
         }

La parte {name} de la ruta es un parámetro de ruta dinámico - funciona como un comodín. Ahora puedes acceder a /hello y luego a /hello/Fabien en un navegador para obtener los mismos resultados que antes. Puedes obtener el valor del parámetro {name} añadiendo un argumento al controlador con el mismo nombre. O sea, $name.

Revierte los cambios que acabamos de hacer:

1

$ git checkout src/Controller/ConferenceController.php

1
2

$ git reset HEAD src/Controller/ConferenceController.php
$ git checkout src/Controller/ConferenceController.php

Depurando variables

Una gran ayuda para la depuración es la función de Symfony dump(). Está siempre disponible y te permite volcar variables complejas en un formato agradable e interactivo.

Cambia src/Controller/ConferenceController.php temporalmente para mostrar con dump() el objeto Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

--- i/src/Controller/ConferenceController.php
+++ w/src/Controller/ConferenceController.php
@@ -3,14 +3,17 @@
 namespace App\Controller;

 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Attribute\Route;

 final class ConferenceController extends AbstractController
 {
     #[Route('/', name: 'homepage')]
-    public function index(): Response
-    {
+    public function index(Request $request): Response
+        {
+        dump($request);
+
         return new Response(<<<EOF
             <html>
                 <body>

Cuando actualices la página, observa el nuevo icono del "punto de mira" que hay en la barra de herramientas; te permite inspeccionar el volcado producido por dump(). Haz clic en él para acceder a una página completa donde la navegación es más simple:

Revierte los cambios que acabamos de hacer:

1

$ git checkout src/Controller/ConferenceController.php

1
2

$ git reset HEAD src/Controller/ConferenceController.php
$ git checkout src/Controller/ConferenceController.php