16. Optimización y Despliegue en Servidores de Producción (Cache de Rutas/Config y Artisan)
Prepara tu proyecto para producción: config:cache, route:cache, view:cache, permisos en storage/ y bootstrap/cache, y mantenimiento en servidores VPS.
La Regla de Oro del Despliegue en Producción
Cuando pasas una aplicación Laravel desde tu entorno de desarrollo local a un servidor de producción (como tu VPS en OVH), no basta con simplemente clonar el repositorio de Git. Debes ejecutar la suite de comandos de optimización para que el framework opere a su máxima velocidad de respuesta (reduciendo los tiempos de carga en hasta un 400%).
Paso 1: Instalación de Dependencias sin Desarrollo
En producción nunca debes instalar herramientas de prueba ni debuggers pesados como Faker o PHPUnit:
composer install --no-dev --optimize-autoloader
El flag --optimize-autoloader compila un mapa de clases estático de una sola lectura, acelerando dramáticamente el arranque de cada petición HTTP.
Paso 2: Permisos de Carpetas Críticas en Linux
El servidor web (generalmente el usuario www-data o nginx) necesita permisos de escritura exclusivamente en dos directorios:
# Asignar propietario y permisos de lectura/escritura
sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache
Paso 3: La Suite de Comandos de Caché
Laravel incluye comandos especializados para compilar todas las configuraciones, rutas y vistas en archivos planos de PHP:
| Comando Artisan | ¿Qué optimización realiza? |
|---|---|
php artisan config:cache |
Combina todos los archivos de config/ y el .env en un solo archivo plano ultrarrápido. |
php artisan route:cache |
Compila todas las rutas de web.php y api.php en un array plano, acelerando la búsqueda de rutas. |
php artisan view:cache |
Precompila todas las plantillas Blade a PHP nativo para que el primer visitante no experimente demoras. |
php artisan event:cache |
Registra en caché todos los eventos y oyentes (listeners) del sistema. |
php artisan optimize:clear (o config:clear) y luego volver a cachear con php artisan optimize.
⚡ Script Bash de Despliegue Automatizado para Servidor VPS (deploy.sh)
Script estándar de despliegue continuo con activación de modo mantenimiento y migraciones seguras.
#!/usr/bin/env bash
set -e
echo ">>> Iniciando despliegue de Laravel en VPS..."
# 1. Activar pantalla de mantenimiento para evitar inconsistencias durante el despliegue
php artisan down --refresh=15 --secret="bypass-token-secreto"
# 2. Descargar los últimos cambios desde la rama main
git pull origin main
# 3. Instalar o actualizar dependencias de Composer optimizadas para producción
composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader
# 4. Ejecutar migraciones pendientes de base de datos con flag obligatorio para producción
php artisan migrate --force
# 5. Limpiar cachés anteriores y regenerar la suite de optimización
php artisan optimize:clear
php artisan optimize
php artisan view:cache
# 6. Reiniciar procesos de colas si se utiliza Laravel Queue / Supervisor
php artisan queue:restart
# 7. Desactivar modo mantenimiento y volver a poner el sitio público en vivo
php artisan up
echo ">>> ¡Despliegue completado con éxito a máxima velocidad!"
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué debe utilizarse el flag "--force" al ejecutar "php artisan migrate --force" en un script de despliegue en producción?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Laravel Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.