No hay resultados

🧱 Laravel 12: Cómo usar php artisan down y php artisan up (modo mantenimiento explicado)

🧱 Laravel 12: Cómo usar php artisan down y php artisan up (modo mantenimiento explicado)

🧱 Laravel 12: Cómo usar php artisan down y php artisan up (modo mantenimiento explicado)

⚙️ ¿Qué es el modo mantenimiento en Laravel?

Los comandos php artisan down y php artisan up son herramientas esenciales en Laravel para gestionar el modo mantenimiento de una aplicación. Estos comandos permiten controlar el acceso al sistema mientras realizas actualizaciones, despliegues o tareas de mantenimiento sin afectar la experiencia del usuario final.

1. ¿Qué es el modo mantenimiento en Laravel?

El modo mantenimiento en Laravel se utiliza para desactivar temporalmente el acceso a la aplicación. Cuando está activo, todos los usuarios verán una página con el código de error 503 (Service Unavailable), indicando que el sitio está fuera de servicio de manera temporal.

Esto es útil cuando se realizan:

  • Actualizaciones de código o dependencias
  • Migraciones de base de datos
  • Deploys en producción
  • Mantenimiento programado

2. Activar el modo mantenimiento con php artisan down

Para activar el modo mantenimiento en tu aplicación Laravel, usa el siguiente comando:


php artisan down

Al ejecutarlo, Laravel muestra un mensaje como:

Application is now in maintenance mode.

A partir de ese momento, cualquier intento de acceder al sitio mostrará una página de mantenimiento predeterminada con el código de error 503.

3. Opciones avanzadas de php artisan down

Laravel permite personalizar el comportamiento del modo mantenimiento con diferentes opciones:

Opción Descripción Ejemplo
--refresh=30 Refresca la página de mantenimiento cada 30 segundos. php artisan down --refresh=30
--retry=60 Indica a los navegadores que intenten reconectarse en 60 segundos. php artisan down --retry=60
--secret="token" Permite acceder al sitio mediante una URL secreta mientras está en mantenimiento. php artisan down --secret="devtoken"
--render="view" Usa una vista personalizada para el mensaje de mantenimiento. php artisan down --render="errors.maintenance"

Ejemplo avanzado:


php artisan down --render="errors.maintenance" --retry=60 --secret="ticomdev"

Esto muestra una vista personalizada, indica un tiempo de reintento de 60 segundos y permite acceso al sitio mediante la URL secreta /ticomdev.

4. Desactivar el modo mantenimiento con php artisan up

Una vez que terminas tus actualizaciones o tareas de mantenimiento, puedes volver a activar el acceso normal a la aplicación con:


php artisan up

Laravel mostrará el mensaje:

Application is now live.

Con esto, el sitio vuelve a estar disponible para todos los usuarios de forma inmediata.

5. Personalizar la vista de mantenimiento

Puedes personalizar la página mostrada durante el modo mantenimiento creando un archivo en:

resources/views/errors/503.blade.php

Ejemplo sencillo de diseño personalizado:


<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <title>Sitio en mantenimiento</title>
  <style>
    body { background: #f8fafc; text-align: center; font-family: Arial; margin-top: 10%; }
    h1 { color: #444; }
  </style>
</head>
<body>
  <h1>🚧 En mantenimiento 🚧</h1>
  <p>Estamos realizando mejoras. Volveremos pronto.</p>
</body>
</html>

6. Buenas prácticas

  • ✅ Usa php artisan down antes de realizar deploys o cambios en producción.
  • ✅ Incluye una URL secreta para pruebas durante el mantenimiento.
  • ✅ Personaliza la vista de error 503 con tu marca.
  • ❌ No olvides ejecutar php artisan up al finalizar el mantenimiento.

7. Ejemplo de flujo de deploy seguro


php artisan down --secret="ticomdev"
composer install --no-dev
php artisan migrate --force
php artisan optimize
php artisan up

Este flujo asegura que tu aplicación permanezca estable y sin interrupciones durante las actualizaciones.

🚀 Conclusión

Los comandos php artisan down y php artisan up son herramientas esenciales para cualquier desarrollador Laravel. Permiten mantener la estabilidad del sistema y ofrecer una mejor experiencia de usuario durante tareas de mantenimiento o despliegues.

Con solo dos líneas, puedes controlar cuándo tu aplicación está disponible o en modo de actualización. ⚡

📞 Contáctanos

En Ticom Software somos especialistas en Laravel, PHP y Odoo ERP. Ofrecemos desarrollo de aplicaciones web, capacitaciones y soporte técnico.

 

Etiquetas :
F