PHP8.1函数使用技巧:常见问题解决实测可用-php教程-PHP中文网

php 8.1 加强类型与函数行为约束：array_filter回调须声明bool返回类型，json_decode返回值需判空，curl_setopt超时参数禁用浮点数，array_key_exists等函数第二参数不可为null。

php8.1函数使用技巧:常见问题解决实测可用

PHP 8.1 的函数行为和类型系统比旧版本更严格，很多“能跑通”的写法在 8.1 下会报 TypeError 或静默改变逻辑 —— 尤其是涉及可变参数、联合类型、null 处理和数组函数回调时。

array_filter 回调必须显式声明返回类型，否则可能触发 TypeError

PHP 8.1 启用严格模式后，array_filter 的回调若未声明返回类型（尤其是使用匿名函数时），当返回值实际为 null 或非布尔值，且上下文启用了 declare(strict_types=1)，就会抛出 TypeError。

错误写法：array_filter($data, fn($x) => $x > 5) —— 匿名函数无返回类型声明，在 strict 模式下被当作 void 或隐式 mixed，与 array_filter 内部期望的 bool 不兼容
正确写法：array_filter($data, fn($x): bool => $x > 5)
如果回调逻辑可能返回 null（比如调用了一个可能失败的函数），务必兜底：fn($x): bool => ($x['status'] ?? false) === true
注意：即使不启用 strict_types，PHP 8.1 也会在运行时对回调返回值做更严格的布尔转换校验，""、0、[] 等“falsy”值不再自动等价于 false 用于过滤判定

json_decode 返回类型从 mixed 变为 ?array|?object，需主动处理 null

PHP 8.1 中 json_decode 的返回类型声明更新为 array|object|null（取决于第二个参数），IDE 和静态分析器会据此报错，但更关键的是——你不能再默认它“一定有值”。

btpanel phpsite 宝塔面板PHP网站

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

下载

常见错误：$data = json_decode($json)->items; —— 若 $json 解析失败，json_decode 返回 null，直接访问属性会触发 Fatal error: Uncaught Error: Attempt to read property "items" on null
安全写法：先检查 json_last_error() === JSON_ERROR_NONE，或用空合并：$data = json_decode($json) ?: new stdClass();
如需强类型，配合断言：$arr = json_decode($json, true); assert(is_array($arr));（仅开发环境）
嵌套过深时注意：PHP 8.1 默认最大深度仍是 512，超限后 json_decode 直接返回 null，不会抛异常，容易漏掉这个失败分支

curl_setopt 的超时参数在 PHP 8.1 下对浮点数更敏感

PHP 8.1 对 cURL 的 CURLOPT_TIMEOUT 和 CURLOPT_CONNECTTIMEOUT 参数做了底层校验增强：传入浮点数（如 3.5）不再自动截断，而是直接拒绝并警告 —— 这在旧版本中常被忽略，但 8.1 会明确报 Warning: curl_setopt(): Invalid timeout specified。

必须用整数：curl_setopt($ch, CURLOPT_TIMEOUT, 4)，不能写 4.0 或 (int) 4.2（后者可能因浮点精度问题变成 4 或 3）
如需亚秒级控制，改用 CURLOPT_TIMEOUT_MS（毫秒级），值为 int：curl_setopt($ch, CURLOPT_TIMEOUT_MS, 4500)
CURLOPT_CONNECTTIMEOUT_MS 同理，且它优先级高于 _CONNECTTIMEOUT，两者同时设时以毫秒版为准
注意：FPM 模式下，单个请求总耗时还受 max_execution_time 限制，cURL 超时不能绕过它

函数参数类型升级后，array_key_exists 第二个参数不能是 null

PHP 8.1 中 array_key_exists 的第二个参数类型从 array 升级为 array|ArrayObject，但明确排除了 null。传 null 会直接触发 TypeError，而不再是旧版的 false 返回值。

典型翻车场景：从 API 接收数据后未判空就查键，如 array_key_exists('id', $_POST['user'] ?? null)
修复方式：提前过滤 null：$user = $_POST['user'] ?? []; array_key_exists('id', $user)
更推荐用 nullsafe 操作符（PHP 8.0+）：($_POST['user']?->id) !== null，或直接用 isset($_POST['user']['id'])（语义更清晰）
同理，in_array、array_keys 等函数的第二个参数也已强化类型约束，不能为 null