02 Instalación y Configuración de Multi-Tenancy en Laravel (stancl/tenancy) desde cero
Duración: 16 minDescripció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
| Tipo | Comando / Ruta | Descripción / Propósito |
|---|---|---|
| 💻 Terminal | php -v & composer --version | Verificación de versiones compatibles de PHP (8.3+) y Composer. |
| 💻 Terminal | composer create-project laravel/laravel mi-tienda | Creación e instalación del proyecto Laravel. |
| 💻 Terminal | composer require stancl/tenancy | Descarga e instalación del paquete stancl/tenancy. |
| 💻 Terminal | php artisan tenancy:install | Generación automática de rutas routes/tenant.php y proveedor de servicios. |
| 💻 Terminal | php artisan migrate | Creación de tablas centrales (users, tenants, domains, etc.) en la BD mitienda_central. |
| 🌐 Ruta HTTP | http://localhost/mi-tienda/public | Acceso inicial al entorno de bienvenida de Laravel en el servidor local. |
🔒 Buenas Prácticas y Seguridad
- 🏷️ 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.
- ⚙️ 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.
- 🔒 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).