ThinkPHP5.0与WorkermanWebSocket连接失败排查方法

本文针对ThinkPHP5.0框架结合Workerman搭建WebSocket服务时，前端JS无法连接的问题，提供详细的排查方案。 问题描述：在Linux环境下，使用TP5.0、PHP和Workerman搭建WebSocket服务，服务端运行正常，但浏览器端使用127.0.0.1、0.0.0.0和公网IP均无法连接，2222端口已开放。文章将详细讲解如何排查防火墙设置、`$socket`配置（`websocket://127.0.0.1:2222`改为`websocket://0.0.0.0:2222`或公网IP）、服务端代码错误（`onMessage`等方法）、`server.php`配置（`BIND_MODULE`）以及ThinkPHP5与Workerman集成等问题，帮助开发者快速解决ThinkPHP5.0与Workerman WebSocket连接失败的难题。

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端口已开放。

代码示例：

服务端 (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';

排查步骤：

1. 防火墙: 即使端口2222已在宝塔面板中开放，也需仔细检查服务器防火墙是否允许外部访问该端口。

2. $socket 配置: workercontroller.php 中的 $socket 属性 websocket://127.0.0.1:2222 只监听本地连接。若需外部访问，需修改为 websocket://0.0.0.0:2222 或服务器公网IP地址，修改后重启Workerman服务。

3. 服务端代码错误: 检查 onMessage、onConnect、onClose、onError 和 onWorkerStart 方法的实现，潜在错误可能导致连接失败或消息处理异常。 务必检查错误处理机制。

4. server.php 配置: 确认 server.php 中的 BIND_MODULE 是否正确指向Workerman控制器所在的模块。任何配置错误都可能导致Workerman无法正常启动或加载控制器。

5. ThinkPHP5与Workerman集成: 确保ThinkPHP5框架和Workerman的集成配置正确，检查 composer.json 文件，确保Workerman依赖已正确安装和加载。

建议按照以上步骤逐一排查，并提供完整的代码和错误信息以便更有效地分析问题。 $socket 配置和防火墙设置通常是外部连接失败的主要原因。

到这里，我们也就讲完了《ThinkPHP5.0与WorkermanWebSocket连接失败排查方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！