PHP与Python交互中JSON数据流的正确处理姿势-php教程-PHP中文网

PHP与Python交互中JSON数据流的正确处理姿势

霞舞

发布： 2025-10-09 10:02:16

原创

372人浏览过

PHP与Python交互中JSON数据流的正确处理姿势

本文旨在解决PHP脚本调用Python脚本时，因数据格式不匹配导致JSON解析失败的问题。核心在于确保Python脚本输出的是标准JSON格式字符串（使用json.dumps并注意数据类型兼容性，如将集合转换为列表），同时PHP脚本应直接输出Python返回的JSON字符串，避免重复编码，从而实现前后端数据流的顺畅交互。

在web开发中，php作为后端语言经常需要与python脚本进行交互，例如执行复杂的计算、数据处理或调用第三方api。当python脚本处理完数据并需要将结果返回给php，进而传递给前端 javascript时，正确地处理数据格式至关重要。常见的问题是，python脚本可能返回的是其内部数据结构的字符串表示（如字典或集合），而非标准的json格式，导致php或javascript无法正确解析。

问题分析

原始场景中，用户面临的核心问题有两点：

Python脚本输出非标准JSON： Python脚本直接print了一个字典（out），其输出格式是Python字典的字符串表示，其中甚至包含了JSON不支持的集合（{}）类型，例如{'data': [{'article title', 'article description', 'timestamp', 'weburl'}], ...}。这并非一个合法的JSON字符串。
PHP脚本重复编码： PHP在接收到Python的输出后，又对其进行了json_encode()。如果Python输出的已经是JSON，这会导致双重编码；如果Python输出的不是JSON，json_encode()也无法将其转换为有效的JSON，甚至可能因为输入不是合法的JSON结构而返回null或空字符串。

JavaScript前端尝试使用JSON.parse()或JSON.stringify()处理这些非标准或双重编码的字符串时，自然会遇到解析错误。

解决方案：优化Python脚本输出

要解决此问题，首先必须确保Python脚本输出的是一个标准的JSON格式字符串。

1. 使用 json.dumps() 进行序列化

Python的 json 模块提供了 json.dumps() 函数，可以将Python对象序列化为JSON格式的字符串。这是将Python数据结构转换为JSON标准格式的关键步骤。

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

修改前 (Python):

# ...
print (out) # 直接打印Python字典的字符串表示

登录后复制

修改后 (Python):

import json
# ...
print(json.dumps(out)) # 将Python字典序列化为JSON字符串

登录后复制

2. 确保数据类型兼容JSON

JSON标准支持对象（对应Python字典）、数组（对应Python列表）、字符串、数字、布尔值和null。然而，Python中的集合（set）不是JSON标准支持的数据类型。在原始代码中，outnews 被定义为一个集合：

outnews = {html.unescape(currentNews["timestamp"]), html.unescape(currentNews["title"]), html.unescape(currentNews["description"]), html.unescape(currentNews["link"])}

登录后复制

当 json.dumps() 尝试序列化包含集合的Python对象时，会抛出 TypeError。因此，需要将集合转换为JSON兼容的类型，最常见的是列表（list）。

修改前 (outnews):

outnews = {html.unescape(currentNews["timestamp"]), html.unescape(currentNews["title"]), html.unescape(currentNews["description"]), html.unescape(currentNews["link"])} # 这是一个集合

登录后复制

修改后 (outnews):

outnews = [html.unescape(currentNews["timestamp"]), html.unescape(currentNews["title"]), html.unescape(currentNews["description"]), html.unescape(currentNews["link"])] # 这是一个列表

登录后复制

完整的Python脚本优化示例：

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

#!/usr/bin/python
import requests
import json
import html
import sys

requestpost = requests.post('NewsSource')
response_data = requestpost.json()

data = []
status = 0
answers = 0
out = {"data":[], "status":[], "answers":[0]}

searchterm = sys.argv[1]

error = 0

