Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. PHP
Code

Configure el enrutamiento en aplicaciones PHP utilizando el componente de enrutamiento de Symfony

by
Difficulty:IntermediateLength:MediumLanguages:

Spanish (Español) translation by Luis Chiabrera (you can also view the original English article)

Hoy veremos el componente de enrutamiento de Symfony, que le permite configurar el enrutamiento en sus aplicaciones de PHP

¿Qué es el componente de enrutamiento de Symfony?

El componente de enrutamiento de Symfony es un componente de enrutamiento muy popular que está adaptado por varios sistemas y proporciona mucha flexibilidad en caso de que desee configurar rutas en su aplicación PHP.

Si ha creado una aplicación PHP personalizada y está buscando una biblioteca de enrutamiento rica en funciones, el Componente de enrutamiento de Symfony merece más que un vistazo. También le permite definir rutas para su aplicación en el formato YAML.

Comenzando con la instalación y la configuración, veremos ejemplos del mundo real para demostrar una variedad de opciones que tiene el componente para la configuración de rutas. En este artículo, aprenderá:

  • instalacion y configuracion
  • cómo configurar rutas básicas
  • cómo cargar rutas desde el archivo YAML
  • cómo usar el enrutador todo en uno

Instalacion y configuracion

En esta sección, vamos a instalar las bibliotecas que se requieren para configurar el enrutamiento en sus aplicaciones PHP. Supongo que ha instalado Composer en su sistema, ya que lo necesitaremos para instalar las bibliotecas necesarias que están disponibles en Packagist.

Una vez que haya instalado Composer, continúe e instale el componente Core Routing con el siguiente comando.

Aunque el componente de enrutamiento en sí es suficiente para proporcionar funciones completas de enrutamiento en su aplicación, vamos a seguir adelante e instalar algunos otros componentes para facilitar nuestra vida y enriquecer la funcionalidad de enrutamiento básico existente.

Para empezar, procederemos e instalaremos el componente HttpFoundation, que proporciona un contenedor orientado a objetos para variables globales de PHP y funciones relacionadas con la respuesta. Se asegura de que no necesite acceder a variables globales como $ _GET, $ _POST y similares directamente.

A continuación, si quiere definir las rutas de su aplicación en el archivo YAML en lugar del código PHP, es el componente YAML el que lo rescata, ya que le ayuda a convertir cadenas YAML en matrices PHP y viceversa.

Finalmente, instalaremos el componente Config, que proporciona varias clases de utilidad para inicializar y tratar los valores de configuración definidos en los diferentes tipos de archivos como YAML, INI, XML, etc. En nuestro caso, lo usaremos para cargar rutas del archivo YAML.

Esa es la parte de la instalación, pero ¿cómo se supone que debes usarla? De hecho, solo se trata de incluir el archivo autoload.php creado por Composer en su aplicación, como se muestra en el siguiente fragmento.

Configurar rutas básicas

En la sección anterior, realizamos la instalación de los componentes de enrutamiento necesarios. Ahora, ya está listo para configurar el enrutamiento en su aplicación PHP de inmediato.

Avancemos y creemos el archivo basic_routes.php con los siguientes contenidos.

La configuración del enrutamiento utilizando el componente de enrutamiento de Symfony generalmente pasa por una serie de pasos como se detalla a continuación.

  • Inicialice el objeto de Route para cada una de sus rutas de aplicación.
  • Agregue todos los objetos de Route al objeto RouteCollection.
  • Inicialice el objeto RequestContext que contiene la información de contexto de solicitud actual.
  • Inicialice el objeto UrlMatcher pasando el objeto RouteCollection y el objeto RequestContext.

Inicializar el objeto de ruta para diferentes rutas

Avancemos y definamos una ruta de Foo bastante básica.

El primer argumento del constructor Route es la ruta URI, y el segundo argumento es la matriz de atributos personalizados que desea devolver cuando se hace coincidir esta ruta en particular. Normalmente, sería una combinación del controlador y el método al que desea llamar cuando se solicite esta ruta.

A continuación, echemos un vistazo a la ruta parametrizada.

La ruta anterior puede coincidir con URI como foo / 1, foo / 123 y similares. Tenga en cuenta que hemos restringido el parámetro {id} a valores numéricos solamente, y por lo tanto no coincidirá con los URI como foo / bar, ya que el parámetro {id} se proporciona como una cadena.

Agregar todos los objetos de ruta al objeto RouteCollection

