PHP中返回JSON需正确编码并设置响应头：一、用json_encode()配合header()；二、封装统一响应函数；三、结合PDO预处理返回结构化数据；四、用http_response_code()设HTTP状态码；五、通过服务器配置自动处理。
如果在PHP中执行增删改查操作后需要将结果以JSON格式返回给前端或其他客户端，则必须确保数据正确编码并设置合适的HTTP响应头。以下是实现此目标的多种方法：
一、使用json_encode()函数配合header()设置响应头
该方法通过手动设置Content-Type为application/json，并调用json_encode()将PHP数组或对象转换为JSON字符串，是最基础且广泛兼容的方式。
1、在PHP脚本开头添加header('Content-Type: application/json; charset=utf-8');。
2、构建包含操作结果的数据数组，例如：$result = ['code' => 200, 'message' => 'success', 'data' => $rows];。
立即学习“PHP免费学习笔记（深入）”；
3、调用echo json_encode($result, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);输出JSON字符串。
4、确保脚本中无任何额外输出（如空格、BOM头、echo前的空白），否则会导致JSON解析失败。
二、封装统一的JSON响应函数
为避免重复编写header和json_encode逻辑，可定义一个可复用的响应函数，提升代码可维护性与一致性。
1、定义函数function jsonResponse($code, $message, $data = null) { header('Content-Type: application/json; charset=utf-8'); echo json_encode(['code' => $code, 'message' => $message, 'data' => $data], JSON_UNESCAPED_UNICODE); exit; }。
2、在增删改查逻辑完成后直接调用jsonResponse(200, 'insert success', $insert_id);。
3、对错误情形同样调用，例如jsonResponse(400, 'invalid input', null);。
三、结合PDO预处理语句返回结构化JSON
当使用PDO执行数据库操作时，可在事务提交后将影响行数、插入ID或查询结果集统一打包为JSON响应，增强接口可靠性。
1、执行INSERT后使用$pdo->lastInsertId()获取新记录ID，并存入响应数组。
2、执行UPDATE或DELETE后使用$statement->rowCount()获取受影响行数，并判断是否为0来设定code值。
3、执行SELECT后使用fetchAll(PDO::FETCH_ASSOC)获取关联数组，直接作为data字段传入json_encode()。
4、统一使用json_encode($response, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)便于调试，上线时移除JSON_PRETTY_PRINT。
四、使用PHP内置的http_response_code()配合JSON输出
该方法不仅返回JSON内容，还同步设置标准HTTP状态码，使接口更符合RESTful规范，便于前端识别请求结果类型。
1、根据操作结果调用http_response_code(200)、http_response_code(201)或http_response_code(404)等。
2、构造响应数组时，code字段应与HTTP状态码保持一致或语义对应，例如201创建成功时，code设为201而非200。
3、调用json_encode()前确保未开启output_buffering或已清除输出缓冲，防止header已发送警告。
4、在脚本末尾使用exit或die()终止后续执行，避免意外输出干扰JSON结构。
五、通过PHP-FPM或Apache配置自动处理JSON输出
在服务器层面统一拦截.php文件的JSON类响应，减少每个脚本中重复的header设置，适用于大型项目或微服务网关场景。
1、在Apache的.htaccess中添加AddType application/json .jsonphp，并将PHP脚本重写为.jsonphp后缀。
2、在Nginx配置中匹配location ~ \.jsonphp$ { include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_pass 127.0.0.1:9000; }。
3、在PHP脚本中仅输出纯json_encode()结果，不调用header()，由Web服务器自动注入Content-Type。
4、需确保PHP脚本输出前无任何echo、print、空行或BOM字符，否则JSON将被破坏。
