docs: 安装/导入文档 + 部署文档刷新 + workerman 进程文件收归 storage
CI / test (push) Failing after 7s
CI / deploy (push) Skipped

- docs/install.md:全新安装指南(环境要求/.env/验收清单/常见问题)
- docs/import.md:Sablog 导入全解(命令参数表/数据映射/附件短代码/301 兼容/S3 同步/幂等重跑/检查清单)
- docs/deploy.md:补生产迁移顺序、上线前检查清单、调度器实际内容
- Workerman 进程文件(pid/status/log)统一写入 storage/framework 与 storage/logs,不再出现在项目根目录;.gitignore 排除并清理根目录残留
- README 文档导航补 install/import
This commit is contained in:
ak
2026-08-13 05:00:22 +08:00
parent 6f13d13d5a
commit 43dc8f9856
6 changed files with 247 additions and 7 deletions
+29 -6
View File
@@ -40,11 +40,27 @@ MARKET_TOKEN=
## 生产迁移顺序
1. `php artisan migrate --seed`
2. 导入老数据:`php artisan sablog:import --database=sablog ... --attachments-dir=... --sync-attachments --convert-markdown`
3. 配置 S3 后同步附件:`php artisan attachments:sync-s3 --legacy-dir=...`
4. 生成主题资产(可选):`php artisan theme:publish`
5. 启动 Workerman + 队列 + 调度器
1. `composer install --no-dev --optimize-autoloader`
2. `.env` 生产配置(见上;`APP_ENV=production``APP_DEBUG=false``APP_URL` 用正式域名)
3. `php artisan config:cache && php artisan route:cache && php artisan view:cache`
4. `php artisan migrate --seed`
5. 导入老数据(如需):见 `docs/import.md`
6. 配置 S3 后同步附件(如需):`php artisan attachments:sync-s3 --legacy-dir=...`
7. 生成主题资产:`php artisan theme:publish`
8. 启动队列消费者(workerman 或 queue:work,见下)+ 配置 cron 调度器
9. 后台改默认管理员密码;确认内置插件启用状态(SEO/AI/支付/会员/外链中转)
## 上线前检查清单
- [ ] `APP_ENV=production``APP_DEBUG=false``APP_URL` 正式域名
- [ ] `php artisan config:cache` 已执行(改了 .env 后需重新执行)
- [ ] 队列消费者进程在跑(AI 审核依赖;systemd 配置见下)
- [ ] cron 已配置 `schedule:run`(每日备份依赖)
- [ ] 管理员密码已改(默认 `admin@laralog.test` / `password`
- [ ] 支付:确认「支付设置」里沙箱开关符合预期(默认沙箱,真实渠道需公网回调)
- [ ] LLM 配置有效(不配则评论走人工审核流程)
- [ ] S3 已配置或确认回退本地磁盘(见 `docs/install.md`
- [ ] `storage/``bootstrap/cache/` 目录可写
## Nginx(前端由 Laravel 接管,老 URL 由应用层 301)
@@ -115,7 +131,14 @@ systemctl enable --now laralog-workerman
* * * * * cd /var/www/laralog && php artisan schedule:run >> /dev/null 2>&1
```
调度器内注册的内容`spatie/laravel-backup` 备份、缓存清理等(按需在 `routes/console.php` 增删)。
调度器内注册的内容`routes/console.php`):
- 每日 03:00:数据库备份(`backup:run --only-db`,保留 7 天,日志 `storage/logs/backup.log`
- 每日 04:00:清理前台页面缓存
按需在 `routes/console.php` 增删。
> Workerman 进程文件(pid/status/log)统一写在 `storage/framework/``storage/logs/`,不会出现在项目根目录;已由 .gitignore 排除。
## 队列消费:workerman 与 queue:work 等价