PHP str_increment 怎样生成连续的字母数字编号

如果编号只需要在字母和数字之间连续递增，PHP 8.3 及以上可以直接使用 str_increment()。它接收一个非空的 ASCII 字母数字字符串，返回递增后的字符串；例如 ABC 会得到 ABD，DZ 会发生进位变成 EA，ZZ 会变成 AAA。

官方地址：https://www.php.net/manual/en/function.str-increment.php

这篇只讨论字符串序号本身。若编号还要带 INV- 这样的业务前缀，应该把前缀和可递增主体分开；如果编号必须在多个请求或多个进程之间唯一，仍然需要数据库、队列或其他持久化发号机制。

先确认 str_increment 的输入边界

str_increment() 从 PHP 8.3 开始提供，参数类型是 string，输入必须是非空的 ASCII 字母数字字符串。这里的重点不是“看起来像编号”，而是字符串本身不能带连字符、空格、下划线或其他非字母数字字符。

因此，下面这种写法把职责分得很清楚：序号主体交给函数，业务前缀留在调用方。

这段代码的关键是 $sequence 没有包含 INV-。如果把完整的 INV-ABC 直接传入函数，连字符就越过了函数规定的输入边界。

先看懂右侧递增和左侧进位

排查编号“突然变长”时，先看字符串最右侧是否已经到达当前字符集合的边界。普通递增只改变右侧字符；当右侧需要进位时，变化会向左传播。

 ' . str_increment($current) . PHP_EOL;
}
// ABC => ABD
// DZ => EA
// ZZ => AAA
?>

不要把返回值当整数相加。str_increment() 的结果仍然是字符串，ZZ 到 AAA 的长度变化也是它的正常进位结果。

把 ValueError 放在编号入口处理

空字符串或包含非字母数字 ASCII 字符的输入会触发 ValueError。在表单、导入文件或接口参数进入编号逻辑之前，最好把异常转换成业务层能理解的错误，而不是让 PHP 异常直接冒泡到页面。

getMessage();
}
?>

如果调用方已经有明确的输入校验，也可以在进入函数前返回业务错误；保留 ValueError 捕获仍然有价值，因为它能防止后续代码绕过入口校验。

固定前缀要和序号主体拆开

实际编号经常长这样：INV-ABC、ORDER-001。连字符和其他装饰字符属于业务格式，不属于 str_increment() 的递增域。正确的思路是先拆出主体，递增后再拼回前缀。

getMessage();
}
?>

这个例子没有尝试让 str_increment() 理解业务前缀，也没有把“编号格式校验”和“序号递增”混成一个步骤，后续更换前缀时更容易维护。

不要用旧式字符串自增替代它

老代码可能直接写 $code++。PHP 手册已经把 str_increment() 作为非数字字符串递增的明确函数；在 PHP 8.3 及以上，依赖旧式字符串自增的代码还会遇到弃用方向和输入语义差异。新代码应把意图写出来：

什么时候 str_increment 不够用

如果编号只在一个进程内按顺序展示，str_increment() 足够简单。但在 Web 请求、队列消费者或多台应用同时分配编号时，先读取旧值再递增再写回会产生竞争：两个调用方可能拿到同一个旧值，也可能覆盖彼此的结果。

这时应把“下一个编号由谁占用”交给具备原子操作的持久化层，PHP 只负责把已分配的序号格式化为字符串。不要把 str_increment() 本身当作数据库序列、分布式锁或全局唯一 ID 生成器。

常见问题

str_increment() 能处理中文或连字符吗？

不能按本文的输入契约使用。它要求非空的 ASCII 字母数字字符串，中文、连字符、空格等字符都应在进入函数前被拒绝或拆出。

为什么 ZZ 会变成 AAA？

这是字母进位后的正常结果：右侧字符到达边界后向左进位，最左侧也需要进位时字符串长度增加。

可以用它生成订单号吗？

可以用它格式化一个已经由可靠存储层分配的序号主体，但不能只靠它解决多请求并发下的唯一性。生成订单号时要把事务、唯一索引或原子计数放在更合适的持久化层。

总结一下：先把业务前缀和序号主体分开，再把合法的 ASCII 字母数字主体交给 str_increment()；对空输入和非法字符捕获 ValueError；一旦进入多进程发号场景，就把唯一性问题交给持久化的原子分配机制。