02 Instalación y Configuración de Multi-Tenancy en Laravel (stancl/tenancy) desde cero

Duración: 16 min
Módulo: Fundamentos y Configuración del Entorno Central Lección 2 de 4

Descripción

🎓 Lección 02: Instalación y Configuración de Multi-Tenancy en Laravel (stancl/tenancy) desde Cero

Objetivo de la lección: Preparar el entorno de desarrollo local, instalar el framework Laravel junto al paquete stancl/tenancy, y configurar la base de datos central (Landlord) para soportar una arquitectura SaaS multi-inquilino.

🚀 Pasos Clave con Timestamps

  • ⚙️ ⏱️ 01:16 Verificación del Entorno de Servidor Local: Comprobación de PHP (v8.3+) y Composer en el servidor local (WampServer, Laragon o XAMPP).
  • 📦 ⏱️ 03:26 Creación del Proyecto Base en Laravel: Ejecución del comando Composer para inicializar el proyecto base mi-tienda.
  • 🗄️ ⏱️ 05:58 Creación de la BD Central (mitienda_central): Configuración de la base de datos central en phpMyAdmin con el sufijo _central para diferenciarla de las futuras BDs de los tenants.
  • 🛠️ ⏱️ 08:42 Instalación de stancl/tenancy: Descarga del paquete e inicialización de archivos de configuración (config/tenancy.php, routes/tenant.php, migraciones y providers).
  • 📝 ⏱️ 12:42 Registro del Service Provider en Bootstrap: Incorporación de TenancyServiceProvider en el archivo de inicio de la aplicación.
  • 🔑 ⏱️ 13:13 Configuración del Archivo .env y Motor InnoDB: Ajuste de credenciales MySQL, deshabilitación de SQLite y fuerza del motor InnoDB para mantener integridad de relaciones.
  • 🚀 ⏱️ 14:19 Ejecución de Migraciones Iniciales: Migración de las tablas base de Laravel junto con las nuevas tablas tenants y domains.

🛠️ Comandos y Rutas Principales

TipoComando / RutaDescripción / Propósito
💻 Terminalphp -v & composer --versionVerificación de versiones compatibles de PHP (8.3+) y Composer.
💻 Terminalcomposer create-project laravel/laravel mi-tiendaCreación e instalación del proyecto Laravel.
💻 Terminalcomposer require stancl/tenancyDescarga e instalación del paquete stancl/tenancy.
💻 Terminalphp artisan tenancy:installGeneración automática de rutas routes/tenant.php y proveedor de servicios.
💻 Terminalphp artisan migrateCreación de tablas centrales (users, tenants, domains, etc.) en la BD mitienda_central.
🌐 Ruta HTTPhttp://localhost/mi-tienda/publicAcceso inicial al entorno de bienvenida de Laravel en el servidor local.

🔒 Buenas Prácticas y Seguridad

  1. 🏷️ Nomenclatura Clara de Bases de Datos: Utilizar un sufijo explícito como _central para la base de datos del SaaS (Landlord), evitando confusiones cuando el sistema comience a provisionar dinámicamente decenas de bases de datos de clientes.
  2. ⚙️ Uso Forzado del Motor InnoDB: Definir 'engine' => 'InnoDB' en las configuraciones MySQL para asegurar el soporte nativo de claves foráneas (foreign keys) y transacciones en todas las migraciones.
  3. 🔒 Separación del Entorno de Rutas: Mantener aisladas las rutas del sistema central (routes/web.php) de las rutas exclusivas de los inquilinos (routes/tenant.php).