共享主机 (cPanel) 部署

共享主机 (cPanel) 部署

商店控制台更倾向于 VPS (Docker 或 LEMP)，但也可以在合适的共享主机上运行。共享主机意味着没有 root 访问权限，通常使用 MySQL 而不是 PostgreSQL，没有 Redis，也没有长时间运行的进程——此页面详细说明了具体的更改。

最低主机能力

• PHP 8.4 及标准 Laravel 扩展（大多数 cPanel PHP 选择器包含它们）
• MySQL 8.0+ 或 MariaDB 10.6+（在可用的情况下优先使用 PostgreSQL）
• Cron 任务（至少每分钟一次）
• 强烈建议为 composer 和 artisan
提供 SSH 访问权限

步骤 1：上传并指向文档根目录

在 public_html 外上传并解压您的授权 zip 文件，然后将（子）域的文档根目录指向应用的 public/ 目录，路径为 cPanel → 域名。切勿暴露应用根目录本身。

步骤 2：为共享主机配置 .env

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

这些驱动程序是一流的：队列、缓存和会话表在默认迁移中提供，因此不需要 Redis。

步骤 3：迁移和构建

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

步骤 4：Cron 条目（替代 Horizon 和 systemd）

在 cPanel 中添加两个 cron 作业 → Cron 作业：

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

第二个条目每分钟处理一次所有队列并退出，这在共享主机的进程限制下是安全的。Horizon 及其仪表板不适用于共享主机。

什么会降级 — 以及如何

• AI 语义功能（向量搜索，嵌入）需要 PostgreSQL + pgvector — 在 MySQL 上它们会在 AI 聊天、生成和报告工具通过您配置的提供商继续工作时干净地关闭
• 实时聊天 &通知在 VPS 上使用 Reverb/WebSockets — 如果没有它，UI 会自动回退到定期轮询（BROADCAST_CONNECTION=null）
• 后台作业比专用工作者晚最多一分钟运行 — 对于邮件、发票和报告是可以接受的；重负载商店应迁移到 VPS

何时升级到 VPS

当您启用 POS 或配送调度（延迟敏感）、依赖 AI 搜索或每分钟处理超过几个订单时，迁移到 VPS。您的数据通过标准数据库转储迁移 — 无需重新安装。