PHP中高效且正确地将多维数组编码为JSON的指南

DDD

发布时间：2025-08-23 09:56:01

351人浏览过

来源于php中文网

原创

PHP中高效且正确地将多维数组编码为JSON的指南

本文旨在指导开发者如何使用PHP将多维数组（特别是来自数据库查询结果）正确地编码为符合JSON规范的字符串。通过分析常见的错误模式，即在循环中逐个编码元素并手动拼接，我们提出并演示了两种更高效、更可靠的方法：首先构建完整的PHP数组结构，然后一次性调用json_encode进行编码，以及利用mysqli_fetch_all进一步简化流程，从而避免生成无效JSON。

理解问题：无效JSON的根源

在php开发中，将数据库查询结果或复杂的多维数组转换为json格式是常见的操作。然而，不正确的编码方式可能导致生成的json字符串格式错误，例如出现}{而非},{这样的分隔符问题。这通常源于以下误区：

逐个元素编码： 尝试在循环中对数组的每个子元素单独进行json_encode。
手动拼接JSON字符串： 在循环中手动添加括号、逗号等JSON结构元素。

这两种做法都违反了JSON的结构化原则，因为json_encode函数旨在将一个完整的PHP数据结构（数组或对象）转换为一个合法的JSON字符串。当在循环中单独编码每个子对象时，json_encode会为每个子对象生成一个独立的JSON对象字符串，而手动拼接这些字符串时，很容易遗漏或错误地添加分隔符。

考虑以下常见的错误代码示例：

echo "{\"user_activity\": [";
while($rsel_userAct_p = mysqli_fetch_array($xsel_userAct_p, MYSQLI_ASSOC)) {
     // 错误：在此处对单个行进行json_encode
     print_r(json_encode($rsel_userAct_p), JSON_PRETTY_PRINT);
}
echo "]}";

这段代码的问题在于，json_encode($rsel_userAct_p)每次循环都会生成一个独立的JSON对象字符串（例如 {"log_number": "1", ...}）。当这些字符串被print_r直接输出时，它们之间没有逗号分隔，导致最终输出的JSON字符串在多个对象之间是}{而不是},{，这使得整个JSON结构无效。

正确的JSON编码策略

解决上述问题的核心原则是：先在PHP中构建完整的、符合预期结构的数组或对象，然后对整个结构调用一次json_encode。 PHP的json_encode函数会负责处理所有必要的格式化、转义和分隔符，确保生成一个完全合法的JSON字符串。

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

方法一：迭代构建完整数组

这是最通用且推荐的方法。通过在循环中将每一行数据添加到 PHP 数组的特定键下，构建一个完整的 PHP 数组结构，然后对该数组进行整体编码。

实现步骤：

初始化一个空的PHP数组。
在循环中，将从数据库获取的每一行数据（通常是关联数组）作为子元素添加到这个主数组的指定键下。
循环结束后，对整个主数组调用json_encode。

示例代码：

小羊标书

一键生成百页标书，让投标更简单高效

下载

<?php
// 假设 $xsel_userAct_p 是一个有效的 mysqli 结果集
// 模拟一个结果集，实际应用中会通过 mysqli_query 获得
$mock_data = [
    ['log_number' => '1', 'log_user_1' => 'w120511891', 'log_activity_id' => 'A0002DOC', 'log_document_id' => 'DSX00012', 'log_timestamp' => '2021-10-23 13:52:35'],
    ['log_number' => '9', 'log_user_1' => 'W201005911', 'log_activity_id' => 'A0004DOC', 'log_document_id' => 'DSX00012', 'log_timestamp' => '2021-10-25 10:35:29']
];

// 实际应用中：
// $xsel_userAct_p = mysqli_query($conn, "SELECT ...");

$data_array = [];
$user_activity_list = []; // 用于存储 'user_activity' 数组的元素

// 模拟 mysqli_fetch_array 循环
foreach ($mock_data as $row) {
    // 实际应用中：
    // while ($rsel_userAct_p = mysqli_fetch_array($xsel_userAct_p, MYSQLI_ASSOC)) {
    //     $user_activity_list[] = $rsel_userAct_p;
    // }
    $user_activity_list[] = $row;
}

// 将构建好的列表赋值给主数组的 'user_activity' 键
$data_array["user_activity"] = $user_activity_list;

// 对整个 $data_array 进行 JSON 编码
echo json_encode($data_array, JSON_PRETTY_PRINT);

/* 预期输出：
{
    "user_activity": [
        {
            "log_number": "1",
            "log_user_1": "w120511891",
            "log_activity_id": "A0002DOC",
            "log_document_id": "DSX00012",
            "log_timestamp": "2021-10-23 13:52:35"
        },
        {
            "log_number": "9",
            "log_user_1": "W201005911",
            "log_activity_id": "A0004DOC",
            "log_document_id": "DSX00012",
            "log_timestamp": "2021-10-25 10:35:29"
        }
    ]
}
*/
?>

注意事项：

JSON_PRETTY_PRINT 是一个可选参数，用于使输出的JSON格式化，更易读，但在生产环境中为了节省带宽通常会省略。
确保 $xsel_userAct_p 是一个有效的mysqli_result对象。

方法二：利用 mysqli_fetch_all（更高效）

如果你的PHP环境支持mysqli_fetch_all函数（需要PHP 5.3+且安装了mysqlnd驱动），你可以进一步简化代码，因为它能一次性从结果集中获取所有行作为关联数组的数组。

实现步骤：

直接使用 mysqli_fetch_all 从结果集中获取所有数据。
将获取到的数组赋值给主数组的指定键。
对整个主数组调用json_encode。

示例代码：

<?php
// 假设 $xsel_userAct_p 是一个有效的 mysqli 结果集
// 实际应用中：
// $xsel_userAct_p = mysqli_query($conn, "SELECT ...");

// 模拟 mysqli_result 对象
class MockMySQLiResult {
    private $data;
    private $pointer = 0;

    public function __construct($data) {
        $this->data = $data;
    }

    public function fetch_all($resulttype) {
        if ($resulttype === MYSQLI_ASSOC) {
            return $this->data;
        }
        return []; // 仅支持 MYSQLI_ASSOC
    }
}
$mock_data = [
    ['log_number' => '1', 'log_user_1' => 'w120511891', 'log_activity_id' => 'A0002DOC', 'log_document_id' => 'DSX00012', 'log_timestamp' => '2021-10-23 13:52:35'],
    ['log_number' => '9', 'log_user_1' => 'W201005911', 'log_activity_id' => 'A0004DOC', 'log_document_id' => 'DSX00012', 'log_timestamp' => '2021-10-25 10:35:29']
];
$xsel_userAct_p = new MockMySQLiResult($mock_data);


$data_array = [
    "user_activity" => mysqli_fetch_all($xsel_userAct_p, MYSQLI_ASSOC)
];

echo json_encode($data_array, JSON_PRETTY_PRINT);

/* 预期输出与方法一相同 */
?>

注意事项：

使用 mysqli_fetch_all 时，请确保你的PHP环境已启用mysqlnd驱动。可以通过 phpinfo() 查看 Client API library version 是否显示 mysqlnd。
对于非常大的结果集，一次性获取所有数据可能会占用较多内存。在这种情况下，方法一（迭代构建）可能更具优势，因为它允许你逐行处理数据，或者考虑流式传输JSON。

总结与最佳实践

构建完整结构： 始终在PHP中构建一个完整的数组或对象结构，该结构与你期望的最终JSON结构相匹配。
一次性编码： 对这个完整的PHP结构调用一次json_encode函数。
利用辅助函数： 对于数据库结果集，mysqli_fetch_all(..., MYSQLI_ASSOC) 是一个非常方便且高效的函数，可以快速将所有行转换为关联数组的数组。
错误处理： json_encode在编码失败时会返回false。建议结合json_last_error()和json_last_error_msg()进行错误检查，以便及时发现并解决编码问题。
性能考量： 对于极大的数据集，虽然mysqli_fetch_all很方便，但一次性加载所有数据可能导致内存压力。此时，迭代构建数组或考虑更高级的JSON流式输出方案可能更合适。
可读性： 在开发和调试阶段，使用JSON_PRETTY_PRINT可以显著提高JSON输出的可读性。