欢迎来到三明社交动力网络科技有限公司
建站资讯

当前位置: 首页 > 建站资讯 > 建站教程 > PHP教程

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

作者:企业网页模板 来源:php怎么学日期:2025-11-28

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字符串并打印出来。

立即学习“PHP免费学习笔记(深入)”;

具体步骤如下:

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

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

Lifetoon Lifetoon

免费的AI漫画创作平台

Lifetoon 92 查看详情 Lifetoon
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端的处理示例:

<?php// 假设您的Python脚本路径和执行环境配置正确$python_script_command = "cd .. && cd python/pyjira && pipenv run python PyJira/Jira.py";$output_json_string = shell_exec($python_script_command);// 确保 shell_exec 没有返回错误或空字符串if ($output_json_string === null || $output_json_string === false) {    die("Error executing Python script or no output received.");}// 第一次解码:将整个JSON数组字符串解码为PHP数组// 此时 $decoded_output 会是一个PHP数组,其中每个元素是PHP对象$decoded_output = json_decode($output_json_string);if (json_last_error() !== JSON_ERROR_NONE) {    die("JSON decode error (first stage): " . json_last_error_msg());}if (!is_array($decoded_output)) {    die("Python script did not return a valid JSON array.");}echo "<h2>Jira Issues:</h2>";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']) . "<br>";    } else {        echo "Invalid item structure encountered.<br>";    }}?>
登录后复制

代码说明:

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数据结构,实现健壮可靠的跨语言通信。

以上就是Python与PHP交互:正确传递JSON数组的实践指南的详细内容,更多请关注php中文网其它相关文章!

标签: php教程百度云
上一篇: PHP受保护方法有何用途_PHP受保护方法作用范围与实际案例讲解
下一篇: 暂无

推荐建站资讯

更多>