Python与PHP之间高效传递JSON数组：从多行输出到统一解析

DDD

发布时间：2025-11-28 10:58:16

234人浏览过

来源于php中文网

原创

Python与PHP之间高效传递JSON数组：从多行输出到统一解析

本教程详细介绍了如何在python脚本中构建并返回一个标准的json数组，以及php如何通过shell_exec正确接收并解析这种嵌套的json数据结构。通过将python的多个json对象封装成一个列表并统一序列化，以及php分两步解码策略，实现了python与php之间高效、准确地进行复杂数据交互。

Python脚本的优化：构建标准JSON数组

在Python与PHP进行数据交互时，一个常见的问题是Python脚本可能以非标准格式输出JSON数据。例如，如果Python循环中每次迭代都打印一个独立的JSON对象，PHP通过shell_exec接收到的将是一个由多个JSON字符串简单拼接而成的长字符串。这种字符串并非一个合法的整体JSON结构（如JSON数组或JSON对象），因此PHP的json_decode()函数将无法直接解析。

原始的Python代码可能如下所示，它在循环内部逐个打印JSON对象：

import json
# 假设 Jira 类和相关方法已定义

if __name__ == "__main__":
    jira = Jira() # 示例，实际需要引入Jira类
    data = {}
    fields = jira.get_fields() # 示例
    jql_issues = jira.get_jql_search_issues(jql_search="project = SWAT AND resolution = Unresolved ORDER BY priority DESC, updated DESC") # 示例
    for issue in jql_issues:
        data['key'] = issue.key
        data['assignee'] = issue.fields.assignee.display_name
        print(json.dumps(data)) # 问题所在：在循环内逐个打印
    # exit # exit在这里会导致只打印第一个

这种做法会导致PHP接收到类似 "{"key": "SWAT-107", "assignee": "Unassigned"} {"key": "SWAT-98", "assignee": "Unassigned"}" 这样的字符串，这并不是一个有效的JSON数组。

为了解决这个问题，Python脚本需要进行优化，确保它输出的是一个标准的JSON数组字符串。这意味着所有的JSON对象都应该被封装在一个Python列表中，然后整个列表作为一个整体被序列化为JSON字符串。

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

以下是优化后的Python代码示例：

有道智云AI开放平台

下载

import json
# 假设 Jira 类和相关方法已定义，例如：
# class Jira:
#     def get_fields(self):
#         return {}
#     def get_jql_search_issues(self, jql_search):
#         # 模拟返回一些问题对象
#         class Issue:
#             def __init__(self, key, assignee_name):
#                 self.key = key
#                 self.fields = type('obj', (object,), {'assignee': type('obj', (object,), {'display_name': assignee_name})})()
#         return [
#             Issue("SWAT-107", "Unassigned"),
#             Issue("SWAT-98", "Unassigned"),
#             Issue("SWAT-100", "Unassigned")
#         ]

if __name__ == "__main__":
    jira = Jira() # 实例化Jira类
    output_list = [] # 创建一个空列表来存储所有数据字典

    # 假设以下是获取数据并处理的逻辑
    # fields = jira.get_fields() 
    jql_issues = jira.get_jql_search_issues(jql_search="project = SWAT AND resolution = Unresolved ORDER BY priority DESC, updated DESC")

    for issue in jql_issues:
        data_item = {} # 为每个issue创建一个新的字典
        data_item['key'] = issue.key
        data_item['assignee'] = issue.fields.assignee.display_name
        output_list.append(data_item) # 将字典添加到列表中

    print(json.dumps(output_list)) # 在循环结束后，将整个列表序列化为JSON字符串并打印
    # exit() # 通常在脚本末尾不需要显式调用exit()

关键点：

output_list = []: 初始化一个空列表，用于收集每个处理后的数据项。
output_list.append(data_item): 在循环内部，将每个独立的字典（代表一个JSON对象）添加到 output_list 中，而不是直接打印。
print(json.dumps(output_list)): 在循环完全结束后，使用 json.dumps() 对整个 output_list 进行一次性序列化。这将生成一个标准的JSON数组字符串，例如 [{"key": "SWAT-107", "assignee": "Unassigned"}, {"key": "SWAT-98", "assignee": "Unassigned"}]。

