Despliegue

• Introducción
• Requisitos del Servidor
• Configuración del Servidor
  • Nginx
  • FrankenPHP
  • Permisos de Directorio
• Optimización
  • Configuración de Caching
  • Eventos de Caching
  • Rutas de Caching
  • Vistas de Caching
• Modo de Depuración
• La Ruta de Salud
• Despliegue Fácil con Forge / Vapor

Introducción

Cuando estés listo para desplegar tu aplicación Laravel en producción, hay algunas cosas importantes que puedes hacer para asegurarte de que tu aplicación esté funcionando de la manera más eficiente posible. En este documento, cubriremos algunos excelentes puntos de partida para asegurarte de que tu aplicación Laravel se despliegue correctamente.

Requisitos del Servidor

El framework Laravel tiene algunos requisitos del sistema. Debes asegurarte de que tu servidor web tenga la siguiente versión mínima de PHP y extensiones:

Configuración del Servidor

Nginx

Si estás desplegando tu aplicación en un servidor que está ejecutando Nginx, puedes usar el siguiente archivo de configuración como punto de partida para configurar tu servidor web. Lo más probable es que este archivo necesite ser personalizado según la configuración de tu servidor. Si deseas asistencia en la gestión de tu servidor, considera usar un servicio de gestión y despliegue de servidores de Laravel de primera parte como Laravel Forge. Asegúrate, como en la configuración a continuación, de que tu servidor web dirija todas las solicitudes al archivo public/index.php de tu aplicación. Nunca debes intentar mover el archivo index.php a la raíz de tu proyecto, ya que servir la aplicación desde la raíz del proyecto expondrá muchos archivos de configuración sensibles a Internet público:

server {
    listen 80;
    listen [::]:80;
    server_name example.com;
    root /srv/example.com/public;
 
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";
 
    index index.php;
 
    charset utf-8;
 
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
 
    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }
 
    error_page 404 /index.php;
 
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_hide_header X-Powered-By;
    }
 
    location ~ /\.(?!well-known).* {
        deny all;
    }
}

FrankenPHP

FrankenPHP también se puede usar para servir tus aplicaciones Laravel. FrankenPHP es un servidor de aplicaciones PHP moderno escrito en Go. Para servir una aplicación PHP de Laravel utilizando FrankenPHP, simplemente puedes invocar su comando php-server:

frankenphp php-server -r public/

Para aprovechar características más poderosas que ofrece FrankenPHP, como su integración con Laravel Octane, HTTP/3, compresión moderna o la capacidad de empaquetar aplicaciones Laravel como binarios independientes, consulta la documentación de Laravel de FrankenPHP.

Permisos de Directorio

Laravel necesitará escribir en los directorios bootstrap/cache y storage, así que debes asegurarte de que el propietario del proceso del servidor web tenga permiso para escribir en estos directorios.

Optimización

Al desplegar tu aplicación en producción, hay una variedad de archivos que deben ser almacenados en caché, incluyendo tu configuración, eventos, rutas y vistas. Laravel proporciona un solo comando Artisan optimize conveniente que almacenará en caché todos estos archivos. Este comando debe invocarse típicamente como parte del proceso de despliegue de tu aplicación:

php artisan optimize

El método optimize:clear se puede usar para eliminar todos los archivos de caché generados por el comando optimize, así como todas las claves en el controlador de caché predeterminado:

php artisan optimize:clear

En la siguiente documentación, discutiremos cada uno de los comandos de optimización granular que son ejecutados por el comando optimize.

Configuración de Caché

Al desplegar tu aplicación en producción, debes asegurarte de ejecutar el comando Artisan config:cache durante tu proceso de despliegue:

php artisan config:cache

Este comando combinará todos los archivos de configuración de Laravel en un solo archivo en caché, lo que reduce en gran medida el número de accesos que el framework debe hacer al sistema de archivos al cargar tus valores de configuración.

[!WARNING] Si ejecutas el comando config:cache durante tu proceso de despliegue, debes asegurarte de que solo estás llamando a la función env desde dentro de tus archivos de configuración. Una vez que la configuración ha sido almacenada en caché, el archivo .env no se cargará y todas las llamadas a la función env para variables .env devolverán null.

