异常教程

PHP array_values() 函数（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在 PHP 开发中，数组是处理数据的核心结构之一。无论是从数据库获取的记录集，还是用户提交的表单数据，开发者常常需要对数组进行灵活的操作。然而，当数组的索引变得混乱或需要重新整理时，PHP array_values() 函数 就像一把精准的瑞士军刀，能够快速完成索引的重置和数组结构的规范化。本文将从基础语法、实际应用场景到进阶技巧，系统性地解析这个函数的原理与用法，帮助开发者在项目中高效利用它。

功能与语法解析

函数的核心功能

array_values() 函数的主要作用是 重置数组的索引，使其变为连续的数值型索引（从 0 开始递增）。这一过程会保留数组中的原始值，仅调整索引的排列方式。例如，当数组因删除元素或合并操作导致索引断裂时，该函数能快速修复索引的连续性。

形象比喻：
可以将数组的索引想象成书架上的书籍编号。如果某些书籍被移除后，剩下的书籍编号可能变成 0, 2, 5，此时 array_values() 就像重新贴上 1, 2, 3 的标签，让书籍编号恢复连续。

语法与参数

array array_values ( array $array )

  • 参数：
    | 参数名 | 类型 | 必需 | 说明 |
    |----------|--------|------|--------------------------|
    | $array | array | 是 | 需要处理的输入数组 |

  • 返回值：
    返回一个 新数组，其值与原数组完全一致，但索引会被重置为连续的整数。原数组的结构（如关联键名）会被完全忽略。

核心应用场景

场景 1：重置数组索引

当数组因删除元素或合并操作导致索引断裂时，array_values() 可以快速修复索引的连续性。

示例代码：

$users = [  
    0 => 'Alice',  
    1 => 'Bob',  
    2 => 'Charlie'  
];  
unset($users[1]); // 删除 Bob 后，数组索引变为 [0, 2]  

$fixedUsers = array_values($users);  
print_r($fixedUsers);  
// 输出：Array ( [0] => Alice [1] => Charlie )

场景 2：合并多个数组后整理索引

使用 array_merge() 合并数组时，若原数组包含关联键名，合并后的索引可能不连续。此时通过 array_values() 可以进一步整理结果。

示例代码：

$array1 = ['a', 'b', 'c'];  
$array2 = ['x', 'y', 'z'];  

$merged = array_merge($array1, $array2);  
$final = array_values($merged);  
// $final 的索引为 0-5，值按顺序排列

场景 3：处理关联数组时保留值

当需要将关联数组（键名非数值型）转换为纯数值索引的数组时，array_values() 可以直接提取所有值并重置索引。

示例代码：

$assocArray = [  
    'name' => 'John',  
    'age' => 30,  
    'city' => 'New York'  
];  

$numericArray = array_values($assocArray);  
// 输出：Array ( [0] => John [1] => 30 [2] => New York )

进阶用法与技巧

技巧 1：与 array_keys() 的组合使用

若需要同时获取数组的键名和键值，并分别处理，可以结合 array_values() 和 array_keys()。例如，生成键值对的列表：

示例代码：

$data = ['apple' => 1, 'banana' => 2, 'orange' => 3];  

$keys = array_keys($data); // ['apple', 'banana', 'orange']  
$values = array_values($data); // [1, 2, 3]

技巧 2：处理多维数组的嵌套结构

在多维数组中，array_values() 仅重置最外层的索引，但可以通过递归或循环实现深层索引的重置。

示例代码：

$products = [  
    ['id' => 1, 'name' => 'Laptop'],  
    ['id' => 3, 'name' => 'Mouse'], // 假设索引因删除操作断裂  
];  

// 重置外层数组索引  
$products = array_values($products);  
// 输出后索引为 0, 1，但内部子数组的结构不受影响

常见误区与注意事项

误区 1：函数会修改原数组

array_values() 不会直接修改原数组，而是返回一个新的数组。若需保留修改结果，必须将结果赋值给变量。

错误示例：

$original = [1, 2, 3];  
array_values($original); // 未赋值，原数组不变

误区 2：与 array_flip() 混淆

array_flip() 是将数组的键名与值交换，而 array_values() 仅重置数值索引。两者功能完全不同，需根据需求选择。

注意事项：

  • 若原数组已为连续的数值索引，调用 array_values() 后结果与原数组完全一致。
  • 处理大型数组时，函数的时间复杂度为 O(n)，通常无需担心性能问题。

性能优化与最佳实践

场景优化：避免不必要的调用

在循环或频繁操作数组时，应优先检查是否需要重置索引。例如，若仅需遍历数组，无需调用 array_values()。

最佳实践：

  1. 明确需求：仅在索引断裂或需要纯数值索引时使用。
  2. 结合其他函数：与 array_map()、array_filter() 等配合，实现复杂的数据处理流程。
  3. 文档标注：在代码注释中说明 array_values() 的使用目的，便于团队协作。

结论

PHP array_values() 函数 是开发者工具箱中不可或缺的实用工具，尤其在数组索引管理方面表现突出。通过本文的讲解，读者可以掌握其基础用法、进阶技巧及常见误区，从而在实际项目中高效处理数据。无论是修复断裂的索引、合并数组后的规范化，还是将关联数组转换为数值型索引，这个函数都能提供简洁而可靠的支持。建议开发者在日常编码中多加实践，逐步提升对数组操作的掌控能力。

（全文约 1800 字）

最新发布

查看更多文章