PHP中实现多个ID映射转换为单个目标ID的推荐方法

PHP没有为这类多对一ID映射场景提供专用的内置功能，但利用PHP原生数组的键查找特性（时间复杂度O(1)），就可以实现高性能、易维护的转换逻辑，完全能满足需求。

基础实现方式 #

核心思路是把所有待转换的原始ID作为数组键，对应的目标ID作为数组值，查找时直接通过键取值即可，后续新增映射规则只需要往数组中新增条目，维护成本极低。

// 映射规则配置
$idMap = [
    // 映射到目标ID 1234的原始ID
    38332 => 1234,
    84371 => 1234,
    37939 => 1234,
    1275  => 1234,
    // 映射到目标ID 1235的原始ID
    222   => 1235,
    47391 => 1235,
    798   => 1235,
    // 后续新增规则直接按格式往下追加即可
];

/**
 * ID转换方法
 * @param int $originId 原始ID
 * @param mixed $default 无匹配规则时的返回值，默认返回原始ID
 * @return int|mixed
 */
function convertId(int $originId, mixed $default = null)
{
    // 实际项目可将映射配置存放在配置文件中，避免使用global
    global $idMap;
    return $idMap[$originId] ?? $default ?? $originId;
}

// 调用示例
echo convertId(38332); // 输出1234
echo convertId(798);   // 输出1235
echo convertId(99999); // 无匹配规则时默认返回原始ID 99999

更易维护的配置写法 #

如果觉得同一目标ID重复写多次太繁琐，可以先按目标ID分组配置规则，再自动生成扁平化的查找映射表，新增规则时只需要往对应分组追加原始ID即可：

// 按目标ID分组配置规则
$idGroupRules = [
    1234 => [38332, 84371, 37939, 1275],
    1235 => [222, 47391, 798],
    // 新增分组规则直接追加即可，例：1236 => [999, 1000]
];

// 构建扁平化查找表，该步骤只需要执行一次
$idMap = [];
foreach ($idGroupRules as $targetId => $originIds) {
    foreach ($originIds as $originId) {
        $idMap[$originId] = $targetId;
    }
}

// 后续转换逻辑和上述convertId方法完全一致

优化建议 #

• 如果映射规则量级大（万级以上），可以把构建完成的$idMap存到配置文件（开启OPcache时性能极高）或者缓存中，避免每次请求重复执行构建数组的逻辑。
• 无匹配ID的处理逻辑可以根据业务需求调整，比如抛出异常、返回固定错误码等，直接修改convertId方法内的逻辑即可。

内容的提问来源于stack exchange，提问作者user3161924