Listado de Rutas en Laravel 11

Laravel proporciona una herramienta poderosa para visualizar todas las rutas definidas en tu aplicación. Esto es especialmente útil para depuración y para obtener una visión general de la estructura de tu aplicación.

Dónde Ejecutar los Comandos

Los comandos Artisan se ejecutan en la terminal o línea de comandos, en el directorio raíz de tu proyecto Laravel.

Comandos y Explicaciones Detalladas

1. Listado Básico de Rutas

php artisan route:list

Este comando muestra una lista completa de todas las rutas definidas en tu aplicación Laravel. La salida incluirá información crucial sobre cada ruta:

• Domain: El dominio al que se aplica la ruta (si está especificado).
• Method: El método HTTP (GET, POST, PUT, etc.) que la ruta acepta.
• URI: La URI que corresponde a la ruta.
• Name: El nombre asignado a la ruta (si se ha definido uno).
• Action: El controlador y método (o closure) que maneja la ruta.
• Middleware: Los middleware aplicados a la ruta (no se muestra por defecto).

Este comando es útil para tener una visión general de todas las rutas de tu aplicación, lo que puede ayudarte a identificar rutas faltantes o duplicadas.

2. Listado de Rutas con Middleware

php artisan route:list -v

Este comando proporciona una salida más detallada que incluye información sobre los middleware:

• La opción -v significa «verbose» (detallado).
• Además de la información básica, muestra los nombres de los middleware asignados a cada ruta.
• También muestra los nombres de los grupos de middleware.
• Es útil para verificar que las rutas tienen la protección de middleware adecuada.

Este nivel de detalle es especialmente útil cuando estás depurando problemas relacionados con la autenticación o la autorización en tu aplicación.

3. Listado de Rutas con Grupos de Middleware Expandidos

php artisan route:list -vv

Este comando proporciona el máximo nivel de detalle sobre las rutas y sus middleware:

• La opción -vv significa «very verbose» (muy detallado).
• Además de la información proporcionada por -v, este comando expande los grupos de middleware.
• Muestra todos los middleware individuales dentro de cada grupo de middleware.
• Es extremadamente útil para entender exactamente qué middleware se está aplicando a cada ruta.

Este nivel de detalle es invaluable cuando estás tratando de resolver problemas complejos relacionados con el flujo de middleware en tu aplicación.

4. Listado de Rutas que Comienzan con un URI Específico

php artisan route:list --path=api

Este comando te permite filtrar las rutas basándote en su URI:

• La opción --path permite especificar un prefijo de URI.
• En este ejemplo, solo se mostrarán las rutas que comienzan con ‘/api’.
• Es útil cuando estás trabajando en una sección específica de tu aplicación, como una API.
• Puedes cambiar ‘api’ por cualquier otro prefijo de ruta que necesites examinar.

Este comando es particularmente útil en aplicaciones grandes donde podrías tener cientos de rutas y necesitas enfocarte en un subconjunto específico.

5. Listado de Rutas Excluyendo Paquetes de Terceros

php artisan route:list --except-vendor

Este comando te permite ver solo las rutas definidas en tu aplicación, excluyendo las de paquetes de terceros:

• La opción --except-vendor filtra las rutas definidas por paquetes en el directorio vendor.
• Muestra solo las rutas que has definido explícitamente en tu aplicación.
• Es útil cuando quieres concentrarte en las rutas específicas de tu aplicación sin la «distracción» de las rutas de paquetes.

Este comando es especialmente valioso cuando estás trabajando en una aplicación que utiliza muchos paquetes de terceros y necesitas enfocarte solo en tus propias rutas.

6. Listado de Rutas Solo de Paquetes de Terceros

php artisan route:list --only-vendor

Este comando es lo opuesto al anterior, mostrando solo las rutas definidas por paquetes de terceros:

• La opción --only-vendor muestra exclusivamente las rutas definidas en el directorio vendor.
• Es útil para ver qué rutas están siendo añadidas por los paquetes que estás utilizando.
• Puede ayudarte a identificar conflictos potenciales o rutas inesperadas introducidas por paquetes.

Este comando es particularmente útil cuando estás integrando un nuevo paquete y quieres ver exactamente qué rutas está añadiendo a tu aplicación.

Visualización en la Terminal

Cuando ejecutes estos comandos en la terminal, verás una salida similar a esta:

+--------+----------+----------+------+---------+--------------+
| Domain | Method   | URI      | Name | Action  | Middleware   |
+--------+----------+----------+------+---------+--------------+
|        | GET|HEAD | /        |      | Closure | web          |
|        | GET|HEAD | api/user |      | Closure | api,auth:api |
+--------+----------+----------+------+---------+--------------+

La salida exacta variará dependiendo de las rutas definidas en tu aplicación y las opciones que uses con el comando. Cada fila representa una ruta única en tu aplicación, y las columnas proporcionan detalles específicos sobre esa ruta.

Conclusión

El comando route:list de Artisan es una herramienta invaluable para los desarrolladores de Laravel. Te permite visualizar y analizar rápidamente todas las rutas de tu aplicación, lo que es especialmente útil en proyectos grandes o cuando estás trabajando con código que no te es familiar. Las diferentes opciones te permiten filtrar y personalizar la salida según tus necesidades específicas, ya sea que estés depurando problemas de middleware, trabajando en una API, o simplemente tratando de entender la estructura de rutas de tu aplicación.

Para más información, puedes consultar:

• Documentación oficial de Laravel
• Curso de Laravel en Conozca Laravel