推荐优先使用 php 8.0+ 的 str_startswith(),语义清晰、安全高效;php 7.x 用 strncmp() 替代 substr();处理多字节字符需用 mb* 函数并显式指定 utf-8 编码;输入应统一转字符串并注意 trim。

用 str_starts_with() 最简单,但得 PHP 8.0+
PHP 8.0 起原生支持 str_starts_with(),直接返回布尔值,不用写正则、不担心大小写陷阱、也不用自己算偏移量。
它专为“判断开头”而生,语义清晰,性能也好。
常见错误现象:
— 有人用 substr($str, 0, 2) === 'ab',但当 $str 长度不足时会返回 false 或空字符串,比较结果意外为 false;
— 有人用 strpos($str, 'ab') === 0,但 strpos 对空字符串或 false 输入容易误判(比如搜索空串会返回 0)。
-
str_starts_with()自动处理空字符串、null(返回false),安全省心 - 区分大小写:想忽略大小写?得先用
strtolower()或mb_strtolower()统一转换,它本身不提供选项 - 不支持多字节字符的“智能”截断(比如中文、emoji),但只要你的前缀是 ASCII 或已知编码一致,就没问题
PHP 7.x 怎么办?别硬套 substr(),用 strncmp() 更稳
很多项目还在 PHP 7.4 甚至 7.2,str_starts_with() 不可用。这时候别写 substr($s, 0, $len) === $prefix —— 它在 $s 比 $prefix 短时会触发 notice(如果 error_reporting 开了 E_NOTICE),而且字符串拼接或类型隐式转换可能埋雷。
推荐用 strncmp():
— 它只比较前 N 个字符,不关心剩余长度;
— 返回 0 表示匹配,非 0 表示不匹配,不会因为输入短就报错;
— C 底层实现,比 substr + === 略快一点点。
立即学习“PHP免费学习笔记(深入)”;
-
strncmp($str, $prefix, strlen($prefix)) === 0是标准写法 - 注意:
$prefix不能为null,否则strlen(null)返回0,strncmp就变成比 0 字符,永远返回0(即“总匹配”)—— 这是个高频坑 - 如果
$prefix可能为空,先加一层判断:strlen($prefix) === 0 || strncmp($str, $prefix, strlen($prefix)) === 0
需要兼容中文或 emoji?别信 substr(),上 mb_substr() + mb_strcut()
普通 substr() 和 strncmp() 按字节操作,遇到 UTF-8 中文、emoji(如 ? 占 4 字节)会切在中间,导致乱码或匹配失败。比如 substr('你好', 0, 1) 可能返回半个汉字。
正确做法是用多字节函数,但注意:mb_substr($str, 0, mb_strlen($prefix, 'UTF-8'), 'UTF-8') 再比较,虽可行但稍重;更轻量的是用 mb_strcut()(按字节截但保证不破字符)配合 ===,或者直接用 mb_strpos($str, $prefix, 0, 'UTF-8') === 0。
-
mb_strpos()第三个参数是 offset,设为0就等价于“是否开头”,且内部做了编码安全处理 - 务必显式传入
'UTF-8'编码参数,否则依赖mb_internal_encoding(),线上环境容易不一致 - 性能上,
mb_strpos比mb_substr+ 比较略优,因为不用构造新字符串
别漏掉边界场景:空字符串、null、数字转字符串
真实业务里,$str 往往来自表单、API 或数据库字段,可能是 null、空字符串、整数(比如 ID 字段被当成字符串用)、或空白符包裹的字符串。这些不处理,str_starts_with() 或 strncmp() 都可能行为异常。
-
str_starts_with(null, 'a')返回false(安全),但str_starts_with(123, '1')会触发 warning:PHP 试图把 int 当 string 用 - 稳妥写法:统一转成字符串再判断,
str_starts_with((string)$str, $prefix) - 如果要忽略首尾空白,得先
trim($str)——str_starts_with()不自动 trim,这点和 JS 的startsWith()一样 - 特别注意数据库查出来是
NULL字段,在 PHP 里就是null,不是字符串'null',别混淆
null 或数字,又没 cast,线上就挂。多包一层 (string) 几乎零成本,但能避开一大半诡异 case。











