thinkphp5.0集成workerman websocket连接失败排查指南
本文针对ThinkPHP5.0框架结合Workerman构建WebSocket服务，前端JS无法连接的问题，提供详细的排查步骤。
问题描述：用户使用TP5.0.24、PHP 5.6.40和Workerman 3.5.31在Linux（宝塔面板）环境下搭建WebSocket服务，服务端运行正常，但浏览器端JS代码无法连接，尝试过127.0.0.1、0.0.0.0和服务器公网IP均失败，服务器2222端口已开放。
代码示例：
立即学习“PHP免费学习笔记（深入）”；
服务端 (workercontroller.php):
<?php
namespace app\push\controller;
use think\worker\server;
class workercontroller extends server
{
protected $socket = 'websocket://127.0.0.1:2222';
// ... 其他方法 ...
}
前端JS代码:
ws = new WebSocket("ws://47.***.***.57:2222"); // 或 ws://127.0.0.1:2222
// ... 其他代码 ...
server.php:
#!/usr/bin/env php
<?php
define('APP_PATH', __DIR__ . '/application/');
define('BIND_MODULE', 'push/Worker');
require __DIR__ . '/thinkphp/start.php';
排查步骤：
-
防火墙: 即使端口2222已在宝塔面板中开放，也需仔细检查服务器防火墙是否允许外部访问该端口。
-
$socket配置:workercontroller.php中的$socket属性websocket://127.0.0.1:2222只监听本地连接。若需外部访问，需修改为websocket://0.0.0.0:2222或服务器公网IP地址，修改后重启Workerman服务。 -
服务端代码错误: 检查
onMessage、onConnect、onClose、onError和onWorkerStart方法的实现，潜在错误可能导致连接失败或消息处理异常。 务必检查错误处理机制。 -
server.php配置: 确认server.php中的BIND_MODULE是否正确指向Workerman控制器所在的模块。任何配置错误都可能导致Workerman无法正常启动或加载控制器。 -
ThinkPHP5与Workerman集成: 确保ThinkPHP5框架和Workerman的集成配置正确，检查
composer.json文件，确保Workerman依赖已正确安装和加载。
建议按照以上步骤逐一排查，并提供完整的代码和错误信息以便更有效地分析问题。 $socket 配置和防火墙设置通常是外部连接失败的主要原因。
