Workerman报错“preg_match() expects parameter 2 to be string”-php教程-PHP中文网

该错误是因preg_match()第二个参数非字符串（如null、array）导致php报错，workerman中因异步特性易在http/ws解析、路由匹配等场景触发，需用is_string()校验或强制类型转换。

workerman报错“preg_match() expects parameter 2 to be string”

preg_match() expects parameter 2 to be string 是什么问题

这个错误不是 Workerman 自身抛出的，而是 PHP 的 preg_match() 函数在调用时，第二个参数（即待匹配的字符串）传入了非字符串类型（比如 null、array、int 或对象），PHP 直接报错中断执行。Workerman 作为常驻进程框架，一旦某次请求/回调中触发该错误且未捕获，就会导致当前 Worker 进程退出或连接异常。

常见触发位置包括：HTTP 请求体解析、WebSocket 消息处理、自定义路由匹配、中间件里对 $_GET / $_POST / $request->get() 等值直接丢给 preg_match() 做校验，而没做类型判断。

为什么在 Workerman 里特别容易踩这个坑

Workerman 的异步非阻塞特性会让变量生命周期和调试路径变得隐蔽，尤其以下场景高发：

ChatDev

ChatDev是一款AI智能体工具，面壁智能推出的AI智能体软件开发平台，使用自然语言即可创建软件。

下载

$request->post() 或 $request->get() 返回的是 array，但有人误以为某个键一定存在且是字符串，直接写成 preg_match('/^\d+$/', $request->get('id'))
WebSocket 收到的 $frame->data 可能是 binary（二进制数据）、null（如 ping/pong 帧），但代码默认当作 UTF-8 字符串处理
使用 json_decode() 解析客户端数据后未检查返回值，当 JSON 格式错误时返回 null，后续仍传给 preg_match()
路由正则匹配前，对 URI path 做了 urldecode() 或其他转换，结果得到 false（例如 urldecode('%')）

怎么快速定位和修复

先确认出错行号（看完整错误堆栈，重点找你自己的文件），然后围绕 preg_match() 调用点做三件事：

检查第二个参数是否可能为非字符串：用 is_string() 或 !empty() + is_scalar() 做兜底
所有来自网络输入的变量，一律先强制转字符串（谨慎！仅限明确需要字符串匹配的场景）：(string)$value，但要注意 null → ''、array → 'Array' 可能引入逻辑 bug
更安全的做法是提前过滤或拒绝异常输入：

// ❌ 危险写法
preg_match('/^\w+$/i', $request->get('username'));
<p>// ✅ 推荐写法
$username = $request->get('username');
if (!is_string($username) || $username === '') {
// 返回错误响应或跳过匹配
return;
}
preg_match('/^\w+$/i', $username);
</p>

如果是在 WebSocket 中处理 $frame->data，务必先判断帧类型和数据类型：

if ($frame->opcode === \Workerman\Protocols\Websocket::BINARY) {
  // 不适合 preg_match，考虑 unpack 或跳过
  return;
}
$data = $frame->data;
if (!is_string($data)) {
  return;
}