codeigniter 本身不原生支持 worker 模式和长连接,需借助 workerman 实现;应复用其 model/service 层但剥离 router/controller,禁用持久连接并采用连接池或自动重连机制。

CodeIgniter 本身是同步阻塞式框架,不原生支持 Worker 模式或长连接,它默认运行在 Apache/Nginx + PHP-FPM 架构下,每个 HTTP 请求独占一个 PHP 进程,连接数据库后即用即关(除非启用持久连接)。要实现真正的高并发、长连接和 Worker 模式,必须脱离 CI 的传统 Web 请求生命周期,借助外部常驻进程方案——最常用且成熟的就是 Workerman。
CodeIgniter 项目如何接入 Workerman 实现 Worker 模式
Workerman 是纯 PHP 编写的常驻内存、事件驱动框架,可独立于 Web 服务器运行。CI 项目可通过以下方式与其协同:
-
复用 CI 的业务逻辑层(Model/Service):把
application/下的模型、工具类、配置等封装为可独立加载的模块,供 Workerman 进程调用; -
不复用 CI 的请求响应流程(Router/Controller/View):Workerman 自己处理 TCP/HTTP/WebSocket 协议,CI 的
index.php入口不再适用; -
共享配置与 Autoload:通过手动加载 CI 的
CodeIgniter.php或提取其Loader机制,让 Workerman 能识别$this->load->model()等语法(需做轻量适配);更推荐方式是剥离业务逻辑为无框架依赖的服务类。
示例结构:
// workerman/start.php
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/application/config/database.php'; // 直接载入配置
require_once __DIR__ . '/application/models/User_model.php'; // 手动引入模型
use Workerman\Worker;
$worker = new Worker('tcp://0.0.0.0:1234');
$worker->onMessage = function($connection, $data) {
$user_model = new User_model(); // 或从 DI 容器获取
$result = $user_model->getById(1);
$connection->send(json_encode($result));
};
如何用 Workerman 支持长连接与高并发
CI 原生不维持长连接,但 Workerman 天然适合:
- TCP/UDP 长连接服务:如 IM、实时推送、设备通信;
- WebSocket 服务:替代轮询,单连接复用,降低 HTTP 开销;
- 异步任务网关:接收请求后投递到 Redis 队列,由 CI 的 CLI 命令消费(解耦 + 弹性伸缩)。
关键配置要点:
- 设置
max_connection和count匹配服务器资源(通常count = CPU核心数 × 2~4); - 启用
reloadable = false(避免热更新中断长连接); - 使用
libevent扩展提升事件循环性能(Linux 下强烈建议); - 限制单个连接内存占用,防止泄漏(如
connection->close()显式释放)。
数据库连接在 Worker 场景下的特别处理
CI 的 pconnect = TRUE 在 Workerman 中不适用且危险——因为 Workerman 进程常驻,连接不会随请求结束而释放,而 MySQL 的 wait_timeout(默认 28800 秒)可能早于进程生命周期,导致后续查询报 MySQL server has gone away。
正确做法:
-
禁用 CI 的持久连接(
pconnect => FALSE),改用连接池式管理; - 使用
workerman/mysql(基于协程+连接池的异步 MySQL 客户端),或封装带自动重连的 PDO 实例; - 对每个 Worker 进程维护独立连接句柄,执行前 ping 检测,失败则重建;
- 敏感操作加 try-catch + 重试(最多 2 次),避免单点故障中断长连接会话。
不推荐的“伪 Worker”方案
- 把 CI Controller 当作 Worker 脚本,在 CLI 下循环执行:易阻塞、无事件循环、无法真正长连接;
- 用
pcntl_fork()在 CI 内部启子进程:PHP-FPM 环境不支持,且难以管理生命周期; - 仅靠
set_time_limit(0)+ignore_user_abort(true)模拟常驻:资源不可控,超时/异常后进程消失,不可靠。
这些方式看似“接入 Worker”,实则违背高并发设计本质,容易在线上引发连接堆积、内存泄漏、TIME_WAIT 爆满等问题。
不复杂但容易忽略。











