ThinkPHP8.1的withoutMiddleware怎么排除路由中间件？-ThinkPHP-PHP中文网

thinkphp8.1 中可以使用 withoutmiddleware 方法在路由定义时排除全局或组中间件。具体做法是在调用 route::get、route::post 等注册方法后，链式调用 ->withoutmiddleware()，传入需要排除的中间件类名数组。这样该特定路由将不再执行指定的中间件逻辑，而保留其他未排除的中间件。

ThinkPHP8.1的withoutMiddleware怎么排除路由中间件？

如何排除所有已注册的全局中间件？

若要完全跳过全局中间件栈，只需在 withoutMiddleware 中不传参或传入空数组（取决于版本实现，通常需显式列出或配合 middleware 覆盖）。更稳妥的做法是：先通过 Route::group 定义路由组并应用全局中间件，然后在个别路由上使用 withoutMiddleware 逐个剔除。若希望某路由彻底“裸奔”，可结合 ->middleware([]) 清空当前路由的所有中间件，再按需添加局部中间件。

ThinkPHP8.1的withoutMiddleware怎么排除路由中间件？

use thinkacadeRoute;

// 假设全局中间件为 ppmiddlewareAuth
Route::get('api/user', function () {
    return 'user info';
})->withoutMiddleware(['\app\middleware\Auth']);

// 验证：访问 /api/user 不会触发 Auth 中间件

预期结果：请求 /api/user 时，Auth 中间件的 handle 方法不会被调用，直接返回控制器响应。

如何在路由组中排除部分中间件？

当使用 Route::group 批量应用中间件时，可通过子路由的 withoutMiddleware 排除组内特定中间件。例如，组应用了 RateLimit 和 Log，但某个接口不需要限流，则在该路由上调用 withoutMiddleware(['ppmiddlewareRateLimit'])。注意：withoutMiddleware 仅移除指定中间件，其余仍生效。

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

ThinkPHP8.1的withoutMiddleware怎么排除路由中间件？

use thinkacadeRoute;

Route::group('api/v1', function () {
    Route::get('data', function () { return 'data'; });
    
    // 排除 RateLimit 中间件
    Route::get('special', function () { return 'special'; })
        ->withoutMiddleware(['\app\middleware\RateLimit']);
})->middleware(['\app\middleware\RateLimit', '\app\middleware\Log']);

// 验证：/api/v1/data 受限流和日志影响；/api/v1/special 仅受日志影响

预期结果：/api/v1/data 经过 RateLimit 和 Log；/api/v1/special 仅经过 Log，RateLimit 被排除。