PHP8.1怎样调用联合类型函数_PHP8.1联合类型调用详解【实战】-php教程-PHP中文网

php 8.1联合类型是硬校验机制：参数必须严格匹配声明类型（如int|string），无隐式转换，传错即fatal error；返回值每条路径须覆盖所有声明类型，null需显式写为...|null，属性联合类型仅8.1+支持且默认值须手动初始化。

php8.1怎样调用联合类型函数_php8.1联合类型调用详解【实战】

PHP 8.1 中联合类型函数不是“调用方式”变了，而是你必须按声明的类型传参、处理返回值——否则直接报 Fatal error，没有商量余地。

联合类型在参数位置是「硬校验」：调用时传入的值必须严格属于声明中的某一个类型，PHP 不做隐式转换，也不 fallback。

写 function parse(int|string $id) { }，传 "123" 或 42 都合法；传 123.5、[]、null 都会触发 Fatal error: Uncaught TypeError
即使 strict_types=0，也不会把 "42" 自动转成 int —— 联合类型绕过了传统弱类型容错机制
传 false 给 int|string 参数？不行。哪怕你心里觉得它“逻辑上等价于 0”，PHP 仍判为类型错误

函数体里每条可能的 return 路径，都得产出声明中列出的类型之一；漏掉任意一种，静态分析（如 PHPStan）会警告，运行时若真走到那条路径，就 Fatal error。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

声明 function getId(): int|string，就不能有 return null; 或 return [];
常见陷阱：从数据库取字段 $row['id']，它可能是 string、int、null，甚至 false（PDO fetch 失败）。你必须先收口：return $row['id'] === null ? 'unknown' : $row['id'];
如果真需要 null，就得改声明为 int|string|null（PHP 8.1+ 支持），但注意：这不是可空语法糖，?int|string 是非法的，必须写全

VS Code + Intelephense 或 PHPStan 能基于联合类型推导变量类型，但前提是你的声明和实际逻辑一致。一旦出现「声明说能返回 string|int，但某分支 return 了 float」，工具会立刻标红，而运行时只等你调到那条路径才炸。

别指望 IDE 补全能“智能适配”联合类型——它只会按当前上下文最窄类型提示。比如变量被赋值为 "abc"，就算它属于 int|string，补全也只显示字符串方法
用 match 处理联合返回值最安全：match (getId()) { int => 'number', string => 'text', }; —— 缺少 null 分支且声明含 null，PHPStan 就会报错
不要在联合类型函数里混用 @param int|string $x 注解——PHP 8.1 原生类型已足够，重复注解会让 PHPStan 提示 redundant PHPDoc

类属性上写 public int|string $id; 在 PHP 8.0 会直接 Parse error；升级到 8.1 后，它才生效，但构造后首次赋值前，属性是未定义状态，不能当 null 用。

想让它能存 null，必须显式声明 public int|string|null $id = null; —— 省略 = null 不代表默认为 null，而是未初始化，访问会触发 Notice: Undefined property
构造函数里没给联合类型属性赋值？没问题；但第一次读取前必须赋值，否则运行时报错
框架（如 Laravel）若自动填充模型属性，需确认其反射逻辑支持 PHP 8.1 属性类型，否则可能跳过类型校验，埋下隐患

真正容易被忽略的点：联合类型不改变函数内部行为，它只校验输入输出边界。你依然得自己处理 is_numeric()、filter_var()、空字符串转义这些事——类型系统不会替你做业务逻辑判断。