Laravel路由开发：如何基于Content-Type定义路由及同URL多控制器调用

嘿，这个需求在Laravel里完全可以实现，而且是API开发中挺常见的场景！我来给你详细说说怎么操作：

1. 自定义中间件（推荐，更优雅） #

这种方式能让你在路由层面直接通过Content-Type筛选请求，还能批量管理同类型的路由，非常适合生产环境。

步骤1：创建检查Content-Type的中间件

先通过Artisan生成中间件：

php artisan make:middleware CheckContentType

然后打开app/Http/Middleware/CheckContentType.php，修改handle方法，兼容带字符编码的Content-Type（比如application/json; charset=utf-8）：

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class CheckContentType
{
    public function handle(Request $request, Closure $next, $expectedType): Response
    {
        $requestContentType = $request->header('Content-Type');
        if (!$requestContentType || strpos($requestContentType, $expectedType) !== 0) {
            return abort(415, "Unsupported Content-Type. Expected $expectedType");
        }

        return $next($request);
    }
}

步骤2：注册中间件

打开app/Http/Kernel.php，在$routeMiddleware数组里添加这个中间件的别名：

protected $routeMiddleware = [
    // ... 其他已有的中间件
    'content-type' => \App\Http\Middleware\CheckContentType::class,
];

步骤3：在api.php中定义路由

现在你可以给同URL的路由绑定不同的Content-Type中间件，指向不同的控制器方法：

use App\Http\Controllers\JsonResourceController;
use App\Http\Controllers\XmlResourceController;

// 当Content-Type为application/json时，调用JSON控制器的store方法
Route::post('/api/resource', [JsonResourceController::class, 'store'])
    ->middleware('content-type:application/json');

// 当Content-Type为application/xml时，调用XML控制器的store方法
Route::post('/api/resource', [XmlResourceController::class, 'store'])
    ->middleware('content-type:application/xml');

// 处理不支持的Content-Type情况
Route::post('/api/resource', function () {
    return response()->json(['error' => 'Unsupported Content-Type'], 415);
});

Laravel会按路由定义的顺序匹配，符合Content-Type的路由会优先执行。

2. 路由闭包直接分发 #

如果只是单个路由需要处理，也可以直接在路由闭包里根据Content-Type分发请求，写法更简洁：

use Illuminate\Http\Request;
use App\Http\Controllers\JsonResourceController;
use App\Http\Controllers\XmlResourceController;

Route::post('/api/resource', function (Request $request) {
    $contentType = $request->header('Content-Type');

    if (strpos($contentType, 'application/json') === 0) {
        return app(JsonResourceController::class)->store($request);
    } elseif (strpos($contentType, 'application/xml') === 0) {
        return app(XmlResourceController::class)->store($request);
    }

    return response()->json(['error' => 'Unsupported Content-Type'], 415);
});

完全可以实现！上面两种方式都能满足你的需求：

• 中间件方式通过给同URL的路由绑定不同的Content-Type中间件，直接指向不同控制器的方法；
• 闭包方式则在路由内部判断Content-Type，调用对应控制器的方法。

两种方式都适用于api.php中的路由，完全可以用于生产环境。

内容的提问来源于stack exchange，提问作者D.R.