ThinkPHP5.0集成Workerman WebSocket连接失败：如何排查服务器端及客户端配置问题？-php教程-PHP中文网

ThinkPHP5.0集成Workerman WebSocket连接失败：如何排查服务器端及客户端配置问题？

碧海醫心

发布： 2025-03-21 08:14:24

原创

933人浏览过

thinkphp5.0集成workerman websocket连接失败排查指南

本文针对ThinkPHP5.0框架结合Workerman构建WebSocket服务，前端JS无法连接的问题，提供详细的排查步骤。

ThinkPHP5.0集成Workerman WebSocket连接失败：如何排查服务器端及客户端配置问题？

问题描述：用户使用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 配置和防火墙设置通常是外部连接失败的主要原因。

以上就是ThinkPHP5.0集成Workerman WebSocket连接失败：如何排查服务器端及客户端配置问题？的详细内容，更多请关注php中文网其它相关文章！