CPanel环境下PHP+Ratchet WebSocket应用WSS连接失败求助

问题描述 #

使用PHP Ratchet搭建的WebSocket聊天应用尝试连接WSS服务器时失败，报错：

WebSocket connection to 'wss://mywebsite.com:8080/' failed.
网站已部署SSL证书，需排查并解决连接问题。

代码中的直接错误 #

你的server.php存在致命逻辑错误：创建服务器时错误实例化了ConnectionInterface（这是接口，不能直接实例化），正确做法是用WsServer包装Chat业务组件，因为Ratchet需要通过WsServer处理WebSocket协议。

常见失败原因及解决方法 #

1. 未配置WSS所需的SSL支持 #

默认IoServer仅处理未加密的WS连接，要支持WSS（加密WebSocket），必须使用SecureIoServer并加载SSL证书。
解决方法：
在server.php中新增SecureIoServer引入，并配置证书路径：

use Ratchet\Server\SecureIoServer;

// 替换原服务器创建代码
$server = SecureIoServer::factory(
    new HttpServer(
        new WsServer(new Chat())
    ),
    8080,
    '0.0.0.0', // 允许外部访问，不要仅绑定127.0.0.1
    [
        'local_cert' => '/path/to/your/fullchain.pem', // 替换为你的SSL证书路径
        'local_pk' => '/path/to/your/privkey.pem', // 替换为你的私钥路径
        'verify_peer' => false // 生产环境可按需调整
    ]
);

2. 端口未开放或被占用 #

• 检查服务器防火墙/安全组是否开放8080端口，允许TCP入站连接；
• 执行netstat -tulpn | grep 8080查看端口是否被其他进程占用，若占用则更换端口或停止占用进程。

3. 反向代理（如Nginx）拦截 #

若网站用Nginx做反向代理，需配置Nginx转发WSS请求到8080端口，避免直接访问端口被拦截：
添加Nginx配置：

location /wss {
    proxy_pass http://127.0.0.1:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

此时客户端连接地址改为wss://mywebsite.com/wss，无需带端口。

4. SSL证书问题 #

• 确保证书有效且匹配域名，生产环境避免使用自签名证书（会被浏览器拦截）；
• 检查证书和私钥文件权限，确保运行PHP进程的用户（如www-data）有读取权限。

5. 客户端连接地址问题 #

• 确认域名解析正常，mywebsite.com能正确指向服务器IP；
• 若使用Nginx转发，客户端需使用配置的路径（如wss://mywebsite.com/wss），而非带端口的地址。

修正后的完整server.php代码 #

<?php
require 'vendor/autoload.php';

use Ratchet\MessageComponentInterface;
use Ratchet\ConnectionInterface;
use Ratchet\Http\HttpServer;
use Ratchet\Server\SecureIoServer;
use Ratchet\WebSocket\WsServer;

class Chat implements MessageComponentInterface {
    protected $clients;

    public function __construct() {
        $this->clients = new \SplObjectStorage;
    }

    public function onOpen(ConnectionInterface $conn) {
        $this->clients->attach($conn);
    }

    public function onMessage(ConnectionInterface $from, $msg) {
        foreach ($this->clients as $client) {
            if ($from !== $client) {
                $client->send($msg);
            }
        }
    }

    public function onClose(ConnectionInterface $conn) {
        $this->clients->detach($conn);
    }

    public function onError(ConnectionInterface $conn, \Exception $e) {
        $conn->close();
    }
}

$server = SecureIoServer::factory(
    new HttpServer(
        new WsServer(new Chat())
    ),
    8080,
    '0.0.0.0',
    [
        'local_cert' => '/path/to/your/fullchain.pem', // 替换为你的证书路径
        'local_pk' => '/path/to/your/privkey.pem', // 替换为你的私钥路径
        'verify_peer' => false
    ]
);

$server->run();

内容的提问来源于stack exchange，提问作者kovrita is The life