if requestpost.status_code == 200:
    out["status"] = 200
    for news in response_data["news"]:
        try:
            currentNews = json.loads(news)
            if ((html.unescape(currentNews["title"]) != "Array" and html.unescape(currentNews["title"]).lower().find(searchterm.lower()) != -1) or (html.unescape(currentNews["description"]).lower().find(searchterm.lower()) != -1)):
                # 将集合改为列表，以兼容JSON
                outnews = [
                    html.unescape(currentNews["timestamp"]),
                    html.unescape(currentNews["title"]),
                    html.unescape(currentNews["description"]),
                    html.unescape(currentNews["link"])
                ]
                out["data"].append(outnews)
                out["answers"][0] = out["answers"][0] + 1
        except Exception as e: # 捕获更具体的异常
            error += 1
            # print(f"Error processing news item: {e}", file=sys.stderr) # 调试信息
else:
    out["status"] = 404

# 使用 json.dumps() 将Python对象序列化为JSON字符串
print(json.dumps(out))

登录后复制

解决方案：优化PHP脚本处理

一旦Python脚本能够输出合法的JSON字符串，PHP脚本就不需要再对其进行额外的json_encode()处理了。

1. 直接输出Python脚本的JSON结果

PHP的shell_exec()函数会返回命令的完整输出。如果Python脚本已经输出了JSON，PHP只需直接echo这个字符串即可。

修改前 (PHP):

// ...
$output = json_encode(shell_exec($command)); // 错误：对已是字符串的JSON再次编码
header('Content-type: application/json');
echo $output;

登录后复制

修改后 (PHP - 方案一：使用 shell_exec):

<?php
    if ($_GET['times'] == 0) {
        $command = escapeshellcmd('python3 feed.py '. $_GET['subject']);
        $output = shell_exec($command); // 获取Python脚本的JSON输出

        header('Content-type: application/json');
        echo $output; // 直接输出，不再进行json_encode
    }
?>

登录后复制

2. 使用 passthru() 优化输出（可选）

passthru() 函数直接将命令的原始输出传递给浏览器，这在处理大量数据流时可能比shell_exec()更高效，因为它不需要将整个输出加载到PHP变量中。

修改后 (PHP - 方案二：使用 passthru):

<?php
    if ($_GET['times'] == 0) {
        $command = escapeshellcmd('python3 feed.py '. $_GET['subject']);
        header('Content-type: application/json'); // 必须在passthru之前设置Content-type
        passthru($command); // 直接将Python脚本的输出传递给客户端
    }
?>

登录后复制

无论选择哪种PHP方案，关键都是避免对Python已经输出的JSON字符串进行二次编码。header('Content-type: application/json'); 这行代码是必不可少的，它告诉客户端响应体是JSON格式，有助于浏览器或JavaScript正确处理。

JavaScript前端处理

在PHP后端正确返回JSON数据后，JavaScript前端的接收和解析将变得非常简单和标准。

// 假设后端接口是 /api/data.php?subject=example&times=0
fetch('/api/data.php?subject=example&times=0')
    .then(response => {
        if (!response.ok) {
            throw new Error('Network response was not ok');
        }
        return response.json(); // 直接解析为JavaScript对象
    })
    .then(data => {
        console.log('Parsed JSON data:', data);
        // 现在 'data' 就是一个标准的JavaScript对象，可以直接访问其属性
        console.log('Status:', data.status);
        console.log('First article title:', data.data[0][1]); // 假设是列表中的第二个元素
    })
    .catch(error => {
        console.error('There was a problem with the fetch operation:', error);
    });

登录后复制

response.json() 方法会自动处理接收到的JSON字符串并将其解析为JavaScript对象，无需手动调用 JSON.parse()。

总结与注意事项

数据格式统一： 在跨语言或跨系统通信时，始终确保数据在传输过程中遵循统一的标准格式，JSON是理想选择。
Python端序列化： 使用 json.dumps() 将Python对象转换为JSON字符串，并确保所有数据类型都兼容JSON标准（例如，将Python集合转换为列表）。
PHP端直传： 当Python脚本已经输出JSON字符串时，PHP应直接输出该字符串，避免使用 json_encode() 进行重复编码。
HTTP头设置： 在PHP中，务必设置 header('Content-type: application/json');，告知客户端响应内容的类型。
错误处理： 在Python脚本中增加更健壮的错误处理机制，例如使用 try-except 捕获异常并记录日志，或者在JSON输出中包含错误信息。PHP和JavaScript端也应有相应的错误处理逻辑。
安全性： 在PHP中调用外部命令时，务必使用 escapeshellcmd() 对命令参数进行转义，以防止命令注入攻击。