CodeIgniter实现WebSocket推送教程

本文深入剖析了CodeIgniter 3.x与WebSocket集成的本质难点：CI控制器无法承载长连接，因其HTTP生命周期短暂，导致直接在路由或控制器中实现onOpen/onMessage必然失败；真正可行的方案是剥离WebSocket服务为独立常驻进程（推荐Workerman而非Ratchet），与CI应用并行运行，双方仅通过Redis或数据库共享用户会话、在线状态和消息数据，并强调了PHP sockets扩展启用、Nginx反向代理关键配置（Upgrade头透传、proxy_buffering关闭）及守护进程部署等生产级硬性要求——揭示“连得上”只是起点，“稳得住、扩得开、查得清”才是落地核心。

CodeIgniter 3.x 本身不支持 WebSocket，必须靠外部库桥接；直接在 CI 控制器里写 onOpen 或启动 chat_server.php 是无效的——它根本不是 HTTP 生命周期的一部分。

为什么不能用 CI 的路由或控制器处理 WebSocket 连接

WebSocket 握手虽以 HTTP 请求发起（GET + Upgrade 头），但后续通信完全脱离 PHP-FPM 生命周期。CI 的 Chat.php 控制器被 Apache/Nginx 调用时，请求一结束，进程就销毁，ConnectionInterface 实例随之丢失。你看到的 “New connection!” 日志可能刷出来，但几秒后连接必然断开，onMessage 永远不会触发。

真正有效的做法是：把 WebSocket 服务作为独立常驻进程运行，和 CI 应用并行，二者仅通过共享存储（如数据库、Redis）交换状态。

• CI 负责用户登录、消息存库、前端页面渲染
• Ratchet 进程负责维持长连接、广播、鉴权（需自己实现）、映射 $conn->resourceId 到用户 ID
• 两者之间不能共用 CI 的 $this->session 或模型实例，必须重新加载或用原生 PDO/Redis 客户端

Ratchet 与 CodeIgniter 共享数据库状态的关键点

常见错误是 WebSocket 服务里直接调用 $this->ci->load->model('chat_model') ——这在 Ratchet 独立进程中会报 Fatal error: Call to a member function load() on null，因为 get_instance() 返回空。

正确方式是绕过 CI 引导，直连数据库或缓存：

• 在 Chat.php 构造函数中，用原生 PDO 初始化数据库连接，或 new Redis()
• 用户登录成功后，CI 写一条带 user_id 和临时 token 的记录到 ws_sessions 表；Ratchet 在 onOpen 时解析 URL 参数（如 ws://localhost:8080?token=abc123），查表绑定身份
• 消息广播前，先查 ws_sessions 获取当前在线的 resourceId 列表，再遍历 $this->clients 发送

别依赖 CI 的自动加载机制——Ratchet 进程不走 index.php 入口，application/config/autoload.php 完全不生效。

PHP Sockets 扩展和守护进程部署的硬性条件

本地测试能跑通，不等于线上可用。以下三项缺一不可：

• sockets 扩展必须启用：php -m | grep sockets，没输出就得重编译 PHP 或改用 ext-redis 替代部分功能
• WebSocket 服务不能靠 php chat_server.php 手动运行：它会随终端关闭而终止；必须用 nohup php chat_server.php & 或 systemd 托管，并加心跳检测脚本
• Nginx/Apache 不能直接反向代理 WebSocket（除非配置了 Upgrade 和 Connection 头透传）；建议前端直连 ws://yourdomain.com:8080，或用 Nginx 显式配置 proxy_http_version 1.1 + proxy_set_header Upgrade $http_upgrade

很多“集成失败”其实卡在 Nginx 配置漏掉 proxy_buffering off，导致消息延迟数秒甚至丢帧。

替代方案：Workerman 更适合 CI3 生产环境

Ratchet 对 PHP 版本敏感（cboden/ratchet:^0.4.4 最高只支持 PHP 7.4），且异常堆栈难调试；而 Workerman 原生支持 PHP 8.0+，自带守护进程管理、平滑重启、连接数统计，和 CI3 兼容性更好。

迁移要点：

• 把 chat_server.php 改成 workerman start 启动入口，Worker 实例监听 websocket://0.0.0.0:2346
• Workerman 的 onConnect 回调里做 token 验证，比 Ratchet 的 onOpen 更早拿到原始 request
• 用 $_SERVER['HTTP_SEC_WEBSOCKET_PROTOCOL'] 提取自定义协议头（如 user_id=123），避免额外 HTTP 查询
• CI 控制器里发消息时，不再轮询数据库，而是用 GatewayClient 直连 Workerman 的 Gateway 进程推送

真正麻烦的从来不是“怎么连上”，而是“连上之后怎么稳住、怎么扩、怎么查问题”。Ratchet 适合教学演示，Workerman 才扛得住日活 5k+ 的聊天场景。

终于介绍完啦！小伙伴们，这篇关于《CodeIgniter实现WebSocket推送教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！