ThinkPHP客服系统开发教程-ThinkPHP-PHP中文网

thinkphp客服系统需thinkphp+workerman+websocket三者协同运行，缺一不可；配置错误、环境缺失、权限问题及nginx代理设置不当是常见故障根源。

thinkphp客服系统开发教程

ThinkPHP 客服系统不是装完就能跑的框架项目，它本质是「ThinkPHP + Workerman + WebSocket」三件套组合体，缺一不可。不配好 Workerman 服务，前端聊天窗口永远显示“连接中”；不改对 public/index.php 和 Nginx 配置，后台根本打不开。

为什么 `start_for_win.bat` 双击没反应或报错？

Windows 下双击启动失败，90% 是因为 PHP 命令没进系统 PATH，或者当前目录不对。

别双击，用 CMD 进入 websocket/ 目录后手动执行：php start.php start -d
确认 PHP 版本 ≥ 7.2（php -v 查），且未禁用 pcntl_fork、pcntl_signal 等函数（宝塔面板里要手动删掉这些禁用项）
如果提示 Class 'Workerman\Worker' not found，说明 vendor/ 缺失 —— 源码包里没带 Composer 依赖，必须进项目根目录执行 composer install 补全
端口被占常见于 456、9090、2080 —— 用 netstat -ano | findstr :456 查 PID，再用任务管理器杀掉

`config/database.php` 改了但连不上数据库？

ThinkPHP 5 的数据库配置默认走 env 文件优先级更高，光改 database.php 不生效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

先检查项目根目录是否存在 .env 文件，如果有，优先修改它里面的 DB_HOST、DB_NAME 等字段
MySQL 字符集必须是 utf8mb4，建库时加 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci，否则中文存进去变问号或报错
账号密码含特殊字符（如 @、/）必须 URL 编码，例如密码 pa@ss/word 要写成 pa%40ss%2Fword
宝塔用户注意：MySQL 默认只允许本地连接，远程访问需在 phpMyAdmin 里给用户授权 host = %

Nginx 代理 WebSocket 失败，消息发不出去？

WebSocket 不是 HTTP，Nginx 必须显式开启 Upgrade 协议支持，否则握手直接 400。

location 块里必须同时存在这三行（顺序不能错）：proxy_http_version 1.1、proxy_set_header Upgrade $http_upgrade、proxy_set_header Connection "Upgrade"
别把 proxy_pass http://127.0.0.1:456 写在 location / 下 —— 应单独配 location /app 或 location /gateway，和前端 JS 里 new WebSocket('wss://xxx.com/app') 的路径严格一致
HTTPS 强制要求：wss:// 必须配 SSL，且证书不能是自签；Nginx 的 ssl_protocols 至少包含 TLSv1.2
浏览器控制台若报 net::ERR_CONNECTION_REFUSED，先 telnet 测试端口：telnet 127.0.0.1 456，不通就说明 Workerman 根本没起来

商户后台登录成功却跳转 404？

ThinkPHP 5 的路由和入口文件耦合极深，public 目录外的请求会被直接拦截。

确保网站根目录指向的是 /public，不是项目根目录 —— 宝塔里叫“网站目录”，必须手动改
伪静态规则必须启用且匹配 ThinkPHP：Nginx 配置里要有 if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s=$1 last; }
前端 JS 请求地址写死成 /admin/login，但实际接口可能是 /index.php/admin/login —— 打开浏览器 Network 面板看真实请求路径，再反推路由是否开启
session 保存路径权限问题常被忽略：runtime/session 目录需 755，且属主是 web 服务器运行用户（如 www）