Eventos de Caché

Deberías almacenar en caché los mapeos de eventos a oyentes auto-descubiertos de tu aplicación durante tu proceso de implementación. Esto se puede lograr invocando el comando Artisan event:cache durante la implementación:

php artisan event:cache

Caching Routes

Si estás construyendo una aplicación grande con muchas rutas, deberías asegurarte de estar ejecutando el comando Artisan route:cache durante tu proceso de implementación:

php artisan route:cache

Este comando reduce todos tus registros de ruta en una sola llamada a método dentro de un archivo en caché, mejorando el rendimiento del registro de rutas al registrar cientos de rutas.

Almacenando Vistas

Al implementar tu aplicación en producción, debes asegurarte de ejecutar el comando Artisan view:cache durante tu proceso de implementación:

php artisan view:cache

Este comando precompila todas tus vistas de Blade para que no se compilen bajo demanda, mejorando el rendimiento de cada solicitud que devuelve una vista.

Modo de Depuración

La opción de depuración en tu archivo de configuración config/app.php determina cuánta información sobre un error se muestra realmente al usuario. Por defecto, esta opción está configurada para respetar el valor de la variable de entorno APP_DEBUG, que se almacena en el archivo .env de tu aplicación.

[!WARNING] En tu entorno de producción, este valor debe ser siempre false. Si la variable APP_DEBUG está configurada en true en producción, corres el riesgo de exponer valores de configuración sensibles a los usuarios finales de tu aplicación.

La Ruta de Salud

Laravel incluye una ruta de verificación de salud integrada que se puede usar para monitorear el estado de tu aplicación. En producción, esta ruta puede utilizarse para informar el estado de tu aplicación a un monitor de tiempo de actividad, a un balanceador de carga o a un sistema de orquestación como Kubernetes. Por defecto, la ruta de verificación de salud se sirve en /up y devolverá una respuesta HTTP 200 si la aplicación se ha iniciado sin excepciones. De lo contrario, se devolverá una respuesta HTTP 500. Puedes configurar la URI para esta ruta en el archivo bootstrap/app de tu aplicación:

->withRouting(
    web: __DIR__.'/../routes/web.php',
    commands: __DIR__.'/../routes/console.php',
    health: '/up', 
    health: '/status', 
)

Cuando se realicen solicitudes HTTP a esta ruta, Laravel también despachará un evento Illuminate\Foundation\Events\DiagnosingHealth, lo que te permitirá realizar comprobaciones de salud adicionales relevantes para tu aplicación. Dentro de un listener para este evento, puedes verificar el estado de la base de datos o caché de tu aplicación. Si detectas un problema con tu aplicación, simplemente puedes lanzar una excepción desde el listener.

Despliegue Fácil con Forge / Vapor

Laravel Forge

Si no estás completamente listo para gestionar la configuración de tu propio servidor o no te sientes cómodo configurando todos los diversos servicios necesarios para ejecutar una robusta aplicación Laravel, Laravel Forge es una maravillosa alternativa. Laravel Forge puede crear servidores en varios proveedores de infraestructura como DigitalOcean, Linode, AWS y más. Además, Forge instala y gestiona todas las herramientas necesarias para construir aplicaciones Laravel robustas, como Nginx, MySQL, Redis, Memcached, Beanstalk y más.

[!NOTE] ¿Quieres una guía completa para desplegar con Laravel Forge? Consulta el Laravel Bootcamp y la serie de videos de Forge disponible en Laracasts.

Laravel Vapor

Si deseas una plataforma de despliegue totalmente serverless y con escalado automático ajustada para Laravel, echa un vistazo a Laravel Vapor. Laravel Vapor es una plataforma de despliegue serverless para Laravel, impulsada por AWS. Lanza tu infraestructura de Laravel en Vapor y enamórate de la simplicidad escalable del serverless. Laravel Vapor está afinada por los creadores de Laravel para trabajar sin problemas con el framework, así que puedes seguir escribiendo tus aplicaciones Laravel exactamente como estás acostumbrado.