PHP 8联合类型是ORM中处理空值和多态关系的刚需工具：int|null明确表达数据库NULL语义，User|Admin|Guest声明多态关联但需运行时类型检查，array|false规范查询失败语义，且不改变==隐式转换行为。
PHP 8 的联合类型不是装饰，而是 ORM 映射中处理数据库字段空值和多态关系的刚需工具——它让 NULL 从“靠文档猜”变成运行时可校验的类型成员，也让 User|Admin|Guest 这类关联不再需要手动 cast 或 suppress。
数据库字段映射：用 int|null 替代 ?int 更清晰
ORM 实体中表示可为空的整数字段（如 user.profile_id），直接声明 public int|null $profileId; 比 public ?int $profileId; 更具语义一致性。前者明确表达“这个字段在数据库里允许为 NULL，且 PHP 层必须处理该分支”，后者虽等价，但在联合类型上下文中容易模糊焦点。
-
int|null在属性、参数、返回值中行为统一，IDE 和 PHPStan 能一致推导出非空分支需显式检查 - 若字段实际为
TINYINT(1)存布尔值，但数据库允许 NULL，则bool|null是合法且推荐的声明，避免误用0/1模拟空值 - 注意：MySQL 的
JSON字段映射到 PHP 时，应使用array|string|null，而非mixed—— 后者绕过所有类型检查，而前者强制调用方处理三种可能
多态关联：用 User|Admin|Guest 声明关联属性，但别忘了运行时类型收窄
当一个 Comment 可归属多个模型（如 User、Admin、Guest），传统做法是加 commentable_type 和 commentable_id，并在访问时手动实例化。PHP 8 联合类型允许你把这种多态性“声明出来”：
class Comment
{
public User|Admin|Guest $author;
}
但这只是起点——PHP 不会自动根据 $author::class 推断当前具体类型，所有操作必须兼容三者共有接口或方法。
立即学习“PHP免费学习笔记（深入）”；
- 若
User、Admin、Guest都实现Authenticatable接口，优先声明为Authenticatable，而非联合类型；只有当它们没有公共契约时，才用联合类型 - 调用
$comment->author->name会报错，除非你先做类型判断：if ($comment->author instanceof User) { ... } - 不要在联合类型中混入
null（如User|Admin|null）来表示“未加载关联”——这会让逻辑膨胀；应单独用LazyLoading策略或?User|?Admin|?Guest分开建模
查询构建器返回值：用 array|false 或 object|null 表达失败语义
原生 PDO 或轻量 ORM 查询单条记录时，常返回数组（成功）或 false（失败）。PHP 8 中应避免用 mixed，改用 array|false：
function fetchOne(string $sql): array|false
{
$stmt = $this->pdo->prepare($sql);
$stmt->execute();
return $stmt->fetch(PDO::FETCH_ASSOC) ?: false;
}
这样调用方无法直接解构返回值，必须先判断：
if ($row === false) { throw new RecordNotFoundException(); }- 不推荐用
array|null替代array|false：因为PDO::FETCH_ASSOC返回空数组[]是合法结果，null并不等价于“查询失败” - 若封装为对象（如
Post实例），则返回类型应为Post|null，且构造函数需接受array|null参数并做防御性检查
最容易被忽略的坑：联合类型不参与自动类型提升，== 仍会触发隐式转换
即使你写了 function updateStatus(int|string $id): bool，传入 "123" 仍会通过类型检查（因为 string 是合法成员），但后续若用 $id == 123 做比较，PHP 仍会把字符串转成整数——联合类型不改变运行时行为，只约束输入范围。
- 对 ID 类型敏感的操作（如 SQL 绑定），应在函数体内用
is_int()/is_string()显式收窄，并分别走不同逻辑分支 - 数据库驱动层（如 PDO）不会因 PHP 类型声明而自动选择绑定类型；
bindValue($id, PDO::PARAM_INT)仍需手动指定 - 静态分析工具（如 PHPStan level 8）能捕获
array|false未检查就直接count($result)的错误，但不会拦截==引发的弱比较陷阱——这得靠单元测试覆盖