PHP端的数据接收与解析：处理嵌套JSON

当Python脚本按照上述优化方式输出一个标准的JSON数组字符串后，PHP端接收和解析数据就变得相对简单和直观。PHP的shell_exec()函数会捕获Python脚本的所有标准输出，并将其作为单个字符串返回。

PHP接收到的字符串现在是一个有效的JSON数组，但其内部的每个元素仍然是JSON字符串形式。因此，我们需要进行两步解码：

首次解码： 将整个接收到的JSON数组字符串解码为PHP数组，该数组的每个元素仍然是一个JSON字符串。
二次解码： 遍历这个PHP数组，对每个元素（即内部的JSON字符串）再次进行解码，并指定将其转换为关联数组。

以下是PHP代码示例：

<?php

// 调用Python脚本并获取其标准输出
$output1 = shell_exec("cd .. && cd python/pyjira && pipenv run py PyJira/Jira.py");

// 调试输出，查看原始Python输出
// var_dump($output1); 
// 预期输出示例：
// string(XXX) "[{"key": "SWAT-107", "assignee": "Unassigned"}, {"key": "SWAT-98", "assignee": "Unassigned"}]"

// 第一次解码：将外部的JSON数组字符串解码为PHP数组
// 此时 $decoded_output 会是一个PHP数组，其元素是JSON字符串
$decoded_output = json_decode($output1);

// 检查解码是否成功以及结果是否为数组
if (json_last_error() !== JSON_ERROR_NONE) {
    echo "JSON解码错误: " . json_last_error_msg();
    exit;
}

if (!is_array($decoded_output)) {
    echo "Python脚本未返回有效的JSON数组。";
    exit;
}

echo "<h3>Jira Issues:</h3>";
echo "<ul>";
// 遍历第一次解码后的PHP数组
for ($i = 0; $i < count($decoded_output); $i++) {
    // 第二次解码：将数组中的每个JSON字符串解码为PHP关联数组
    // 'true' 参数确保将JSON对象转换为关联数组而非PHP对象
    $jira_data = json_decode($decoded_output[$i], true); 

    // 再次检查解码是否成功
    if (json_last_error() !== JSON_ERROR_NONE) {
        echo "<li>内部JSON解码错误: " . json_last_error_msg() . " (原始字符串: " . htmlspecialchars($decoded_output[$i]) . ")</li>";
        continue;
    }

    // 访问关联数组中的数据
    echo "<li>Key: " . htmlspecialchars($jira_data['key']) . " - Assignee: " . htmlspecialchars($jira_data['assignee']) . "</li>";
}
echo "</ul>";

?>

关键点：

$decoded_output = json_decode($output1);: 这一步将Python输出的整个JSON数组字符串解析为PHP数组。这个PHP数组的每个元素都是一个字符串，而这些字符串本身就是内部的JSON对象。
$jira_data = json_decode($decoded_output[$i], true);: 在循环内部，对每个元素（它是一个JSON字符串）再次调用 json_decode()。
true 参数的重要性: json_decode() 的第二个参数如果设置为 true，会将JSON对象解码为PHP关联数组（array('key' => 'value')）；如果省略或设置为 false，则会解码为PHP对象（stdClass）。使用 true 更方便通过键名直接访问数据，例如 $jira_data['key']。

注意事项

错误处理： 在实际应用中，务必对shell_exec的返回值和json_decode的解码结果进行严格的错误检查。json_last_error()和json_last_error_msg()函数可以帮助你诊断JSON解析错误。
命令注入风险： 如果shell_exec的命令中包含来自用户输入的部分，必须进行严格的过滤和转义，以防止命令注入攻击。
性能考量： 对于非常大量的数据交换，shell_exec可能不是最高效的方式。可以考虑使用更高级的进程间通信（IPC）机制，如消息队列、套接字通信，或者将Python脚本作为独立的Web服务（API）运行，PHP通过HTTP请求与其交互。
编码一致性： 确保Python脚本和PHP环境都使用UTF-8编码，以避免中文或其他特殊字符在传输和解析过程中出现乱码。
Python环境管理： 示例中使用了`