PHP 8.5.7 并未引入 array_first 函数,它不是任何 PHP 官方版本的内置函数;实际可用的可靠方案是 array_key_first() 结合键访问,兼顾安全性、兼容性与无副作用。

PHP 8.5.7 并不存在 array_first 函数——它不是 PHP 官方任何版本(包括 8.5.7)的内置函数。所谓“PHP 8.5.7 的 array_first 更可靠”的说法,源于对新旧信息的混淆:部分早期预发布文档或社区误传曾将尚未合并的 RFC 当作已落地功能,而实际上截至 2026 年 6 月,PHP 官方仍未在任何稳定版中引入 array_first() 或 array_last()。
为什么非连续索引数组容易出错?
关键在于 PHP 数组内部指针行为不可靠:
- 函数如
current()依赖当前指针位置,但函数调用、foreach 循环、甚至某些扩展操作都可能移动指针,导致首次调用就返回错误元素 -
reset()虽能重置指针,但它会修改原数组状态,后续若再用each()或继续遍历,逻辑可能意外中断 -
array_key_first() + $arr[$key]组合看似安全,但若数组含null、false或对象引用,且键存在而值为 falsy,易被误判为空
PHP 8.5.7 实际可用的可靠方案
不依赖不存在的函数,而是用已被验证、跨版本稳定的组合:
-
兼顾键值且不改指针:
$first = is_array($arr) && !empty($arr) ? $arr[array_key_first($arr)] : null; -
保留原始键名(需键值):
$key = array_key_first($arr); $first = $key !== null ? $arr[$key] : null; -
空数组安全+类型明确:
$first = (!is_array($arr) || empty($arr)) ? null : reset($arr);(注意 reset 后指针已变)
框架封装 ≠ 原生能力
如果你在项目里看到 array_first() 正常运行,大概率是 Laravel 的 Arr::first() 被自动别名,或是自定义函数:
立即学习“PHP免费学习笔记(深入)”;
- Laravel v10+ 已彻底移除
array_first()别名,仅支持Arr::first() - 该方法支持回调过滤、默认值 fallback,但它是框架层逻辑,与 PHP 版本无关
- 纯 PHP 环境未加载 Illuminate\Support\Arr 就调用,必然报
Call to undefined function array_first()
真正从 PHP 8.5 开始可用的新能力
PHP 8.5 确实新增了更底层的支撑能力,但不是 array_first:
-
array_key_first()和array_key_last()自 PHP 7.3 起已存在,8.5 中行为更稳定,尤其对引用数组和稀疏键处理更一致 -
array_is_list()可快速判断是否为整数索引连续数组,辅助你决定是否能安全用$arr[0] -
array_values($arr)[0] ?? null在小数组中可读性强,但大数据量时触发完整复制,需权衡



















