Cómo Instalar una API en Laravel 11: Guía Paso a Paso
Laravel 11 ha cambiado la forma en que se gestionan las APIs en comparación con versiones anteriores. Ahora, el soporte para APIs ya no viene preinstalado por defecto, pero su instalación sigue siendo sencilla. En esta guía, aprenderás cómo instalar una API en Laravel 11 paso a paso, incluyendo la configuración de Laravel Sanctum para autenticación basada en tokens.
Cambios en Laravel 11 respecto a versiones anteriores
En Laravel 10 por defecto teníamos todo configurado para desarrollar una API. Laravel preestablecía esencial instalar predeterminadamente soporte para APIs externas donde se daba por defecto la opción de que todas las plataformas externas al Laravel local necesitaban una API con todas sus configuraciones preinstaladas (Rutas, Controladores y su seguridad).
También, en Laravel 10 y versiones anteriores, el archivo de rutas API contenía una ruta que devolvía el usuario autenticado. En esas versiones anteriores a la 10, este archivo de rutas API se cargaba desde el archivo app/Providers y RouteServiceProvider.
Ahora no tenemos estos archivos de rutas API, ya que el framework en su nueva lógica da por sentado que no necesitamos una API. Sin embargo, ha facilitado enormemente su instalación manual.
Instalación de API en Laravel 11
Para agregar el API a tu proyecto con Laravel 11 basta con ejecutar un comando que configurará todo el soporte para APIs. Este comando existe desde versiones anteriores a Laravel 11, pero no era muy conocido debido a que, como mencionamos antes, desde Laravel 10 hacia abajo, la opción de API estaba preinstalada.
Para restaurar la API con toda su configuración como en versiones anteriores de Laravel, basta con ejecutar el siguiente comando:
php artisan install:api
Una vez ejecutado este comando, ya tenemos el archivo api.php en routes/ de vuelta. Funcionalmente es lo mismo que antes, solo cambia el orden en que se registra el middleware.
Instalación de Laravel Sanctum y estructura de autenticación
Después de ejecutar php artisan install:api, si revisamos el archivo composer.json, veremos que también se ha instalado Laravel Sanctum. A diferencia de versiones anteriores, Sanctum ya no viene por defecto en Laravel 11, pero es esencial para el buen funcionamiento de la opción API.
Junto con Sanctum, se genera un archivo de configuración y una migración para crear la estructura de base de datos que permitirá almacenar los tokens de acceso.
Si te preguntas qué es Sanctum, es una librería que permite la autenticación ligera y simple para APIs basadas en token, como APIs para apps de la Play Store o para consumir APIs con lenguajes front-end.
Cambios en la estructura de archivos de Laravel 11
Si revisamos la carpeta app/Providers, únicamente encontramos el archivo AppServiceProvider.php, ya no está el RouteServiceProvider.php que existía en versiones anteriores. También tenemos un archivo bootstrap en app/ completamente diseñado.
Este archivo bootstrap se encarga de hacer el levantamiento y configuración de la aplicación. Además, el comando install:api agrega una nueva línea con el parámetro api, indicando la dirección del archivo de rutas API. Aquí mismo podemos cambiar el prefijo API si lo deseamos.
Ejecutar migraciones pendientes y configurar API Tokens
Después de ejecutar php artisan install:api, el sistema nos preguntará si queremos ejecutar las migraciones pendientes, esto debido a la nueva migración de Sanctum que se ha agregado. Para completar este proceso:
- Presionamos «Sí» para ejecutar las migraciones.
- Agregamos la propiedad HasApiTokens al modelo User.
Este sería el paso final para configurar la API.
Verificación de rutas de API en Laravel 11
Ahora estamos listos para desarrollar una API en esta aplicación. Si ejecutamos el siguiente comando:
php artisan route:list
Podemos ver la ruta para el token csrf y para obtener el usuario actualmente autenticado. En resumen, Laravel 11 ya no da por sentado que queremos construir una API, pero hace que su configuración sea muy sencilla.
Conclusión
En resumen, instalar una API en Laravel 11 es un proceso sencillo a pesar de que ya no viene preinstalado. Siguiendo los pasos mencionados, podrás habilitar la API, configurar Laravel Sanctum y verificar las rutas para comenzar a desarrollar tu aplicación. Con este método, tendrás el mismo soporte para APIs que en versiones anteriores.
