如何将逗号分隔的键值对字符串解析为关联数组-php教程-PHP中文网

如何将逗号分隔的键值对字符串解析为关联数组

本文介绍在 PHP 中将形如 "key1=value1,key2=value2" 的字符串安全、高效地转换为关联数组的方法，涵盖基础实现、边界处理及正则校验等关键实践。

本文介绍在 php 中将形如 `"key1=value1,key2=value2"` 的字符串安全、高效地转换为关联数组的方法，涵盖基础实现、边界处理及正则校验等关键实践。

在 PHP 开发中，常需将配置字符串、查询参数或序列化键值对（如 config=key1=value1,key2=value2）解析为可操作的关联数组。核心目标是：不依赖预知键名数量（即未知 n），自动拆分并映射每个 key=value 对。

基础实现：explode() + list() 组合

最简洁可靠的方式是先按逗号分割整体字符串，再对每段子串按等号拆解：

$string = "name=John,age=30,city=New York";
$result = [];

foreach (explode(',', $string) as $pair) {
    // 忽略空项（如末尾多余逗号）
    if (trim($pair) === '') continue;

    $parts = explode('=', $pair, 2); // 限制最多拆成两部分，避免 value 中含 '=' 被误切
    if (count($parts) !== 2) {
        throw new InvalidArgumentException("Invalid key-value pair: '$pair'");
    }

    [$key, $value] = $parts;
    $result[trim($key)] = trim($value);
}

// 输出：['name' => 'John', 'age' => '30', 'city' => 'New York']

✅ 优点：语义清晰、性能优异、兼容所有 PHP 版本。
⚠️ 注意：explode('=', $pair) 不加限制时，若 value 中本身含 =（如 url=https://example.com?a=1&b=2），会导致截断错误——因此务必使用 explode('=', $pair, 2) 限定分割次数。

增强健壮性：正则校验与容错

当输入来源不可信（如用户提交、外部 API）时，建议加入格式校验，确保键值符合预期结构（例如键不能为空、不能含非法字符）：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

$result = [];
$pairs = explode(',', $string);

foreach ($pairs as $pair) {
    $pair = trim($pair);
    if (empty($pair)) continue;

    // 匹配：非空键 + '=' + 非空值（支持含空格、连字符、下划线的键/值）
    if (preg_match('/^([^=\s,]+)\s*=\s*(.+)$/', $pair, $matches)) {
        $key   = trim($matches[1]);
        $value = trim($matches[2]);
        $result[$key] = $value;
    } else {
        throw new InvalidArgumentException("Malformed pair: '$pair'");
    }
}

该正则 /^([^=\s,]+)\s*=\s*(.+)$/ 确保：