如何在ThinkPHP中拦截请求并返回Mock数据_开发环境多态接口与网关中间件-ThinkPHP-PHP中文网

推荐使用全局中间件mockmiddleware，仅在app_debug=true且mock_enabled=true时生效，通过$request->url()匹配路径并返回json，手动设置content-type为application/json。

如何在thinkphp中拦截请求并返回mock数据_开发环境多态接口与网关中间件

ThinkPHP 6 中间件拦截请求返回 Mock 数据

开发阶段接口未就绪时，直接在中间件里截断请求、返回预设 JSON，是最轻量可控的方式。关键不是“能不能”，而是“在哪拦、怎么返、怎么不污染生产环境”。

推荐用全局中间件 + 环境开关，避免侵入业务逻辑。TP6 的中间件执行时机早于控制器，适合做路由级 Mock。

App\Middleware\MockMiddleware 是最合适的拦截点，不要塞进控制器或模型里
只在 APP_DEBUG = true 且配置了 mock_enabled = true 时生效，否则中间件直接 return $next($request)
匹配路径建议用 $request->url() 或 $request->path()，别依赖 Route::rule()，后者可能还没解析完
返回前必须手动设置 Content-Type: application/json，否则前端 fetch().json() 会失败

<?php // app/middleware/MockMiddleware.php
namespace app\middleware;

use think\Request;
use think\Response;

class MockMiddleware
{
    public function handle(Request $request, \Closure $next)
    {
        if (!config('app.debug') || !config('mock.enabled')) {
            return $next($request);
        }

        $mockMap = config('mock.routes', []);
        $path = $request->path();

        if (isset($mockMap[$path])) {
            $data = is_callable($mockMap[$path]) 
                ? $mockMap[$path]($request) 
                : $mockMap[$path];

            return Response::create($data, 'json')->header(['Content-Type' => 'application/json']);
        }

        return $next($request);
    }
}

配置 mock.routes 实现多态接口（不同参数返回不同数据）

一个 URL 对应多个响应体，比如 /api/user/123 和 /api/user/456 返回不同用户，不能靠写死数组，得支持动态解析路径和查询参数。

核心是把 mock.routes 设计成键为正则、值为闭包的结构，让匹配更灵活，也避免大量 if-else。

键必须是 PCRE 正则字符串，如 '#^api/user/(\d+)$#'，开头结尾加 # 避免转义混乱
闭包参数固定为 Request $request，从中取 $request->param()、$request->get() 或 $request->path()
不要在闭包里调用 db() 或任何真实服务，Mock 就该零依赖
配置文件里用 PHP 数组而非 YAML/JSON，TP6 原生只认 PHP 格式配置

// config/mock.php
return [
    'enabled' => true,
    'routes'  => [
        '#^api/user/(\d+)$#' => function ($request) {
            $id = $request->param(0); // 匹配第一个捕获组
            return ['code' => 0, 'data' => ['id' => (int)$id, 'name' => 'Mock User ' . $id]];
        },
        '#^api/order/list$#' => function ($request) {
            $page = $request->get('page', 1);
            return ['code' => 0, 'data' => array_fill(0, 10, ['order_no' => 'MOCK' . uniqid()])];
        },
    ],
];

为什么不用路由绑定或事件监听做 Mock

有人试过在 route/app.php 里用 Route::get('api/xxx', function(){}) 写一堆闭包，或者监听 RouteChecked 事件——这两种方式都容易出问题。

路由闭包会覆盖真实路由定义，上线前漏删一条就炸；且无法按环境自动关闭
事件监听太晚，部分中间件（如日志、权限）已经执行过了，Mock 返回后日志里仍记了一条“失败请求”
TP6 的 think\Route 在中间件之后才完成最终分发，所以中间件拦截是唯一能“彻底取消控制器执行”的位置
网关类中间件（如鉴权、限流）如果已注册，Mock 中间件必须排在其前面，否则会被拦截掉

上线前必须检查的三个地方

Mock 数据跑得再顺，只要漏掉其中一项，上线就会 500 或返回假数据。

确认 config/mock.php 没被 git 提交到生产分支，最好加到 .gitignore 里
检查中间件注册顺序：app/middleware.php 中 MockMiddleware::class 必须在 AuthMiddleware::class 之前
确保所有 Mock 闭包返回的是纯数组或标量，不要返回 Collection、Model 或 Query 实例，Response::create() 不会自动 toArray()