thinkphp接口开发中如何统一返回数据格式-ThinkPHP-PHP中文网

thinkphp接口开发中如何统一返回数据格式

下次还敢

发布： 2025-09-20 14:51:01

原创

342人浏览过

统一返回格式为：{ "code": 200, "msg": "操作成功", "data": {} }，通过封装api_return函数、使用BaseController基类的success/error方法及自定义异常处理类Handler，实现接口数据格式一致性，提升前后端协作效率与系统可维护性。

thinkphp接口开发中如何统一返回数据格式

在使用ThinkPHP进行接口开发时，统一返回数据格式能提升前后端协作效率，增强接口的可读性和维护性。通常采用固定的结构返回成功或失败信息，包括状态码、提示消息和数据内容。

定义统一返回格式结构

建议所有接口返回的数据遵循如下JSON结构：

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

说明：

code：状态码，用于表示请求结果（如200成功，400参数错误，500服务器异常）
msg：提示信息，用于前端展示给用户
data：实际返回的数据内容，成功时填充，失败时可为空

封装统一返回方法

可以在控制器基类中封装静态方法或使用助手函数来简化返回逻辑。

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

例如，在

app/common.php

登录后复制

中添加以下函数：

function api_return($code = 200, $msg = '操作成功', $data = null) { return json([ 'code' => $code, 'msg' => $msg, 'data' => $data ]); }

之后在任意控制器中调用：

如此AI写作

AI驱动的内容营销平台，提供一站式的AI智能写作、管理和分发数字化工具。

112

查看详情

class UserController extends Controller { public function info() { $user = User::find(1); if (!$user) { return api_return(404, '用户不存在'); } return api_return(200, '获取成功', $user); } }

使用控制器基类统一处理

创建一个基础控制器，如

BaseController

登录后复制

，继承

think\Controller

登录后复制

，并在其中定义返回方法：

namespace app\controller; use think\Controller; class BaseController extends Controller { protected function success($data = null, $msg = '操作成功') { return json(['code' => 200, 'msg' => $msg, 'data' => $data]); } protected function error($msg = '操作失败', $code = 400, $data = null) { return json(['code' => $code, 'msg' => $msg, 'data' => $data]); } }

子控制器继承后可直接使用：

class UserController extends BaseController { public function detail() { $user = User::find(input('id')); if (!$user) { return $this->error('用户未找到', 404); } return $this->success($user); } }

结合异常处理自动返回统一格式

通过自定义异常处理类，使系统异常也返回相同格式。

新建

app/exception/Handler.php

登录后复制

：

namespace app\exception; use think\exception\Handle; use Throwable; class Handler extends Handle { public function render($request, Throwable $e) { if ($request->isAjax() || strpos($request->header('accept'), 'application/json') !== false) { return json([ 'code' => 500, 'msg' => '系统繁忙，请稍后再试', 'data' => null ]); } return parent::render($request, $e); } }

并在