如何使用 array_flip() 优雅地反转枚举值数组

M66 2025-06-03

在日常 PHP 开发中，我们经常会遇到「枚举值 ? 标签」之间的相互转换。比如，一个订单状态的数组：

$statusMap = [
    0 => '待支付',
    1 => '已支付',
    2 => '已发货',
    3 => '已完成',
];

这种结构便于从状态码取出对应的文字描述。但有时候我们也需要反过来操作，比如根据“已发货”取出其对应的状态码 2。这时，如果没有额外的结构支持，可能需要遍历整个数组，写出类似的逻辑：

function getStatusCode($label) {
    foreach ($statusMap as $code => $desc) {
        if ($desc === $label) {
            return $code;
        }
    }
    return null;
}

看起来就有些啰嗦了。这时候，PHP 自带的 array_flip() 函数就派上用场了！

什么是 array_flip()？

array_flip() 是 PHP 的一个内置函数，用于将数组的「键」和值对调：

array_flip(array $array): array

注意事项：

数组的值必须是唯一且可作为键的标量值（如字符串或整数）。
如果有重复值，后面的会覆盖前面的。

用 array_flip() 实现枚举值反转

我们来看看如何优雅地反转一个枚举值数组：

$statusMap = [
    0 => '待支付',
    1 => '已支付',
    2 => '已发货',
    3 => '已完成',
];

$labelToCodeMap = array_flip($statusMap);

echo $labelToCodeMap['已发货']; // 输出 2

是不是瞬间简洁了不少？只需要一次 array_flip()，就获得了从“标签”到“值”的映射表。

实战案例：表单下拉选项值转换

假设你有一个用户性别选项的枚举：

$genderMap = [
    'M' => '男',
    'F' => '女',
    'O' => '其他',
];

表单提交时用户选择的是 '女'，你希望将其转换回 'F' 储存到数据库中：

$input = '女';
$labelToValue = array_flip($genderMap);
$genderCode = $labelToValue[$input] ?? null;

if ($genderCode === null) {
    echo "非法性别值";
} else {
    // 假设这里保存到数据库
    saveGenderToDB($genderCode);
}

不仅代码更加紧凑，而且逻辑非常清晰易懂。

使用技巧：缓存反转数组

如果在多个地方都需要使用反转数组，不妨在项目中定义一个通用方法：

function getFlippedMap(array $map): array {
    static $cache = [];

    $hash = md5(json_encode($map));
    if (!isset($cache[$hash])) {
        $cache[$hash] = array_flip($map);
    }

    return $cache[$hash];
}

这样，即便多次调用，也能复用已有的反转结果，提升性能。

注意事项：值必须唯一

要记住，如果原数组中的值不唯一，array_flip() 将会自动覆盖之前的键：

$arr = [
    'a' => 'apple',
    'b' => 'banana',
    'c' => 'apple',
];

print_r(array_flip($arr));

输出将是：

Array
(
    [banana] => b
    [apple] => c // 'a' 被覆盖
)

这在处理枚举值时可能引发 bug，因此建议在反转前确保值是唯一的。

小结

array_flip() 是一个小巧却非常实用的函数，尤其适用于“标签 ? 值”之间的快速转换。通过它，我们可以让 PHP 代码更简洁、更易读，也更少出错。下次当你写下一个循环时，不妨想想：这是不是可以用 array_flip() 一步到位？

array_flip