PHP str_increment 怎样递增数字字符串并保留前导零

PHP 8.3 起可以使用 str_increment 递增由 ASCII 字母和数字组成的字符串。数字编号要保留前导零，应把原值作为字符串传入并接收返回的字符串，不要先转换为整数。不过，保留前导零不代表固定长度：进位超出原有位数时，结果会变长。

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

先保住输入的字符串身份

假设编号来自表单或文件，内容是 0047。若先转换为整数，前面的零已经丢失，后续函数没有原始宽度可参考。更合适的做法是保留文本，并在业务入口确认它符合编号规则。下面是原创示例，预期值用于解释语义，未在本文环境执行。

函数返回新字符串，所以连续递增时要把返回值赋回所需变量。它不是通过参数引用修改原值。

保留前导零与固定宽度是两件事

把 0099 递增，可得到 0100；把 9999 递增，结果会扩展为 10000。若系统要求最多四位，应由业务规则在分配编号前判断容量，而不能把结果截掉一位。截断会改变编号并可能与已有值冲突。

字母数字混合输入遵循字符串递增规则，不是解析一个数值再做加法。固定前缀、固定宽度或自定义字符集都属于额外的业务约定，不能仅凭函数接受该字符串就认定满足这些约定。

入口限制应比通用函数更具体

官方接口要求非空 ASCII 字母数字字符串；空字符串、连字符、空白或中文等不符合这一范围的内容会触发 ValueError。若当前任务只允许数字，可以先用明确的 ASCII 数字正则限制输入。

调用方应区分输入不合法与运行环境不支持，向用户显示适合的错误信息。实际服务还可按字段容量限制输入长度，不要让任意长文本进入编号处理。

接入旧系统时看哪些地方

先确认 Web 服务与后台任务实际使用的 PHP 版本，不要只根据开发机判断。数据库字段、序列化和前端展示也应保留字符串；如果中间环节转换成数值，函数本身正确也无法恢复被删掉的零。

能用它保证编号唯一吗？不能。两个并发请求可能读取同一个旧值并计算同一个新值，唯一性需要独立的事务或分配机制，本文不展开序列服务设计。

科学计数法文本会按数值递增吗？不要这样使用。字母数字文本应按字符串规则理解，不是数值表达式。

PHP 8.2 怎么办？此函数不可用时，应明确运行时要求或单独评估兼容实现，不把整数加一当作无差别替代方案。接口范围见PHP 官方手册。