PHPStan 新增检测隐式可空原生类型的规则

PHP 8.4 版本将引入一个重要的类型系统变更，这个变更会影响函数参数中默认值为 null 的类型声明方式。PHPStan 作为静态分析工具，已经及时跟进这一变化，添加了相应的检测规则。

背景：隐式可空类型的废弃

在 PHP 8.4 之前，开发者可以通过两种方式声明一个可空的参数类型：

// 显式可空类型
function foo(?int $a): void

// 隐式可空类型（通过默认值）
function foo(int $a = null): void

根据最新的技术规范讨论，第二种隐式可空的声明方式将在 PHP 8.4 中被废弃，并会产生以下警告信息：

Deprecated: foo(): Implicitly marking parameter $a as nullable is deprecated, the explicit nullable type must be used instead

PHPStan 的应对方案

PHPStan 开发团队已经实现了对这一变更的检测支持：

1. 新增了一条专门的规则来识别隐式可空类型的用法
2. 该规则默认只在 PHP 8.4 或更高版本环境下生效
3. 当项目的 phpVersion 配置设置为 80400 或更高时，规则会被激活

迁移建议

为了提前适应这一变更，开发者可以：

1. 将项目中所有隐式可空类型声明改为显式语法
2. 在 PHPStan 配置中将 phpVersion 设为 80400 进行预检查
3. 逐步替换类似 int $a = null 的声明为 ?int $a

技术影响分析

这一变更主要影响以下场景：

1. 函数和方法参数声明
2. 接口方法定义
3. 抽象方法定义
4. 闭包参数类型声明

值得注意的是，这一变更只影响原生类型（如 int、string 等），不影响类类型声明。

最佳实践

为了保持代码的前向兼容性，建议开发者：

1. 统一使用显式可空类型语法
2. 在 CI 流程中加入 PHP 8.4 的静态分析检查
3. 避免混合使用两种可空类型声明方式

PHPStan 的这一更新为开发者提供了平滑过渡到 PHP 8.4 的有效工具，帮助团队提前发现并修复潜在的兼容性问题。