PHP数组操作完整指南与代码示例-php教程-PHP中文网

php数组操作核心陷阱在于键处理逻辑、空值语义和引用残留：array_merge()重排数字键并覆盖字符串键，+保留左侧键；isset()判键存在且非空，array_key_exists()只判键存在；foreach引用遍历后必须unset($v)防污染；json_encode()报错多因资源、闭包或nan等非法值。

php数组操作完整指南与代码示例

PHP数组操作没有“完整指南”这种东西——实际开发中你只会用到其中 20% 的函数，但那 20% 里有 3 个最容易写错、5 个参数顺序反直觉、还有 2 类 key 处理逻辑会悄悄吞掉你的数据。

array_merge() 和 + 运算符根本不是一回事

很多人以为 array_merge() 就是“合并数组”，+ 是“快捷写法”。错。它们对键的处理逻辑完全相反：

array_merge() 丢弃字符串键的重复项，数字键重排索引（[0] => 'a', [0] => 'b' → [0] => 'a', [1] => 'b'）
+ 运算符保留**左侧数组的键值对**，右侧同键的值被直接忽略（['a' => 1] + ['a' => 2] 结果仍是 ['a' => 1]）
如果混用数字键和字符串键：array_merge([0 => 'x'], ['a' => 'y']) → [0 => 'x', 'a' => 'y']；而 [0 => 'x'] + ['a' => 'y'] 也得到相同结果，但只是巧合——一旦左侧有字符串键，行为就不可预测

真实场景：合并配置数组时，用 + 可以保留默认值不被覆盖；做数据聚合（如分页结果拼接）必须用 array_merge() 防止键冲突丢失条目。

isset($arr[$key]) 和 array_key_exists() 的性能与语义差在哪

两者都判断键是否存在，但触发条件不同，且 PHP 7.4+ 后性能差距已不明显，关键在语义：

isset($arr[$key]) 返回 false 如果键存在但值为 null、0、false 或空字符串 —— 它测的是“可访问且非空”
array_key_exists($key, $arr) 只关心键本身是否存在，哪怕值就是 null 也返回 true
当数组很大时，isset() 是语言结构，略快；但若逻辑依赖“键存在即有效”，比如检查 API 返回字段是否包含可选字段 metadata，而该字段允许为 null，就必须用 array_key_exists()

别用 in_array($key, array_keys($arr)) —— 这是 O(n) 查找，且会强制复制全部键名，纯属浪费内存和 CPU。

btpanel phpsite 宝塔面板PHP网站

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

下载

foreach 中修改数组元素：&$v 要小心引用残留

想在遍历时改原数组值，加 &$v 是对的，但很多人忘了 unset 引用：

$arr = ['a', 'b', 'c'];
foreach ($arr as &$v) {
    $v = strtoupper($v);
}
// 此时 $v 仍引用着 $arr 最后一个元素
$arr[] = 'd'; // 意外把 'd' 变成 'D'
echo $arr[3]; // 输出 'D'，不是 'd'

正确做法是循环结束后立刻 unset($v)，或者改用键值方式避免引用：

用 foreach ($arr as $k => $v) + $arr[$k] = ...（安全但稍慢）
用 array_map() 函数式处理（更清晰，且无副作用）
真要引用遍历，结尾必须 unset($v)，否则后续任何对 $v 的赋值都会污染原数组

json_encode() 报 “Array to string conversion” 错误的真正原因

这个错误通常不是因为你传了数组，而是你在数组里塞了无法 JSON 序列化的值：

资源类型（如 fopen() 返回的 file handle）
闭包（anonymous function）
对象没实现 JsonSerializable 且没定义 __toString()
最隐蔽的一种：数组里混入了 NaN 或 INF（PHP 7.4+ 会报错，之前静默转成 null）

调试方法：不用 print_r()，改用 var_export($arr, true) 看真实结构；或逐层检查 is_object()、is_resource()、is_nan()。生产环境建议封装一层安全序列化函数，提前过滤掉非法值，而不是等 json_encode() 崩溃再处理。

数组操作的复杂点从来不在函数数量，而在于 PHP 对“键”的松散定义（数字自动转字符串）、对“空值”的多重解释（null vs false vs ''），以及引用机制在循环中的隐式延续——这些地方不写注释，半年后你自己都看不懂为什么加了个 unset()。