如果你想写出健壮、可维护的现代 PHP 代码,绕不开PHP 类型系统这个话题。从 PHP 7 引入标量类型与返回值类型,到 PHP 8.x 带来联合类型、mixed、never 以及交叉类型,PHP 的类型声明能力在近十年间持续演进。理清这条版本脉络,你不仅能让代码在编译期就暴露大部分低级错误,还能在版本升级时快速判断哪些写法可以安全落地、哪些需要改造。本文按版本梳理 PHP 类型系统的关键能力,并给出实战中的最佳写法与避坑要点。
为什么需要类型声明
PHP 是一门动态弱类型语言,变量本身没有类型,值才有类型。这种灵活性在项目初期很高效,但随着代码规模增长,参数被误传、返回值被错误假设的问题会越来越多。类型声明的本质,是在函数与方法的边界上增加一层运行期契约:调用方必须传入符合声明的值,被调用方必须返回符合声明的结果。
它带来三个直接好处:一是 IDE 与静态分析工具(如 PHPStan、Psalm)能据此做更准确的推断;二是错误从"线上偶发的诡异结果"提前到"调用现场立即抛出的 TypeError";三是类型本身成为最好的文档,读签名就知道怎么用。
标量类型与严格模式
PHP 7.0 起,参数与返回值可以声明 int、float、string、bool 四种标量类型。默认情形下 PHP 会做隐式类型转换——传 "123" 给 int 参数会被自动转成整数。这种宽容在跨类型调用时容易埋雷,因此强烈建议开启严格模式。
<?php
declare(strict_types=1);
function add(int $a, int $b): int {
return $a + $b;
}
echo add(2, 3); // 输出 5
echo add("2", "3"); // TypeError: 严格模式下不做隐式转换
declare(strict_types=1) 只影响当前文件内的函数调用,且必须写在文件最顶部。它约束的是"从本文件发出的调用",而不是"被本文件定义的函数"——理解这一点能避免很多关于严格模式"不生效"的误解。联合类型:一个参数多种可能
PHP 8.0 是本轮类型系统升级的分水岭,最重要的特性就是联合类型。它允许一个参数或返回值接受多种类型,用竖线 | 分隔,取代了过去靠 PHPDoc 注释表达、运行期却无法校验的写法。
<?php
// 参数可以是 int 或 string
function normalizeId(int|string $id): string {
return (string) $id;
}
// 接受字符串或任何实现了 __toString() 的对象
function render(string|\Stringable $content): void {
echo $content;
}
// 联合类型同样可用于属性
class Config {
public int|string|null $port = null;
}
联合类型有两条实用规则:?T 是 T|null 的语法糖,二者等价;false 可以参与联合(如历史 API 常返回 string|false),但 true 在 PHP 8.2 之前不能单独作为联合成员。
特殊类型:mixed、never 与 void
PHP 8.0 同时引入了 mixed,它等价于 object|resource|array|string|int|float|bool|null 的联合,表示"任意类型"。由于它几乎不做约束,只在确实无法收窄类型时才使用。PHP 8.1 新增 never,用于标注"永远不会正常返回"的函数——要么抛异常,要么 exit。
<?php
function dumpValue(mixed $value): void {
var_dump($value);
}
function abort(string $message): never {
throw new RuntimeException($message);
// 或 exit($message); —— 两者都不会返回到调用点
}
function redirect(string $url): never {
header("Location: {$url}");
exit;
}
void 与 never 的区别常被混淆:void 表示函数会正常返回,只是没有返回值;never 表示函数根本不会返回。静态分析器可以利用 never 做控制流收敛,例如调用 abort() 之后的代码会被判定为不可达。
交叉类型与 DNF 类型
PHP 8.1 支持交叉类型(用 & 连接),要求一个值同时满足多个类型,常用于"实现了多个接口"的约束。PHP 8.2 进一步支持 DNF(析取范式)类型,允许把联合与交叉用括号组合,表达更精确的契约。
<?php
interface Exportable { public function export(): string; }
interface Cacheable { public function key(): string; }
// PHP 8.1+:必须同时实现两个接口
function save(Exportable&Cacheable $item): void {
$key = $item->key();
file_put_contents($key, $item->export());
}
// PHP 8.2+:DNF —— 要么同时满足 A 和 B,要么满足 C
function handle((Exportable&Cacheable)|string $input): void {
// ...
}
各版本类型能力速查
| 版本 | 类型系统关键特性 |
|---|---|
| PHP 7.0 | 标量类型声明、返回值类型、?-T 可空类型 |
| PHP 7.1 | void、iterable、可空类型简写 ?T |
| PHP 7.2 | object 类型 |
| PHP 8.0 | 联合类型、mixed、static 返回类型 |
| PHP 8.1 | never、交叉类型、纯交集类型 |
| PHP 8.2 | DNF 类型、true/false/null 独立类型 |
实战避坑要点
- 渐进式改造:老项目不必一次性补全所有类型。优先给公共函数、服务层方法加声明,收益最大。
- 注意协变与逆变:子类重写方法时,参数类型可以更宽(逆变),返回类型可以更窄(协变),但违反规则会直接报致命错误。
- 别滥用 mixed:能用联合类型精确表达的,就不要图省事写
mixed,否则等于放弃了类型检查。 - 联合类型去重:
A|A会被合并为A,?T|null也不能重复写null,否则编译期报错。
总结
PHP 类型系统的演进主线非常清晰:从 PHP 7 的"能声明基本类型",到 PHP 8.x 的"能精确描述复杂契约"。类型声明不是束缚,而是把大量本该在运行时发现的问题提前到编码阶段。建议在新项目中默认开启严格模式,并优先使用联合类型、never 等新特性表达真实意图。类型写得越清楚,重构就越有底气。