Tema 16 · Despliegue & Producción

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.
💡 Si realizas un cambio en el archivo .env o en routes: La caché no se actualiza sola. Debes ejecutar 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.

deploy.sh
Solo lectura
#!/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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.