本教程旨在解决Python脚本向PHP应用传输多个JSON对象时遇到的常见问题。文章详细介绍了如何优化Python脚本，将所有JSON数据聚合为一个完整的JSON数组并输出。随后，它演示了PHP端如何正确解析这一嵌套结构，通过两次`json_decode`操作，先将整体JSON字符串解码为PHP数组，再逐个解码内部的JSON字符串为关联数组，从而实现Python与PHP之间高效且结构化的数据交换。
在现代Web开发中，后端服务往往涉及多种编程语言的协作。当PHP应用需要调用Python脚本来执行特定任务并获取复杂数据时，JSON作为一种轻量级的数据交换格式，是首选方案。然而，如果Python脚本错误地输出了多个独立的JSON字符串，PHP接收到的将是一个难以直接解析的拼接字符串，导致数据处理的困境。本文将详细阐述如何正确地从Python返回一个包含多个JSON对象的数组，并在PHP中进行有效解析。
理解初始问题
问题的核心在于Python脚本的输出方式。当Python脚本在循环中多次调用 print(json.dumps(data)) 时，它实际上是将每个 data 字典转换为一个独立的JSON字符串并输出到标准输出。PHP通过 shell_exec 获取到的，就是这些独立JSON字符串的简单拼接。例如：
{"key": "SWAT-107", "assignee": "Unassigned"}
{"key": "SWAT-98", "assignee": "Unassigned"}在PHP中，这会被视为一个包含换行符的单一字符串：
立即学习“PHP免费学习笔记（深入）”；
"{"key": "SWAT-107", "assignee": "Unassigned"}\n{"key": "SWAT-98", "assignee": "Unassigned"}\n"这样的字符串无法通过 json_decode() 一次性解析为一个有效的JSON数组或对象，因为这不是一个合法的JSON结构。一个合法的JSON数组应该以 [ 开始，以 ] 结束，并且内部元素之间用 , 分隔。
Python脚本的优化：构建并输出JSON数组
要解决这个问题，Python脚本不应在循环中逐个打印JSON对象，而应该将所有待传输的JSON数据收集到一个Python列表中，然后在循环结束后，将整个列表作为一个单一的JSON数组进行序列化并打印。
以下是优化后的Python脚本示例：
import json
# 假设 Jira 类和相关方法已定义并可正常工作
# from PyJira.Jira import Jira
if __name__ == "__main__":
# jira = Jira() # 实例化Jira类
output_data_list = [] # 创建一个空列表，用于收集所有JSON数据
# 模拟获取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': 'Unassigned'})})})(),
]
for issue in jql_issues:
data_item = {
'key': issue.key,
'assignee': issue.fields.assignee.display_name
}
# 将每个字典直接添加到列表中，而不是将其转换为JSON字符串
output_data_list.append(data_item)
# 循环结束后，将整个列表序列化为一个JSON数组字符串并打印
print(json.dumps(output_data_list))
# exit() # 在脚本末尾通常不需要显式调用exit()关键改进点：
- output_data_list = []: 初始化一个空列表。
- output_data_list.append(data_item): 在循环内部，将每个构造好的Python字典（即单个JSON对象的数据结构）直接添加到 output_data_list 中。
- print(json.dumps(output_data_list)): 在循环外部，一次性地将整个 output_data_list 序列化为一个JSON字符串。此时，output_data_list 是一个包含多个字典的列表，json.dumps() 会将其转换为一个标准的JSON数组字符串，例如 [{"key": "SWAT-107", "assignee": "Unassigned"}, {"key": "SWAT-98", "assignee": "Unassigned"}]。
PHP端的解析与处理
当Python脚本正确地输出一个JSON数组字符串后，PHP端接收到的将是一个完整的、合法的JSON数组字符串。此时，我们需要进行两次 json_decode() 操作来完整解析数据。
以下是优化后的PHP代码示例：
";
exit;
}
// 遍历这个PHP数组，对每个元素进行第二次解码
if (is_array($decoded_array_of_json_strings)) {
foreach ($decoded_array_of_json_strings as $json_item_string) {
// 第二次解码：将每个内部的JSON字符串解码为PHP关联数组
// 传入 true 参数，确保解码为关联数组而非对象
$jira_data = json_decode($json_item_string, true);
// 检查第二次解码是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
echo "第二次JSON解码失败: " . json_last_error_msg() . " (数据: " . htmlspecialchars($json_item_string) . ")
";
continue; // 跳过当前错误项
}
// 现在可以像访问普通PHP关联数组一样访问数据了
if (is_array($jira_data)) {
echo "Key: " . htmlspecialchars($jira_data['key']) . " - Assignee: " . htmlspecialchars($jira_data['assignee']) . "
";
} else {
echo "解码后的数据不是数组: " . htmlspecialchars($json_item_string) . "
";
}
}
} else {
echo "Python脚本返回的不是一个有效的JSON数组: " . htmlspecialchars($python_output_json_string) . "
";
}
?>关键改进点：
-
$decoded_array_of_json_strings = json_decode($python_output_json_string);:
- shell_exec() 返回的 $python_output_json_string 现在是一个标准的JSON数组字符串。
- 第一次 json_decode() 会将其转换为一个PHP数组。这个PHP数组的每个元素仍然是一个JSON字符串（例如 '{"key": "SWAT-107", "assignee": "Unassigned"}'），而不是PHP关联数组或对象。
-
$jira_data = json_decode($json_item_string, true);:
- 在 foreach 循环中，对 decoded_array_of_json_strings 的每个元素（即每个内部的JSON字符串）再次调用 json_decode()。
- 传入 true 作为第二个参数至关重要。这会强制 json_decode() 将JSON对象解码为PHP关联数组（array('key' => 'SWAT-107')），而不是默认的PHP标准对象（stdClass）。使用关联数组通常在PHP中处理数据更为方便。
关键点与注意事项
- Python端统一输出： 确保Python脚本只进行一次 print() 操作，且输出的是一个完整的、合法的JSON结构（无论是单个JSON对象还是JSON数组）。
-
PHP端两次解码： 当Python返回的是一个包含多个JSON对象的JSON数组时，PHP需要分两步解码：
- 解码外部的JSON数组结构。
- 循环解码数组内部的每个JSON字符串。
- json_decode() 的 associative 参数： 在PHP中，json_decode($json_string, true) 会将JSON对象转换为PHP关联数组，而 json_decode($json_string)（或 json_decode($json_string, false)）会将其转换为PHP标准对象。根据您的偏好选择。通常，关联数组在PHP中更灵活。
- 错误处理： 务必在每次 json_decode() 后检查 json_last_error() 或 json_last_error_msg()，以便及时发现并处理JSON解析错误。这对于调试和生产环境的健壮性至关重要。
- Python脚本执行环境： pipenv run py PyJira/Jira.py 这种方式确保Python脚本在其隔离的虚拟环境中运行，这有助于管理依赖并避免版本冲突。在生产环境中，请确保PHP执行用户有权限访问并执行该Python脚本。
- 安全性： 如果Python脚本的输入来源于用户，或者其输出可能包含敏感信息，请务必进行适当的输入验证、输出过滤和权限控制。
总结
通过以上优化，我们成功地解决了Python脚本向PHP返回多个JSON对象时的解析难题。核心在于Python端将所有数据封装成一个标准的JSON数组字符串一次性输出，而PHP端则通过分步解码，精确地将外部数组结构和内部JSON对象转换为可操作的PHP数据类型。这种方法不仅保证了数据传输的准确性，也提升了代码的可维护性和健壮性。
