本地开发与调试

开始前可先查看项目目录了解代码入口；需要确认系统组成时参阅系统架构。

前置条件

• PHP 8.1 或更高版本。
• Composer 依赖已安装。
• MySQL 或 PostgreSQL。

启动

在项目根目录执行：

php start.php start

开发时不要添加 -d。前台运行时，文件监控会自动重新加载 PHP、HTML、环境和配置改动；后台守护运行后则需要按实际修改范围执行 reload 或 restart。

调试顺序

1. 用浏览器打开访客页或客服工作台，确认 HTTP 登录或访客 Token 已生效。
2. 查看 runtime/ 下的运行日志，先定位 Controller 是否收到请求。
3. 对消息问题，依次确认：HTTP 返回、数据库消息记录、Push::emit() 结果、WebSocket 订阅状态。
4. 对断线或漏消息，重新拉取消息历史并以 mid 对比，不只依赖浏览器实时事件。

数据库兼容

运行时可以使用 MySQL 或 PostgreSQL。业务代码不要在 Controller 里针对数据库类型写分支；已有的方言与数据库辅助代码负责处理差异。

遇到启动、请求或实时连接问题时，可按监控与故障排查的顺序收集信息。