PHP：将类常量数组高效合并为单一索引数组的教程

12次阅读

本教程详细介绍了如何在 php 中将定义在类常量中的多个数组值合并为一个单一的、扁平化的索引数组。文章将纠正使用 `array_push` 导致嵌套数组的常见错误，并重点讲解如何利用 `array_merge()` 函数实现所需效果，确保所有元素直接合并成一个连续的列表，从而优化代码结构和数据处理。

在 PHP 开发中，我们经常会遇到需要将多个相关联的数据集合并成一个统一列表的场景。尤其当这些数据以类常量数组的形式定义时，如何高效且正确地将它们合并成一个扁平的、单一索引数组，是开发者需要掌握的关键技能。本教程将以一个典型的状态常量定义为例，深入探讨这个问题并提供最佳实践。

场景描述

假设我们有一个 BooksConstants 类，其中定义了书籍的不同状态，并将其归类为成功状态和失败状态的常量数组：

class BooksConstants {const PAID = 'settled';      const BOOK_FAILED_STATUSES = [         'cancelled_by_customer', // 假设这里是 self::cancelled_by_customer，但为简化示例直接使用字符串         'FAILED',         'FAILED_BY_GATEWAY',         'INVALID_OTP'];     const BOOK_SUCCESS_STATUSES = [self::PAID,         'SUCCESS',         'ON_THE_WAY',         'PROGRESS']; }

我们的目标是获取所有这些状态（无论是成功还是失败），并将它们合并到一个单一的、扁平的索引数组中，例如：[‘settled’, ‘SUCCESS’, ‘ON_THE_WAY’, ‘PROGRESS’, ‘cancelled_by_customer’, ‘FAILED’, ‘FAILED_BY_GATEWAY’, ‘INVALID_OTP’]。

常见误区：使用 array_push()

初学者可能会尝试使用 array_push()来合并这些数组，认为它可以将元素逐一添加到目标数组中。然而，当 array_push()的第二个参数是一个数组时，它会将整个数组作为一个单一元素添加到目标数组中，从而导致一个嵌套的数组结构。

立即学习“PHP 免费学习笔记（深入）”；

考虑以下代码：

// Controller.php $array = []; array_push($array, BooksConstants::BOOK_SUCCESS_STATUSES); array_push($array, BooksConstants::BOOK_FAILED_STATUSES);  print_r($array);

执行上述代码，$array 的输出将是：

Array ([0] => Array         ([0] => settled             [1] => SUCCESS             [2] => ON_THE_WAY             [3] => PROGRESS         )      [1] => Array         ([0] => cancelled_by_customer             [1] => FAILED             [2] => FAILED_BY_GATEWAY             [3] => INVALID_OTP         )  )

这显然不符合我们想要一个扁平化、单一索引数组的要求。array_push()在这里创建了一个包含两个子数组的二维数组，而不是将所有状态值直接合并到一级数组中。

正确方法：使用 array_merge()

要实现将多个数组的元素直接合并到一个新的扁平数组中，PHP 提供了 array_merge()函数。array_merge()函数接受一个或多个数组作为参数，并返回一个新数组，其中包含了所有参数数组的元素。对于数值索引数组，array_merge()会将所有元素按顺序追加到新数组中，并重新索引。

以下是使用 array_merge()的正确实现：

// Controller.php $array = array_merge(BooksConstants::BOOK_SUCCESS_STATUSES, BooksConstants::BOOK_FAILED_STATUSES);  print_r($array);

执行上述代码后，$array 的输出将是：

Array ([0] => settled     [1] => SUCCESS     [2] => ON_THE_WAY     [3] => PROGRESS     [4] => cancelled_by_customer     [5] => FAILED     [6] => FAILED_BY_GATEWAY     [7] => INVALID_OTP )

这正是我们所期望的扁平化、单一索引数组结构。array_merge()高效地将两个常量数组的所有元素提取出来，并按顺序合并成了一个新的数组。

总结与注意事项

array_merge() vs. array_push():
- array_merge()：用于将一个或多个数组的 所有元素 合并到一个新数组中。对于数值索引数组，它会重新索引；对于关联数组，它会合并键值对，如果键重复则后面的值会覆盖前面的值。
- array_push()：用于向一个数组的 末尾添加一个或多个元素。如果添加的元素本身是一个数组，它会被作为一个整体元素添加到目标数组中，导致嵌套。
性能考量 : 对于合并少量数组，array_merge() 是高效且推荐的选择。如果需要合并的数组数量非常多，或者对性能有极致要求，可以考虑其他方法，但在大多数日常开发场景中，array_merge()足以满足需求。
可读性 : 使用 array_merge() 清晰地表达了“合并数组内容”的意图，提高了代码的可读性和维护性。
类常量的好处: 将状态定义为类常量，不仅可以提高代码的组织性，使其更易于管理和查找，还能避免魔法字符串，减少潜在的拼写错误。