Python与PHP交互：正确传递JSON数组的实践指南

本教程旨在解决python脚本向php返回多条json数据时遇到的常见问题。通过优化python脚本，将所有数据封装成一个完整的json数组输出，并在php端进行两阶段解码，即先解码整体json数组，再循环解码数组中的每个json字符串为关联数组，确保数据结构清晰、易于处理。

在开发Web应用时，我们经常需要利用Python处理复杂逻辑或数据，并通过PHP前端来调用并展示结果。一个常见的场景是Python脚本生成多条数据记录，每条记录以JSON格式表示，然后将其返回给PHP。然而，如果Python脚本只是简单地在循环中打印每个JSON对象，PHP接收到的将是一个由多个JSON字符串拼接而成的非标准字符串，导致PHP的json_decode函数无法正确解析。

问题分析

原始的问题在于Python脚本在循环内部多次调用print(json.dumps(data))，导致每次迭代都输出一个独立的JSON字符串。当PHP通过shell_exec捕获这些输出时，它们被连接成一个单一的长字符串，例如：

{"key": "SWAT-107", "assignee": "Unassigned"} {"key": "SWAT-98", "assignee": "Unassigned"} ...

这个字符串不是一个有效的JSON数组或对象，因此PHP的json_decode无法将其解析为一个可操作的数据结构。即使尝试将Python输出改为一个包含JSON字符串的Python列表，PHP接收到的仍然是一个字符串表示的列表，例如['{"key": ...}', '{"key": ...}']，这也不是一个标准的JSON格式。

解决方案：Python端的优化

解决此问题的关键在于确保Python脚本的最终输出是一个完整且标准的JSON结构，通常是一个JSON数组。这意味着我们需要在Python脚本中收集所有要返回的数据，然后一次性将整个数据结构序列化为JSON字符串并打印出来。

具体步骤如下：

创建一个空列表：用于存储每个数据项（字典）。
在循环中构建字典并添加到列表：将每个数据项（如Jira问题信息）构建成一个Python字典，然后使用json.dumps()将其序列化为JSON字符串，并添加到预先创建的列表中。
循环结束后，序列化整个列表并打印：在循环外部，将包含所有JSON字符串的列表再次使用json.dumps()序列化。这将生成一个标准的JSON数组字符串，其中每个元素都是一个JSON字符串。

以下是优化后的Python脚本示例：

import json
# 假设 Jira 类和 get_fields, get_jql_search_issues 方法已定义
# from PyJira.Jira import Jira 

if __name__ == "__main__":
    # jira = Jira() # 假设 Jira 实例已创建
    output_data_list = [] # 用于存储所有数据字典的列表

    # 模拟获取Jira问题数据
    # fields = jira.get_fields()
    # jql_issues = jira.get_jql_search_issues(jql_search="project = SWAT AND resolution = Unresolved ORDER BY priority DESC, updated DESC")

    # 模拟一些问题数据
    jql_issues = [
        type('obj', (object,), {'key': 'SWAT-107', 'fields': type('obj', (object,), {'assignee': type('obj', (object,), {'display_name': 'Unassigned'})})})(),
        type('obj', (object,), {'key': 'SWAT-98', 'fields': type('obj', (object,), {'assignee': type('obj', (object,), {'display_name': 'Unassigned'})})})(),
        type('obj', (object,), {'key': 'SWAT-100', 'fields': type('obj', (object,), {'assignee': type('obj', (object,), {'display_name': 'Admin'})})})(),
    ]

    for issue in jql_issues:
        data_item = {}
        data_item['key'] = issue.key
        # 假设 assignee 字段可能为空
        assignee_name = issue.fields.assignee.display_name if issue.fields.assignee else "Unassigned"
        data_item['assignee'] = assignee_name
        output_data_list.append(data_item) # 将字典添加到列表

    # 将整个列表序列化为JSON数组字符串并打印
    print(json.dumps(output_data_list))
    # exit() # 通常不需要在脚本末尾显式调用 exit()

