PHP 中使用解包操作符（Splat）向数组添加键值对的正确方式-php教程-PHP中文网

PHP 中使用解包操作符（Splat）向数组添加键值对的正确方式

本文介绍如何在 PHP 7.4+ 中利用解包操作符（...）高效、简洁地向已有关联数组动态注入新键值对，避免冗余调用 array_merge()，提升代码可读性与性能。

本文介绍如何在 php 7.4+ 中利用解包操作符（`...`）高效、简洁地向已有关联数组动态注入新键值对，避免冗余调用 `array_merge()`，提升代码可读性与性能。

在 PHP 开发中，经常需要基于一个基础配置数组（如 $settings = ['height' => 10, 'width' => 20, 'fit' => 'crop']）派生多个变体——每个变体在保留原始键值的基础上，额外添加一组特定的键值对。传统做法常依赖 array_merge()，例如：

return new Settings(
    ['detail' => array_merge($settings, ['foo' => 'bar']), 'detail-l' => array_merge($settings, ['foo2' => 'bar2'])],
    ['small' => array_merge($settings, ['foo3' => 'bar2'])],
);

虽然功能正确，但存在明显缺陷：

语法冗长，重复调用 array_merge() 降低可读性；
键顺序易被忽略（array_merge() 将右侧数组键覆盖左侧同名键，且新键总置于末尾），而解包操作符能更直观控制键序；
性能上略逊于直接解包（尤其在小数组场景下，虽差异微小，但语义更优）。

✅ 推荐方案：使用解包操作符（Splat Operator）
自 PHP 5.6 起支持数组解包（需 PHP ≥ 7.4 才支持关联数组解包），可直接将源数组“展开”到新数组字面量中，并自由指定新键位置：

$settings = ['height' => 10, 'width' => 20, 'fit' => 'crop'];

return new Settings(
    [
        'detail'   => ['foo' => 'bar', ...$settings],
        'detail-l' => ['foo2' => 'bar2', ...$settings]
    ],
    [
        'small' => ['foo3' => 'bar2', ...$settings]
    ]
);

? 关键说明：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

['foo' => 'bar', ...$settings] 表示：先定义 'foo' => 'bar'，再将 $settings 中所有键值对依次展开插入——最终结果为 ['foo' => 'bar', 'height' => 10, 'width' => 20, 'fit' => 'crop']；
若需覆盖基础设置中的某项（如强制 fit => 'contain'），只需将新键写在解包之后：[...$settings, 'fit' => 'contain']；
解包操作符要求目标环境为 PHP 7.4 或更高版本，低版本需降级使用 array_merge() 或升级 PHP。

? 进阶提示：若需动态生成键名或值（如基于变量构造 'foo' . $suffix => $value），可结合 array_merge() 或循环构建临时数组，但静态场景下解包始终是语义最清晰、性能最轻量的选择。

综上，善用 ...$array 不仅让代码更简洁，更体现了现代 PHP 对数组操作的原生优化能力——告别胶水函数，拥抱直观表达。