thinkphp API接口返回JSON数据如何格式化-ThinkPHP-PHP中文网

thinkphp API接口返回JSON数据如何格式化

裘德小鎮的故事

发布： 2025-09-21 09:07:02

原创

391人浏览过

使用ThinkPHP开发API需统一返回格式，推荐封装result方法，通过json()函数或Response类输出标准JSON结构，避免直接输出内容破坏格式。

thinkphp api接口返回json数据如何格式化

在使用 ThinkPHP 开发 API 接口时，返回格式化的 JSON 数据是常见需求。框架本身已经集成了对 JSON 响应的良好支持，只需正确调用即可实现标准、统一的输出格式。

统一返回结构

为保证前后端交互清晰，建议定义统一的返回格式，如：

成功响应：

{
  "code": 200,
  "msg": "操作成功",
  "data": { ... }
}

登录后复制

失败响应：

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

{
  "code": 400,
  "msg": "参数错误",
  "data": null
}

登录后复制

可在控制器中封装公共方法来返回这类结构：

Find JSON Path Online

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

查看详情

// 在控制器中定义 protected function result($data, $code = 200, $msg = 'ok') { return json(['code' => $code, 'msg' => $msg, 'data' => $data]); }

使用 json() 函数直接输出

ThinkPHP 提供了 json() 辅助函数，可自动设置 Content-Type 为 application/json，并将数组转换为 JSON 字符串。

public function getUser() { $user = User::find(1); if ($user) { return json(['code' => 200, 'msg' => '获取成功', 'data' => $user]); } else { return json(['code' => 404, 'msg' => '用户不存在', 'data' => null]); } }

结合 Response 类控制输出

你也可以使用 Response 实例更精细地控制响应行为：

use think\Response; public function getInfo() { $info = ['name' => 'thinkphp', 'version' => '6.0']; return Response::create($info, 'json', 200) ->header(['Cache-Control' => 'no-cache']); }