PHP 8.5 非规范类型转换名为什么出现弃用提示

PHP 8.5 出现“非规范类型转换名已弃用”提示时，通常不是转换结果突然改变，而是代码仍在使用历史别名。把 (boolean)、(integer)、(double)、(binary) 分别改成 (bool)、(int)、(float)、(string)，即可沿着 PHP 当前推荐的类型名称迁移。官方迁移说明入口：https://www.php.net/manual/en/migration85.php。

这类提示的重点是“规范化名称”，不是让你重新设计类型系统。PHP 官方文档把这些旧名称视为仍能表达转换意图、但不再采用的别名；迁移时应先确认实际写法，再做小范围替换和回归。

先确认提示对应哪四种转换名

本次迁移最容易混淆的是“旧名称仍然能读懂”与“它已经是推荐写法”之间的差别。对应关系可以先记成一张表：

因此，提示来自括号里的类型名称时，可以先在代码库中搜索这四个完整单词。不要把 (real) 当成 PHP 8.5 才出现的同一项：官方类型转换文档说明它早在 PHP 7.4 已弃用，并在 PHP 8.0 移除。(unset) 也有更早的生命周期，不能和本次四个名称混在一轮替换里。

把转换表达式改成规范短名称

括号转换只需要替换类型名，变量、表达式和转换位置保持不变。例如下面的改法适合先做机械迁移：

迁移前的四个表达式如果分别使用了旧别名，替换后仍然是对应的布尔、整数、浮点和字符串转换。需要注意的是，规范名称不会自动改变字符串转数字时的输入规则；例如空字符串、带小数点的文本和超出整数范围的值，仍应按项目自己的输入约束处理。

如果项目支持多个 PHP 版本，规范短名称本身是更稳妥的共同写法。先改表达式，再运行项目已有的静态检查和测试；不要为了消除提示而顺手改变默认值、输入清洗或错误处理。

检查 settype 与类型声明中的连带写法

搜索范围不能只盯着括号。PHP 8.5 的弃用说明还涉及 settype() 使用的非规范类型字符串，因此旧项目可能同时存在下面这种写法：

这里的 'int' 是传给 settype() 的字符串，不是括号转换；但它表达的是同一个规范类型概念。类型声明中的 int、bool、float 和 string 本来就是规范名称，不应被替换成历史别名。

批量替换时建议把“括号里的旧名称”和“字符串参数里的旧名称”分成两轮处理。这样更容易审查误匹配，也不会把业务文案、数据库字段名或第三方协议中的固定字符串误改。

用兼容清单完成代码库迁移

为了避免升级后只修复了第一处提示，可以按以下顺序处理：

1. 搜索：查找 (boolean)、(integer)、(double)、(binary)，再单独搜索 settype( 附近的类型字符串。
2. 替换：只把明确表示类型的旧名称改成 bool、int、float、string，保留变量和表达式。
3. 检查：查看差异，重点排除注释、文案、协议字段和第三方生成文件的误改。
4. 回归：覆盖真假值、数字字符串、空值、浮点输入和异常分支，验证业务约束而不只是提示消失。
5. 发布：先在 PHP 8.5 的非生产环境观察弃用日志，再安排正式切换。

可以把迁移结果理解为“名称收敛”，不是“行为扩展”：规范写法让读者和工具都能直接识别目标类型，但它不会替你决定输入是否合法，也不会替你修复隐式转换带来的业务风险。

两个容易混淆的问题

改成短名称后，转换结果会变吗？ 对这四个别名而言，迁移目标是对应的规范类型名称；但输入值如何被转换仍受 PHP 类型转换规则影响，所以仍应保留项目原有的边界测试。

(binary) 能不能继续保留？ PHP 文档说明它与 (string) 当前相同，但它属于非规范名称并已弃用。除非项目有非常明确的兼容层约束，否则新代码使用 (string) 更清楚；二进制数据的编码和协议语义仍应由业务代码单独说明。

归纳起来，PHP 8.5 的弃用提示是在提醒代码库统一术语：四种括号转换名改用规范短名称，同时检查 settype() 的类型字符串，最后用输入边界回归确认迁移没有掩盖原有问题。