El siguiente paso es agregar objetos de ruta que hemos inicializado en la sección anterior al objeto RouteCollection.

Como puede ver, es bastante sencillo ya que solo necesita usar el método add del objeto RouteCollection para agregar objetos de ruta. El primer argumento del método add es el nombre de la ruta, y el segundo argumento es el objeto route.

Inicializar el objeto RequestContext

A continuación, necesitamos inicializar el objeto RequestContext, que contiene la información de contexto de solicitud actual. Necesitaremos este objeto cuando inicialicemos el objeto UrlMatcher, ya que lo revisaremos en un momento.

Inicializa el objeto UrlMatcher

Finalmente, necesitamos inicializar el objeto UrlMatcher junto con las rutas y la información de contexto.

Ahora, tenemos todo lo que podemos combinar con nuestras rutas.

Cómo hacer coincidir las rutas

Es el método de Match del objeto UrlMatcher que le permite hacer coincidir cualquier ruta con un conjunto de rutas predefinidas.

El método de Match toma el URI como su primer argumento e intenta hacer coincidirlo con las rutas predefinidas. Si se encuentra la ruta, devuelve atributos personalizados asociados con esa ruta. Por otro lado, arroja la excepción ResourceNotFoundException si no hay ninguna ruta asociada con el URI actual.

En nuestro caso, proporcionamos el URI actual obteniéndolo del objeto $ context. Entonces, si está accediendo a la URL http: //your-domain/basic_routes.php/foo, $ context-> getPathInfo () devuelve foo, y ya hemos definido una ruta para el URI foo, por lo que debería devolvernos lo siguiente.

Ahora, vamos a probar la ruta parametrizada accediendo a la URL http: //your-domain/basic_routes.php/foo/123.

Funcionó si puede ver que el parámetro id está vinculado con el valor apropiado 123.

A continuación, intentemos acceder a una ruta inexistente como http: //your-domain/basic_routes.php/unknown-route, y debería ver el siguiente mensaje.

Así es como puedes encontrar rutas usando el método de Match.

Además de esto, también puede usar el componente de Routing para generar enlaces en su aplicación. Proporcionados objetos RouteCollection y RequestContext, el UrlGenerator le permite construir enlaces para rutas específicas.

El primer argumento del método generate es el nombre de la ruta, y el segundo argumento es la matriz que puede contener parámetros si se trata de la ruta parametrizada. El código anterior debe generar la URL /basic_routes.php/foo/123.

Cargar rutas desde el archivo YAML

En la sección anterior, construimos nuestras rutas personalizadas utilizando los objetos Route y RouteCollection. De hecho, el componente Routing ofrece diferentes formas de elegir entre crear instancias de rutas. Puede elegir entre varios cargadores como YamlFileLoader, XmlFileLoader y PhpFileLoader.

En esta sección, revisaremos el cargador YamlFileLoader para ver cómo cargar rutas desde el archivo YAML.

El archivo YAML de Rutas

Continúa y crea el archivo routes.yaml con los siguientes contenidos.

Un archivo de ejemplo

A continuación, siga adelante y cree el archivo load_routes_from_yaml.php con los siguientes contenidos.

¡Lo único que es diferente en este caso es la forma en que iniciamos las rutas!

Hemos utilizado el cargador YamlFileLoader para cargar rutas desde el archivo routes.yaml en lugar de inicializarlo directamente en el PHP. Aparte de eso, todo es igual y debería producir los mismos resultados que el del archivo basic_routes.php.

El enrutador todo en uno

Por último, en esta sección, examinaremos la clase Router, que le permite configurar el enrutamiento rápidamente con menos líneas de código.

Continúa y crea el archivo all_in_one_router.php con los siguientes contenidos.

Todo es prácticamente igual, excepto que hemos creado una instancia del objeto Router junto con las dependencias necesarias.

Con eso en su lugar, puede usar directamente el método de match del objeto Router para el mapeo de ruta.

Además, deberá usar el método getRouteCollection del objeto Router para buscar rutas.

Conclusión

Continúe y explore las otras opciones disponibles en el componente Enrutamiento: ¡me encantaría escuchar sus pensamientos!

Hoy, exploramos el componente de enrutamiento de Symfony, que hace que la implementación del enrutamiento en aplicaciones PHP sea muy sencilla. En el camino, creamos un puñado de ejemplos para demostrar diversos aspectos del componente Enrutamiento.

Espero que hayas disfrutado este artículo, y no dudes en publicar tus comentarios utilizando el feed a continuación.

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.