php 8联合类型不能直接用于db查询返回值自动适配，它仅作静态声明，不干预运行时行为；需手动将底层驱动返回的array|false等映射为声明的array|null等类型，避免false逃逸。
PHP 8联合类型能否直接用于DB查询返回值声明？
不能直接“自动适配”——联合类型是静态类型声明机制，不改变运行时行为。它只告诉 IDE 和类型检查器（如 PHPStan、Psalm）：“这个函数可能返回 array、false 或 null”，但不会帮你把 mysqli_query() 的原始结果转成你想要的结构。
常见错误现象：PHP Fatal error: Uncaught TypeError: Return value must be of type array|false|null —— 这通常是因为你写了返回类型声明，但函数里漏了 return，或提前抛出了异常却没覆盖所有分支。
- 联合类型只校验
return表达式的值，不干预 DB 驱动本身的返回逻辑 -
mysqli_fetch_assoc()返回array|false，但如果你封装成一个方法并声明array|null，就必须显式把false转为null - PDO 默认返回
array|false（取决于PDO::ATTR_DEFAULT_FETCH_MODE），但fetch()方法本身无类型声明，需手动包装
如何为 PDO 查询方法正确声明 array|null|false？
关键在「收口」：把底层驱动的原始返回统一映射到你声明的联合类型。不要让 false 逃逸出方法边界。
public function fetchUser(int $id): array|null
{
$stmt = $this->pdo->prepare('SELECT * FROM users WHERE id = ?');
$stmt->execute([$id]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);
// 必须处理：PDO::FETCH_ASSOC 失败时返回 false，但声明是 array|null
return $row === false ? null : $row;
}
- 别用
array|false声明后直接返回$stmt->fetch()—— 这会让调用方仍要判断false - 如果业务上
false和null含义一致（查无此记录），就统一转成null；若需区分“查询失败”和“记录不存在”，才保留array|false|null -
PDOStatement::fetchAll()返回array或空数组，不会返回false，可安全声明为array
什么时候该用 array|false 而不是 array|null？
仅当你要暴露底层驱动的错误信号，且调用方需要区分“SQL 执行失败”（如语法错、连接断）和“逻辑未命中”（如 WHERE 条件无匹配）。
-
mysqli_query()成功时返回mysqli_result，失败返回false—— 这是原生语义，封装层若透传，类型就得是mysqli_result|false -
mysqli_fetch_array()查无数据时返回null，但执行出错时上层mysqli_query()已经返回false，所以不会走到这步 - 真实项目中，多数情况应屏蔽
false，改抛RuntimeException或自定义异常，返回类型用array|null更干净
联合类型 + PHPStan 检查能发现哪些典型问题？
它能抓到你忘记处理分支的地方，比如声明了 array|null 却直接对返回值调用 count()，而没先判空。
function getUser(): array|null { /* ... */ }
$user = getUser();
echo count($user); // PHPStan 报错：Cannot call function count() on array|null.
- IDE 在你写
$user['name']时会警告：Access to an undefined property array|null - 但如果用了
?? []或is_array()显式保护，类型会收窄，警告消失 - 注意：PHPStan 默认不检查运行时
false，除非你启用了 strict-rules 并把false加入联合类型
联合类型真正起作用的地方，是你开始写 if/else 或 match 表达式做分支处理的时候——它逼你面对“这个变量到底可能是什么”。否则，类型声明只是摆设。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
