04.3 阶段 2:类型系统与现代特性
本页目录
一、阶段定位
阶段 1 解决"代码写得对、结构清晰"。本阶段解决"用 PHP 8.x 的现代写法,让类型系统替你兜底"。PHP 从 7.0 加标量类型声明、7.4 加类型化属性、8.0 加命名参数与 match、8.1 加 readonly、8.2 加只读类和 Dnf 类型,目标都是同一个:把"运行时才暴露的弱类型 bug"提前到写代码时暴露。
与前后阶段的衔接:往上是 04.2 阶段 1 语言核心,本阶段所有类型声明都落在阶段 1 的函数、类、闭包之上;往下接 04.4 阶段 3 Composer、PSR 与工程化,那里会引入 PHPStan 静态分析——如果本阶段没把类型写满,静态分析连基础级别都过不了。跳过本阶段直接学 Laravel,会在"为什么框架方法参数全是类型""$request->validate() 返回什么""Eloquent 模型属性怎么标注类型"这些问题上反复查文档。
原始卡点展开成可判断的现象依据:
==与===混用导致判断错误:判断标准是if ($user == 0)在用户 ID 是字符串"0e123"时走进错误分支;或==把字符串"123abc"与数字123判为相等。- nullable 与
?Type理解不到位:判断标准是函数参数声明?int $id,调用方传了字符串"1",在非严格模式下被静默转成1,在严格模式下直接TypeError。 - 把 readonly 当不可变对象:判断标准是以为
readonly class Order之后整个对象不能改,实际上 readonly 只约束"属性初始化后不能再次赋值",对象内部数组元素仍可改。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能为函数参数、返回值、类属性写完整类型声明 | php -l 通过;PHPStan level 5 无类型错误 |
能解释 declare(strict_types=1) 放在哪个文件、对谁生效 |
写出严格模式与非严格模式两段代码对比 |
| 能用联合类型、nullable、mixed、never 表达"参数可能是多种类型" | 代码里不再出现裸 $x 不带类型 |
| 能用命名参数、构造器属性提升简化构造函数 | 构造函数从 10 行缩到 1 行 |
| 能用 match 替代 switch,能定义 backed enum 与纯枚举 | match 对未匹配值抛 UnhandledMatchError |
能写出 Generator 并理解惰性迭代,能列举至少 5 个 == 与 === 行为不同的场景 |
手写对比表格 |
建议学时:
- 全职(每天 4–6 小时):1.5 周,约 40 小时。
- 在职(每天 2 小时、周末补 3 小时):3 周,约 40 小时。
学时分配:类型声明与严格模式 25%、联合类型与 readonly 15%、命名参数与属性提升 10%、match 与 Enum 20%、Generator 与 Fiber 15%、弱类型比较陷阱 15%。严格模式与 == 行为差异是面试高频,时间要给够。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| 函数与类 | 能定义函数、构造函数、方法 | 04.2 阶段 1 语言核心 |
| Error 与 Exception | 知道 TypeError 是 Error 子类 |
04.2 阶段 1 语言核心 |
| 数组 | 能用 Generator 之前先熟练数组遍历 | 04.2 阶段 1 语言核心 |
| PHP 版本 | 本机 PHP 至少 8.1 | 04.1 阶段 0 环境与工程基础 |
经验判断:写过 PHP 5/7 的人最容易犯的错是"类型声明写了但不严格",导致 declare(strict_types=1) 加不加都一样;写过 Java/Go 的人最容易把 readonly 当 final,把枚举当常量类。
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 标量类型 | int/float/string/bool/array/object/callable/iterable 参数与返回类型 |
能讲清原理 | 04.5 PHP |
| 严格模式 | declare(strict_types=1) 的作用范围、调用方生效规则 |
能讲清原理 | 04.5 PHP |
| 联合类型与 nullable | int\|string、?int、mixed、never、static 返回类型 |
会用 | 04.5 PHP |
| 命名参数与属性提升 | function(name: $x)、public function __construct(public int $id) |
会用 | 04.5 PHP |
| match 与 Enum | match 严格比较、UnhandledMatchError、enum Status: string、BackedEnum |
能讲清原理 | 04.5 PHP |
| readonly | readonly 属性(8.1)、readonly 类(8.2)、不可变与只读属性的边界 | 会用 | 04.5 PHP |
| Generator | yield、yield from、惰性迭代、内存占用对比 |
能讲清原理 | 04.5 PHP |
| Fiber 与弱类型 | Fiber 挂起恢复、== 与 === 隐式转换规则、str_contains 系列 |
了解 | 04.5 PHP |
进度管理建议:严格模式作用范围与 == 行为差异能口述清楚再进阶段 3。全量清单见 04.10 知识点全清单。
五、分模块精讲
5.1 标量类型声明与返回类型
为什么需要它:PHP 7 之前函数参数与返回值无类型,传错类型只能运行时炸。类型声明让错误在"传参那一刻"就暴露,而不是在"用值时"才暴露。
核心机制:
- 参数类型:
int、float、string、bool、array、object、callable、iterable、self、?Type(nullable)、类名、接口名。 - 返回类型:在参数列表后加
: int;无返回用: void;可空返回: ?string。 - 类型声明分两种模式:强制模式(默认,自动转换标量类型)与严格模式(
declare(strict_types=1),不做转换)。 - 内部函数(PHP 内置函数)始终按严格模式处理,不受调用方文件声明影响。
最小可运行示例:
<?php
// 强制模式(默认):字符串 "123" 会被自动转成 int
function add(int $a, int $b): int {
return $a + $b;
}
echo add("1", "2"); // 3,强制模式下字符串转 int
// 类属性类型(PHP 7.4+)
class User {
public int $id;
public ?string $email = null; // nullable 可空属性
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
Fatal error: Uncaught TypeError: add(): Argument #1 must be of type int, string given |
严格模式下传了字符串 | 调用方显式 (int) 转换,或改参数类型为 int\|string |
| 属性未赋值就用 | 类型化属性未初始化 | 在声明处给默认值,或构造函数里赋值 |
void 函数里 return $x |
void 不允许返回值 | 改成 return; 或改返回类型 |
面试考法:"PHP 类型声明是编译期检查还是运行期检查"。答到:是运行期检查,PHP 解释执行,类型声明在调用时验证;这与 Java 编译期检查不同。
5.2 严格模式 declare(strict_types=1)
为什么需要它:默认强制模式会把 "123" 自动转成 123,看似方便,实际掩盖了"调用方传错类型"的 bug。严格模式让类型不匹配直接抛 TypeError。
核心机制:
declare(strict_types=1);必须放在文件第一行(declare 语句之前不能有任何代码,只能有 declare 与注释)。- 严格模式只对调用方文件生效:哪个文件调用函数,就按哪个文件的声明决定是否严格。函数定义所在文件的 declare 不影响调用方。
- 严格模式只影响标量类型(int/float/string/bool);类、数组、可调用类型本来就不做自动转换。
- 严格模式对返回类型也生效:函数返回值类型不匹配同样抛
TypeError。
最小可运行示例:
<?php
// define.php:函数定义文件,不写 strict_types
function square(int $n): int { return $n * $n; }
<?php
// caller_strict.php:调用方写严格模式
declare(strict_types=1);
require 'define.php';
echo square("5"); // TypeError:调用方是严格模式,不接受 string
<?php
// caller_normal.php:调用方不写严格模式
require 'define.php';
echo square("5"); // 25:强制模式,字符串转 int
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
加了 declare(strict_types=1) 仍不生效 |
放在了非第一行 | 移到文件首行(紧跟 <?php) |
| 严格模式对内部函数仍按强制模式 | 内部函数始终严格 | 这是预期行为 |
| 类方法严格与否取决于调用方文件 | 严格模式按调用方文件 | 整个项目统一开启 strict_types |
面试考法:"declare(strict_types=1) 放在函数定义文件还是调用文件"。答到:调用方文件,决定从该文件发出的调用是否严格;函数定义文件的声明不影响外部调用。这是 PHP 面试高频陷阱。
5.3 联合类型、nullable、mixed 与 never
为什么需要它:业务里"参数可能是 int 也可能是 string"非常常见(如订单 ID 可能是数字也可能是哈希串)。联合类型让这种情况显式化,而不是靠 mixed 糊弄。
核心机制:
- 联合类型
int|string:参数或返回值可以是其中任一类型(PHP 8.0+)。 ?int是int|null的简写。mixed等价于array|bool|callable|int|float|object|resource|string|null,表示"什么都可能",不要滥用。never返回类型(PHP 8.1+):函数永不返回,通常用于exit、throw、死循环;never与void的区别是 never 保证不返回到调用方。static返回类型:表示返回$this所在类的实际对象(后期静态绑定)。
最小可运行示例:
<?php
function findUser(int|string $id): ?array {
if (is_int($id) && $id <= 0) {
return null;
}
return ['id' => $id];
}
function abort(int $code, string $msg): never {
http_response_code($code);
echo $msg;
exit; // never:必须终止脚本
}
class Repository {
public function find(int $id): static {
// 返回当前调用类的实例,而非父类
return new static();
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
mixed 写满全项目 |
用联合类型更精确 | 把 mixed 替换为具体联合类型 |
never 函数里最后忘了 exit |
函数实际返回了 | 末尾必须 throw 或 exit |
?Type 传 null 报 TypeError |
没加 ? |
参数改为 ?Type |
面试考法:"void 与 never 区别""mixed 该不该用"。答到:void 是"没有有意义的返回值"(但会返回),never 是"永不返回到调用方";mixed 是类型放弃,业务代码应尽量用联合类型替代。
5.4 命名参数与构造器属性提升
为什么需要它:PHP 7 时代调用函数必须按位置传参,参数一多就变成 func(1, 'a', true, null, 'x'),可读性极差。命名参数让调用自解释。
核心机制:
- 命名参数:
setCookie(name: 'session', value: 'abc', httponly: true);,可跳过可选参数,顺序无关。 - 构造器属性提升(PHP 8.0+):
__construct(public int $id, public string $name)一行同时完成"声明属性 + 赋值",等价于手写$this->id = $id;。 - 命名参数与属性提升配合 Laravel/Symfony 的服务容器,构造函数一行写完。
最小可运行示例:
<?php
class User {
// 构造器属性提升:一行完成属性声明与赋值
public function __construct(
public readonly int $id,
public string $name,
public ?string $email = null,
) {}
}
// 命名参数:跳过中间可选参数
$u = new User(id: 1, name: 'Ann', email: 'ann@example.com');
$u2 = new User(id: 2, name: 'Bob'); // email 用默认值
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 命名参数名拼错 | 与函数定义不一致 | 看函数签名,IDE 自动补全 |
属性提升里写 private 不生效 |
提升属性必须显式可见性 | 写 public/private/protected |
| 提升属性与类型不兼容 | 类型不匹配 | 类型与构造参数类型一致 |
面试考法:"构造器属性提升省了什么"。答到:省了"声明属性 + 构造函数里赋值"两步,让类定义一眼看清数据结构;它不改变运行时行为。
5.5 match 表达式与枚举 Enum
为什么需要它:switch 松散比较、不写 break 会穿透、不能当表达式赋值。match 严格比较、无穿透、必须穷尽匹配,是现代 PHP 分支逻辑的首选。
核心机制:
match是表达式,可直接赋值:$label = match($status) { 1 => '待支付', 2 => '已发货', default => '未知' };。match用严格比较(===),不像switch松散比较。- 未匹配且无
default时抛Uncaught UnhandledMatchError。 - 每个分支只执行一条,不会穿透(不需要 break)。
- Enum(PHP 8.1+):
enum Status: string { case Pending = 'P'; case Paid = 'D'; };backed enum 有标量值,纯枚举没有值;枚举可带方法。
最小可运行示例:
<?php
enum Status: string {
case Pending = 'P';
case Paid = 'D';
case Shipped = 'S';
public function label(): string {
return match($this) {
self::Pending => '待支付',
self::Paid => '已支付',
self::Shipped => '已发货',
};
}
}
$status = Status::Paid;
echo $status->label(); // 已支付
echo $status->value; // D
echo Status::from('P')->name; // Pending
// Status::from('X') 抛 ValueError;Status::tryFrom('X') 返回 null
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
UnhandledMatchError |
match 未覆盖所有分支且无 default | 加 default 或枚举穷尽 |
switch 松散比较走错分支 |
switch 用 == |
改 match(严格 ===) |
Enum::from('X') 抛 ValueError |
值不在枚举里 | 用 tryFrom 返回 null |
面试考法:"match 与 switch 区别""枚举是类还是对象"。答到:match 严格比较、无穿透、是表达式;枚举是类型,case 是单例对象,可带方法、可接口实现。
5.6 readonly 属性与不可变数据
为什么需要它:DTO(数据传输对象)、值对象初始化后不应再被改。PHP 8.1 的 readonly 属性让"初始化后只读"由类型系统保证,而不是靠约定。
核心机制:
- readonly 属性:
public readonly string $email;,只能在声明处或构造函数里赋值一次,再次赋值抛Error。 - readonly 不能带默认值(除非 PHP 8.3+);必须是类型化属性。
- readonly 类(PHP 8.2+):
readonly class User表示该类所有属性都是 readonly,省得逐个写。 - readonly 不等于不可变对象:readonly 约束"属性不能重新赋值",但如果属性是数组或对象,其内部内容仍可改(
$user->profile['age'] = 30;合法)。
最小可运行示例:
<?php
class Order {
public function __construct(
public readonly int $id,
public readonly float $amount,
public readonly array $items,
) {}
}
$o = new Order(1, 99.5, ['book']);
// $o->amount = 100; // Error:Cannot modify readonly property
$o->items[] = 'pen'; // 合法!readonly 不约束数组内部
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
Cannot modify readonly property |
对 readonly 属性二次赋值 | 重新 new 一个新对象,或去掉 readonly |
| 以为 readonly 对象完全不可变 | 数组/对象内部仍可改 | 需要深不可变就用不可变集合或克隆 |
| readonly 属性无默认值 | PHP 8.1 限制 | 8.3+ 才支持默认值 |
面试考法:"readonly 与 final 区别""readonly 能约束数组吗"。答到:final 约束类不能被继承,readonly 约束属性不能重新赋值;readonly 不能约束数组/对象内部,这是常见误解。
5.7 Generator 生成器与 yield
为什么需要它:处理 100 万行 CSV,一次性 file() 读进内存会 OOM。Generator 边读边产出,内存占用恒定,是处理大文件、大数据集的标准手段。
核心机制:
- 函数里用
yield而不是return,函数返回一个Generator对象,本身不执行。 - 遍历 Generator 时(
foreach),每次执行到yield暂停,把值交给循环,下次继续。 yield from委托给另一个 Generator 或可遍历对象。- Generator 只能前进,不能倒带;不能
count()。
最小可运行示例:
<?php
function readCsv(string $path): Generator {
$handle = fopen($path, 'r');
while (($row = fgetcsv($handle)) !== false) {
yield $row; // 每读一行就交出一行,不一次性占内存
}
fclose($handle);
}
$total = 0;
foreach (readCsv('big.csv') as $i => $row) {
if ($i === 0) continue; // 跳过表头
$total += (float) $row[2];
if ($i % 10000 === 0) {
echo "已处理 $i 行,内存:" . memory_get_usage(true) / 1024 / 1024 . " MB\n";
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
Generator 函数里 return 拿不到值 |
yield 函数返回 Generator 对象 | 用 $gen->getReturn() 取最终 return 值 |
count(readCsv(...)) 报错 |
Generator 不可 count | 自己循环计数 |
一次性 file() 读大文件 OOM |
全量进内存 | 改 Generator 逐行读 |
面试考法:"Generator 与数组区别""为什么省内存"。答到:数组一次性分配全部元素;Generator 每次只保留一个元素在内存,遍历完即释放;代价是只能前进、不可回退。
5.8 Fiber 与弱类型比较陷阱
为什么需要它:PHP 8 引入 Fiber 是协程的底层抽象(阶段 6 常驻模型会用到);而 == 与 === 的行为差异是 PHP 历史包袱,面试必考。
核心机制:
- Fiber(PHP 8.1+):用户态轻量级执行流,可在任意位置
suspend()挂起、resume()恢复;它是 Swoole/Hyperf 协程的底层基础。 - 弱类型比较
==的关键规则(PHP 8 起):- 两个字符串都是数值字符串(纯数字、科学计数法如
"0e123")时按数字比较; - 否则按字符串比较;
- 数字与字符串比较时,字符串必须是数值字符串才转数字,否则数字转字符串比较。
- 两个字符串都是数值字符串(纯数字、科学计数法如
- 典型差异:
0 == "abc":PHP 8 前 true,PHP 8 后 false;100 == "100abc":PHP 8 前 true,PHP 8 后 false;"0e123" == "0e456":都是数值字符串,都等于 0,返回 true(MD5 碰撞经典);null == false、"" == false、0 == false、null == 0:均为 true;1 == true、-1 == true:均为 true。
最小可运行示例:
<?php
// 用 === 避免所有歧义
var_dump(0 == "abc"); // bool(false)(PHP 8+)
var_dump(100 == "100abc"); // bool(false)
var_dump("0e123" == "0e456"); // bool(true):都是科学计数法数值字符串
var_dump(0 == false); // bool(true)
var_dump(null == ""); // bool(true)
var_dump(0 === false); // bool(false)
var_dump("0e123" === "0e456"); // bool(false):严格比较字符串
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
== 比较 MD5 散列误判相等 |
"0e..." 形式被当数字 |
用 === 或 hash_equals |
if ($user == 0) 走进错误分支 |
弱比较把字符串当数字 | 业务比较一律 === |
| Fiber suspend 后状态丢失 | 不理解协程上下文 | 阶段 6 详讲,本阶段先知道有 Fiber |
面试考法:"== 与 === 区别""PHP 8 改了什么"。答到:PHP 8 把"非数值字符串与数字比较"从"字符串转数字"改为"数字转字符串",堵住了 0 == "abc" 这类历史 bug;但仍建议业务代码一律 ===。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 严格模式对比 | 写 define + caller 两文件,演示 strict_types 作用 | 同一函数在两种模式下行为不同 | 1 小时 |
| match 穷尽性 | 故意不写 default 触发 UnhandledMatchError | 复现后加 default 修复 | 0.5 小时 |
| Enum 带方法 | 给订单状态枚举写 label() | 三个 case 都能输出中文标签 | 1 小时 |
| Generator 读大文件 | 生成 10 万行 CSV 用 Generator 统计 | 内存占用不随行数增长 | 1.5 小时 |
== 对比表 |
手写 8 个 == 与 === 不同的场景 |
表格与实际运行结果一致 | 1 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 给阶段 1 工具加类型 | 把 CSV 统计工具的函数全部加类型 | strict_types 下无 TypeError | 2 小时 |
| 用 match 替代 switch | 把一个状态分发逻辑从 switch 改成 match | 行为一致,代码更短 | 1 小时 |
| 用枚举替代常量类 | 把 Status::PENDING 常量改为 enum |
调用方迁移,from/tryFrom 正确 |
2 小时 |
| 用 readonly 重写 DTO | 订单 DTO 改为 readonly 属性 | 二次赋值报错能理解 | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 配置值对象 | 设计 DatabaseConfig(host/port/user/pass),readonly 不可变 | 修改配置必须 new 新对象 | 2 小时 |
| 迭代器库 | 用 Generator 实现 take/drop/filter/compose | 链式处理内存恒定 | 3 小时 |
| 严格模式规范 | 写一份项目级"类型声明与 strict_types"约定 | 团队 review 无歧义 | 2 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
TypeError: Argument #1 must be of type int, string given |
严格模式下传错类型 | 看调用方文件是否有 strict_types | 调用方显式转换,或参数改联合类型 |
declare(strict_types=1) 不生效 |
不在文件首行 | 看它前面是否有输出/代码 | 移到 <?php 后第一行 |
UnhandledMatchError |
match 未穷尽 | 看传入值与分支 | 加 default 或补分支 |
Cannot modify readonly property |
二次赋值 readonly 属性 | 看属性是否 readonly | 新建对象,或改可变 |
0 == "abc" 行为与预期不符 |
PHP 8 改了弱比较规则 | 打印实际值 | 业务一律 === |
| Generator 内存不下降 | 外层数组持有全部结果 | 检查是否 iterator_to_array |
边遍历边处理,不落数组 |
Enum::from('X') 抛 ValueError |
值不在枚举里 | 看 value 与枚举 case | 用 tryFrom 返回 null |
mixed 写满项目 |
类型放弃 | 用静态分析看 | 替换为具体联合类型 |
八、出口条件
全部勾选后进入 04.4 阶段 3 Composer、PSR 与工程化。
- [ ] 能为函数、返回值、类属性写完整类型声明,strict_types 下无 TypeError
- [ ] 能口述
declare(strict_types=1)放在调用方文件、只影响标量类型 - [ ] 能用联合类型、nullable、never、readonly 表达业务数据结构
- [ ] 能用 match 替代 switch,能定义 backed enum 并带方法
- [ ] 能写出 Generator 处理大文件,内存占用恒定
- [ ] 能列举至少 5 个
==与===行为不同的场景 - [ ] 排障表随机抽三个现象,5 分钟内给出排查路径
自测题:
declare(strict_types=1)放在函数定义文件还是调用文件?- 要点:调用方文件;决定从该文件发出的调用是否严格;函数定义文件的声明不影响外部。
void与never区别?- 要点:void 是"无有意义返回值"但仍返回;never 是永不返回到调用方(exit/throw/死循环)。
match与switch三个关键区别?- 要点:严格比较
===、无穿透、未匹配抛UnhandledMatchError、是表达式可赋值。
- 要点:严格比较
- readonly 能约束数组内部修改吗?
- 要点:不能。readonly 只约束属性不被重新赋值,数组/对象内部仍可改;要深不可变得另想办法。
- Generator 为什么省内存?
- 要点:每次只保留当前 yield 的元素在内存,遍历完即释放;代价是只能前进不可回退。
- PHP 8 里
0 == "abc"是 true 还是 false?为什么?- 要点:false。PHP 8 把非数值字符串与数字比较从"字符串转数字"改为"数字转字符串","0" != "abc"。
"0e123" == "0e456"为什么是 true?- 要点:两者都是科学计数法形式的数值字符串,按数字比较都等于 0;MD5 碰撞常利用这一点,应用
===。
- 要点:两者都是科学计数法形式的数值字符串,按数字比较都等于 0;MD5 碰撞常利用这一点,应用