PHP类常量数组合并技巧：使用array_merge构建单一索引数组

本文将详细介绍在php中，如何将类中定义的多个常量数组高效地合并为一个单一的索引数组。通过对比`array_push`和`array_merge`的用法及其结果，阐明了使用`array_merge`是实现此需求的关键，避免了生成嵌套数组的常见错误，确保数据结构符合预期，从而提高代码的清晰度和数据处理的准确性。

在PHP开发中，我们经常会将一些固定的配置或状态值定义为类常量，尤其当这些常量以数组形式存在时。例如，在一个处理图书状态的系统中，可能会有成功状态和失败状态的常量数组。然而，如何将这些独立的常量数组有效地合并成一个扁平化的单一索引数组，是开发者常遇到的问题。

定义常量数组

首先，我们来看一个典型的常量定义示例。假设我们有一个BooksConstants类，其中定义了图书的成功和失败状态数组：

class BooksConstants {
    const PAID = 'settled';

    const BOOK_FAILED_STATUSES = [
        'cancelled_by_customer', // 假设这里是字符串，原示例中缺少self::
        'FAILED',
        'FAILED_BY_GATEWAY',
        'INVALID_OTP'
    ];

    const BOOK_SUCCESS_STATUSES = [
        self::PAID,
        'SUCCESS',
        'ON_THE_WAY',
        'PROGRESS'
    ];
}

登录后复制

注意： 在BOOK_FAILED_STATUSES中，原示例使用了self::cancelled_by_customer等，但cancelled_by_customer并未定义为常量。在实际应用中，如果这些是字符串字面量，应直接用引号包裹。为了演示目的，我们假设它们是字符串。

常见误区：使用 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
(
    [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 变成了包含两个子数组的二维数组，这与我们期望的 ['failed', 'settled', 'failed by gateway', ...] 这种单一索引数组结构不符。

正确方法：使用 array_merge

要实现将多个数组的元素合并到一个新的单一索引数组中，PHP提供了 array_merge() 函数。array_merge() 的作用是将一个或多个数组合并，如果输入的数组中有相同的字符串键名，则后面的值会覆盖前面的值；如果键名是数字，则会重新索引。对于我们这里的情况，由于都是索引数组（数字键名），它会简单地将所有元素按顺序拼接起来。

标签： php ai php开发 gate