现在，Python脚本的输出将是一个标准的JSON数组，例如：

[{"key": "SWAT-107", "assignee": "Unassigned"}, {"key": "SWAT-98", "assignee": "Unassigned"}, {"key": "SWAT-100", "assignee": "Admin"}]

PHP端的处理

当Python脚本按照上述方式优化后，PHP通过shell_exec接收到的将是一个有效的JSON数组字符串。PHP端的处理将分为两个阶段：

第一次解码：使用json_decode将整个JSON数组字符串解码为PHP数组。此时，数组中的每个元素将是PHP对象（如果JSON中的元素是对象）或字符串（如果JSON中的元素是字符串）。
第二次解码（循环内）：遍历第一次解码得到的数组。由于Python的输出是一个JSON数组，其中每个元素是包含具体数据的JSON对象。因此，PHP第一次解码后得到的是一个包含PHP对象的数组。我们需要在循环中再次对每个PHP对象进行解码，并使用true参数将其转换为关联数组，以便通过键名访问数据。

以下是PHP端的处理示例：

Jira Issues:";
foreach ($decoded_output as $jira_item_object) {
    // 第二次解码：将每个PHP对象（代表一个Jira问题）转换为关联数组
    // 'true' 参数确保将对象转换为关联数组
    $jira_data = (array) $jira_item_object; // 或者 json_decode(json_encode($jira_item_object), true); 更通用但稍慢

    // 检查是否成功转换为数组且包含预期的键
    if (is_array($jira_data) && isset($jira_data['key']) && isset($jira_data['assignee'])) {
        echo "Key: " . htmlspecialchars($jira_data['key']) . " - Assignee: " . htmlspecialchars($jira_data['assignee']) . "
";
    } else {
        echo "Invalid item structure encountered.
";
    }
}
?>

代码说明：

shell_exec($python_script_command)：执行Python脚本并捕获其标准输出。
json_decode($output_json_string)：将Python脚本输出的JSON数组字符串解码为PHP数组。此时，$decoded_output将是一个包含PHP标准对象的数组。
foreach ($decoded_output as $jira_item_object)：遍历这个PHP数组。$jira_item_object在每次迭代中都是一个PHP标准对象，代表一个Jira问题。
$jira_data = (array) $jira_item_object;：这是将PHP标准对象快速转换为关联数组的简洁方式。如果对象结构复杂或包含嵌套对象，更稳健的方法是json_decode(json_encode($jira_item_object), true);，它会先将PHP对象编码回JSON字符串，再解码为关联数组。
htmlspecialchars()：用于在HTML输出中转义特殊字符，防止XSS攻击。

注意事项与总结

单一JSON结构原则：无论是从Python返回给PHP，还是在任何API通信中，始终确保通信的载体是一个单一、完整且符合JSON规范的结构（一个JSON对象或一个JSON数组）。避免输出多个独立的JSON片段。
PHP json_decode 的 true 参数：当json_decode的第二个参数设置为true时，它会将JSON对象解码为PHP关联数组，而不是默认的PHP标准对象。这在访问数据时通常更为方便，例如$data['key']而非$data->key。
错误处理：在实际应用中，务必对shell_exec的返回值和json_decode的结果进行充分的错误检查。例如，检查shell_exec是否返回null或false，以及json_last_error()和json_last_error_msg()来判断JSON解码是否成功。
环境配置：确保PHP执行环境能够正确找到并运行Python脚本，包括Python解释器、虚拟环境（如pipenv）以及所有必要的Python库。
安全性：如果Python脚本的输入来源于用户，请务必进行输入验证和清理，防止命令注入等安全漏洞。

通过遵循这些实践，您可以有效地在Python和PHP之间传递复杂的JSON数据结构，实现健壮可靠的跨语言通信。

# php # python # html # js # 前端 # json # 编码 # app # ai # nas # 虚拟环境 # 常见问题 # 环境配置

返回目录在线咨询

上一篇：陕西网站制作：专业打造，品质保证
下一篇：JQuery 获取Dom元素的实例讲解

您的项目需求