在 cPanel 或共享主机上安装

在 cPanel 上安装

您需要 PHP 8.4、MySQL 数据库以及添加 cron 任务的能力。您不需要 Redis、Docker、PostgreSQL 或对长期运行进程的 shell 访问权限。

1. 上传并指向文档根目录

将发布包上传到 public_html之外，然后将域名的文档根目录指向应用程序的 public/ 目录。如果主机商不允许更改文档根目录，请将 public/ 在 public_html 的内容放置在根目录下，并更新 index.php。

顶部的两个路径。

2. 配置数据库和驱动程序 .env在

DB_CONNECTION=mysql
DB_HOST=localhost
DB_DATABASE=your_database
DB_USERNAME=your_user
DB_PASSWORD=your_password

CACHE_STORE=database
SESSION_DRIVER=database
QUEUE_CONNECTION=database
BROADCAST_CONNECTION=log

中，使用 MySQL 和非 Redis 驱动程序： REDIS_* 保持

值为空。然后运行安装程序，它将创建架构并生成您的第一个管理员账户。

3. 添加两个 cron 任务 共享主机无法保持工作进程持续运行，因此需要通过 cron 任务来处理队列。 为每个队列命名 queue:work ——仅使用 default 只会读取

# every minute — background jobs
* * * * * cd /home/youruser/storeconsole && php artisan queue:work --queue=default,accounting,crm-default --stop-when-empty --max-time=55 >/dev/null 2>&1

# every minute — scheduled tasks
* * * * * cd /home/youruser/storeconsole && php artisan schedule:run >/dev/null 2>&1

--stop-when-empty 队列，并会静默地跳过会计和 CRM 任务而不进行处理：

允许工作进程在队列清空后退出，从而避免任务堆积。此配置不使用 Horizon，因为它需要 Redis。

4. 检查状态 php artisan about运行 设置 → 系统。