Implementación de Alojamiento Compartido (cPanel)

La Consola de la Tienda prefiere un VPS (Docker o LEMP), pero también funciona en un alojamiento compartido capaz. El alojamiento compartido significa sin acceso root, generalmente MySQL en lugar de PostgreSQL, sin Redis y sin procesos de larga duración — esta página cubre exactamente qué cambios.

Capacidades Mínimas del Host

PHP 8.4 con las extensiones estándar de Laravel (la mayoría de los selectores de PHP de cPanel las incluyen)
MySQL 8.0+ o MariaDB 10.6+ (PostgreSQL preferido donde esté disponible)
Tareas cron (al menos cada minuto)
Se recomienda encarecidamente el acceso SSH para composer y artisan

Paso 1: Subir y Apuntar la Raíz del Documento

Sube y extrae tu zip con licencia fuera de public_html, luego apunta la raíz del documento del (sub)dominio al directorio public/ de la app desde cPanel → Dominios. Nunca expongas la raíz de la aplicación en sí.

Paso 2: Configurar .env para Alojamiento Compartido

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password

QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null

Estos controladores son de primera clase: la cola, la caché y las tablas de sesión se envían en las migraciones predeterminadas, por lo que no se requiere Redis.

Paso 3: Migrar y Construir

php artisan migrate --seed
npm run build   # or build locally and upload public/build

Paso 4: Entradas de Cron (reemplaza a Horizon y systemd)

Añadir dos trabajos cron en cPanel → Trabajos Cron:

* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55

La segunda entrada drena cada cola una vez por minuto y sale, lo cual es seguro bajo los límites de proceso de hosting compartido. Horizon y su dashboard no se utilizan en hosting compartido.

Qué se Degrada — y Cómo

Características semánticas de IA (búsqueda vectorial, embeddings) necesitan PostgreSQL + pgvector — en MySQL se apagan limpiamente mientras las herramientas de chat, generación e informes de IA siguen funcionando a través de tu proveedor configurado
Chat en tiempo real & notificaciones utilizan Reverb/WebSockets en un VPS — sin ello, la UI vuelve a la sondeo periódico automáticamente (BROADCAST_CONNECTION=null)
Trabajos en segundo plano se ejecutan hasta un minuto más tarde que en un trabajador dedicado — aceptable para correo, facturas e informes; tiendas pesadas deberían mudarse a un VPS

Cuándo Actualizar a un VPS

Mudarse a un VPS cuando habilites POS o despacho de entrega (sensible a la latencia), confíes en búsqueda de IA, o proceses más de unos pocos pedidos por minuto. Tus datos migran con un volcado de base de datos estándar — no se necesita reinstalación.

Implementación de Alojamiento Compartido (cPanel)