### [PHP8.5 数组原生操作规则版本调整记录](https://www.huociguo.com/article/127)

**Published:** 2026-07-12T07:58:20

**Author:** 米了

**Excerpt:** PHP 8.5 于 2025 年 11 月 20 日正式发布，本次版本在数组原生操作层面带来了一项直接面向日常开发的新函数，并对若干相关函数做了性能层面的改进。本文基于 PHP 官方发布公告、RFC 记录与 PHP 手册，整理 PHP 8.

PHP 8.5 于 2025 年 11 月 20 日正式发布，本次版本在数组原生操作层面带来了一项直接面向日常开发的新函数，并对若干相关函数做了性能层面的改进。本文基于 PHP 官方发布公告、RFC 记录与 PHP 手册，整理 PHP 8.5 中与数组原生操作相关的规则变化、向后兼容影响与升级核查要点。

![](https://api.huociguo.com/wp-content/uploads/2026/07/13428316570977489-1207dfe38c-1.png "13428316570977489-1207dfe38c-1")

> 📌 说明：PHP 8.5 并未对数组底层存储结构或排序稳定性等既有规则做出破坏性调整。本文所述”调整”特指该版本新增的数组原生函数及配套行为变化。

## 一、PHP 8.5 数组函数版本全景

下表汇总 PHP 8.5 与数组原生操作直接相关的变更项，每一项均可在官方渠道核验。

|     |     |     |     |     |
| --- | --- | --- | --- | --- |    
| 变更类型 | 函数 / 特性 | PHP 8.5 行为 | 历史版本对照 | 向后兼容 |
| 新增函数 | `array_first()` | 返回数组首个值，空数组返回 `null` | 此前无原生等价物 | 新增，不影响旧代码 |
| 新增函数 | `array_last()` | 返回数组末个元素，空数组返回 `null` | 此前无原生等价物 | 新增，不影响旧代码 |
| 性能优化 | `array_find()`/ `array_filter()`/ `array_reduce()` | 执行路径优化 | 行为不变 | 兼容  |
| 性能优化 | `usort()`/ `uasort()` | 比较器调用路径优化 | 行为不变 | 兼容  |

注：上述信息综合自 PHP 官方 8.5 发布公告、[php.watch](http://php.watch) 的 PHP 8.5 RFC 清单以及 PHP 核心函数性能优化记录。

## 二、`array_first()`与 `array_last()`的规则定义

这是 PHP 8.5 在数组原生操作层面最重要的新增内容，两项函数互为对称，行为规则一致。

### 1.函数签名

```php
array_first(array $array): mixed
array_last(array $array): mixed
```

函数接收单一数组参数，返回值为数组首个或末个元素的值，类型保持原值类型。

### 2.核心行为规则  

**规则一：不改变数组内部指针**

`reset()`与 `end()`虽然也能取首尾元素，但会移动数组内部指针，对后续遍历造成副作用；`array_first()`/ `array_last()`在语义上仅做读取，不触碰内部指针。

**规则二：兼容索引数组与关联数组**

无论数组键名为整数还是字符串，函数均按数组自然顺序返回首/末值，无需关心键名形态。

**规则三：空数组返回** `null`

输入空数组时，函数返回 `null`，可直接与 `??`运算符组合使用，简化旧版中需先判空的写法。

### 2.3 使用示例

```php
// 索引数组
$fruits = ['apple', 'banana', 'cherry'];
array_first($fruits); // "apple"
array_last($fruits);  // "cherry"

// 关联数组
$data = ['name' => 'John', 'age' => 30, 'city' => 'Berlin'];
array_first($data); // "John"
array_last($data);  // "Berlin"

// 空数组
array_first([]); // null
array_last([]);  // null

// 与 null 合并运算符组合
$lastEvent = array_last($events) ?? 'No events';
```

以上示例行为可在 SensioLabs 与 Laravel News 的发布解读中得到印证。

### 2.4 与既有函数的关系

PHP 8.5 新增的两个函数并非孤立存在，而是与 PHP 7.3 引入的 `array_key_first()`/ `array_key_last()`形成完整互补——后者取键名，前者取值。`array_first($array)`在语义上等价于 `$array[array_key_first($array)]`，但写法更简洁，且避免了 `reset()`/ `end()`修改内部指针的问题。

## 三、数组相关函数的性能调整

PHP 8.5 对一批常用数组函数做了底层执行路径优化，函数签名与返回值规则保持不变，仅执行效率得到提升：

-   `array_find()`：线性查找路径优化
    
-   `array_filter()`：回调调度优化
    
-   `array_reduce()`：累加器实现优化
    
-   `usort()`**/** `uasort()`：用户比较器的调用机制优化
    

由于行为层未变，升级到 PHP 8.5 后既有的排序、过滤、归约逻辑无需修改即可获得性能收益。

## 四、升级影响与兼容性核查

### 1.对现有代码的直接影响

`array_first()`/ `array_last()`为新增函数，不会对调用 `reset()`/ `end()`/ `array_key_first()`等既有写法的代码造成任何破坏。是否采用新函数属于可选优化，而非强制迁移。

### 2.需要关注的间接兼容性点

虽然数组操作本身无破坏性变更，但 PHP 8.5 整体版本中包含若干废弃项，建议在升级时一并核查：

-   `__sleep()`/ `__wakeup()`魔术方法进入废弃流程，建议迁移至 `__serialize()`/ `__unserialize()`
    
-   目录句柄操作相关函数不再接受 `null`参数
    
-   自定义输出缓冲处理器必须返回字符串，且不得在处理器内直接输出
    

### 3.推荐升级检查清单

1.  在测试环境部署 PHP 8.5，开启 `E_DEPRECATED`与 `E_WARNING`完整报告
    
2.  使用 PHPStan 或 Psalm 对代码库做静态扫描，定位废弃调用
    
3.  对数组排序、过滤、序列化等关键路径补充单元测试
    
4.  核对 composer 依赖树中是否有依赖尚未声明 PHP 8.5 兼容
    
5.  灰度发布，保留快速回滚通道
    

> ⚠️ 即便数组原生操作层面无破坏性变更，仍建议在正式升级前完成完整回归测试，以排除其他子系统受 PHP 8.5 整体变更影响的可能性。

## 五、常见

**一：PHP 8.5 改变了数组排序的稳定性规则**

排序稳定性是 PHP 8 时期完成的调整，并非 PHP 8.5 的内容。PHP 8 起核心的 `*sort()`系列函数与 `ArrayObject::*sort()`方法均已重写为稳定排序。PHP 8.5 在此基础上的改动仅限于 `usort()`/ `uasort()`的性能优化，排序结果顺序规则与 PHP 8 保持一致。

**二：**`array_first()`**会取代** `reset()`

两者解决的是不同问题。`reset()`的语义是”将指针移到首位并返回该元素”，附带指针移动副作用；`array_first()`仅做读取。对于需要重置指针的场景，`reset()`仍是合适选择；对于仅需读取首值的场景，`array_first()`更语义化且无副作用。

**三：**`each()`**是在 PHP 8.5 中被移除的**

`each()`早在 PHP 7.2.0 即被废弃，并在 PHP 8.0.0 中正式移除，与 PHP 8.5 无关。如代码库仍在调用 `each()`，应尽早迁移至 `foreach`循环或 `key()`/ `current()`/ `next()`组合。

## 六、总结

PHP 8.5 在数组原生操作层面的调整相对聚焦：新增 `array_first()`与 `array_last()`两个无副作用、跨数组类型通用的取值函数，并对一批高频数组函数做了性能优化。既有数组相关代码在升级到 PHP 8.5 后无需修改即可继续运行，新函数属于可选采用范畴。真正需要在升级时重点核查的，是 PHP 8.5 整体的废弃项与依赖兼容情况，而非数组操作本身的规则变动。

**Tags:** array_first, array_last, PHP8.5, 数组函数, 版本迁移

**Categories:** PHP教程

---