应优先用 mb_strlen($str, 'UTF-8') 校验字符数下限,因其按 Unicode 字符计数,适合中文、emoji 等国际化场景;使用前需检查 mbstring 扩展是否启用,并用 is_string() 过滤非字符串类型。

PHP 中用 strlen() 判断字符串长度是否低于最小值
直接用 strlen() 是最常用、最可靠的方式,它返回字节数,对 ASCII 字符和大多数 UTF-8 场景都够用。但要注意:它不识别多字节字符的语义长度(比如一个中文汉字占 3 字节,strlen() 就算作 3),所以如果你的“最小长度”是按“字符个数”定义的(例如“至少 2 个汉字”),strlen() 就会误判。
常见错误现象:strlen("你好") === 6,但业务上你可能期望它是 2。
- 校验纯英文、数字、ASCII 符号时,
strlen()安全高效 - 涉及中文、日文、emoji 或用户输入不确定编码时,优先考虑
mb_strlen() - 若项目已统一使用 UTF-8 且无历史兼容压力,可强制指定编码:
mb_strlen($str, 'UTF-8')
用 mb_strlen() 做真正意义上的字符数下限校验
mb_strlen() 按字符计数,不是字节,更适合国际化场景。但它依赖 mbstring 扩展启用,部分轻量环境(如某些 Alpine Docker 镜像)默认不开启,调用会报 Call to undefined function mb_strlen()。
使用前务必确认:extension_loaded('mbstring'),否则 fallback 方案要提前设计。
立即学习“PHP免费学习笔记(深入)”;
- 必须显式传入编码参数,如
mb_strlen($str, 'UTF-8');不传可能因 default_charset 变动导致行为不一致 - 空字符串
""和null都会返回 0,注意提前用is_string()过滤非字符串类型 - 性能上比
strlen()略低,但在绝大多数 Web 请求中差异可忽略
一行安全校验:避免 Notice + 支持 null/empty
实际业务里,输入可能为 null、false、数组或未定义变量,直接扔给 mb_strlen() 会触发警告或返回 0 导致逻辑错乱。
推荐写法:
if (!is_string($input) || mb_strlen($input, 'UTF-8') < $minLength) {
throw new InvalidArgumentException("字符串长度不能少于 {$minLength} 个字符");
}
-
is_string()拦截非字符串类型,比isset()+!empty()更精准(例如"0"是合法字符串,但empty("0")为 true) - 不要用
mb_detect_encoding()自动探测编码——不可靠,且可能被恶意构造的字节欺骗 - 如果允许空白字符(如前后空格),需先
trim();否则 “ ”(两个空格)也会通过mb_strlen() >= 1校验
命令行或 API 接口中的最小长度校验陷阱
CLI 脚本读取参数、API 接收 JSON 字段时,容易忽略隐形字符影响。比如前端传了 "name": "Alice\n",换行符会被计入长度;又或者 Windows 用户粘贴文本带 \r\n,在 Linux 环境下 mb_strlen() 仍会把它算作 2 个字符。











