PHP strspn 怎样从指定偏移读取连续数字前缀

我第一次用 strspn() 读取一段混合字符串里的数字时，真正容易弄错的不是函数名，而是“从哪里开始数”。它返回的是指定位置之后连续匹配的长度，不是数字在原字符串里的绝对下标。只要把 offset、length 和返回值的相对起点分开，读取类似 id=4827;status=ok 这样的前缀就很直接。

官方地址：https://www.php.net/manual/en/function.strspn.php

需要从指定偏移读取连续数字时，把 0123456789 作为允许字符集合，把 offset 作为扫描起点；返回值是从该起点开始的数字段长度，原字符串位置要用 offset + 返回值 换算。

下面的例子只讨论 ASCII 数字前缀的局部读取，不把 strspn() 当作完整的金额校验器或 Unicode 数字识别器。

先把 strspn 当作连续字符集合扫描器

strspn($string, $characters, $offset, $length) 会从扫描起点开始，看当前位置的字符是否属于第二个参数给出的集合；一旦遇到不在集合中的字符，就停止并返回已经连续匹配的长度。它不会跳过分隔符去寻找后面的第二段数字。

这里的 span 是 4，因为开头的 4 个字符都在数字集合中，第 5 个字符是分号。若字符串一开始就是分隔符，返回值就是 0；这表示“没有数字前缀”，不能直接当成读取到了数字 0。

offset 决定从哪里开始读

当数字字段前面还有固定前缀时，先确定扫描起点，再读取连续数字。例如 id=4827;status=ok 中，字符 4 位于下标 3，扫描应从 3 开始。

这里最重要的体验是：strspn() 不会返回 7。7 是原字符串中数字段之后的位置，而函数返回的是从 offset=3 开始数出的 4 个字符。需要继续读取分号或后面的字段时，使用 $end 才不会把相对长度误当绝对下标。

length 限制窗口，避免越界读取下一个字段

如果协议只允许当前字段最多读取 3 位数字，可以给出 length=3。这时即使后面仍然是数字，扫描也不会越过本次窗口。

length 是“本次最多检查多少个字符”，不是要强制返回的长度。输入只有两位数字时，返回值仍然是 2；输入第一位就不是数字时，返回值仍是 0。这个语义适合做协议字段的局部解析，但如果业务要求“必须正好 3 位”，还要额外比较 $span === 3。

把返回值换算成原串位置

解析器通常既要拿到数字文本，又要知道下一次读取从哪里开始。可以固定使用这组关系：

• span：从 offset 开始连续匹配到的长度。
• end：数字段在原串中的结束位置，等于 offset + span。
• substr($input, $offset, $span)：取出实际数字文本。

如果使用负 offset，PHP 会从字符串末尾倒数确定起点；为了让协议解析更容易读懂，固定格式的字段通常更适合先算出非负下标再传入。另一个边界是字符单位：这个函数按字符串字节处理，中文字符不应直接套用“一个字符一个下标”的假设。

它适合局部读取，不等于完整数字校验

strspn() 只回答“从这个位置开始，连续允许字符有多长”。要判断整个输入是否全部由数字组成，应该比较扫描长度和字符串长度；要接受可选符号、小数点或千分位，则应先定义清楚语法，再选择专门的解析方案。

因此，局部协议解析与完整输入校验要分开设计：前者关注 offset、窗口和下一位置，后者还要处理空串、符号、格式和业务范围。

常见问题

为什么 strspn 返回 4，而我以为应该返回下标 7？

因为返回值从 offset 位置重新计数。原串位置要用 offset + span 换算。

length 设置为 3，为什么短输入只返回 2？

length 是扫描上限，不是强制长度。需要固定长度时，额外判断返回值是否等于目标长度。

strspn 能识别中文数字或完整金额吗？

本文场景是 ASCII 字节集合的连续前缀。中文数字、符号、小数点和金额范围需要独立定义规则，不能只靠数字字符集合解决。

我的结论是：把 strspn() 放在“局部字段读取”这一层，它会非常清楚；只要记住返回的是相对长度，并显式处理 0 长度匹配，后续的字符串切片和字段游标就不容易错位。