如何优雅的兼容旧项目 URL/路由

[huangdijia]

前提

• 没有服务器（Nginx）权限
• 或 运维不乐意帮忙（开个玩笑）

需求

旧项目中请求链接为传统的方式：

/?c=foo&a=bar

新项目路由是：

/foo/bar

思路

• 通过中间件实现路由 mapping
• 需要重写 CoreMiddleware::dispatch() 方法

代码

• 需要重写 CoreMiddleware::dispatch() 方法

namespace App\Middleware;

use Hyperf\HttpServer\Router\Dispatched;
use Hyperf\Utils\Context;
use Psr\Http\Message\ServerRequestInterface;

class CoreMiddleware extends \Hyperf\HttpServer\CoreMiddleware
{
    public function dispatch(ServerRequestInterface $request): ServerRequestInterface
    {
        // 关键代码 start
        $path = $request->getUri()->getPath();
        $queryParams = $request->getQueryParams();

        // 替换条件
        if ($path == '/' && (isset($queryParams['c']) || isset($queryParams['a']))) {
            // 替换 path
            $path = sprintf(
                '/%s/%s',
                $queryParams['c'] ?? 'index',
                $queryParams['a'] ?? 'index'
            );

            // 看需要 unset 请求参数
            if (isset($queryParams['c'])) {
                unset($queryParams['c']);
            }
            if (isset($queryParams['a'])) {
                unset($queryParams['a']);
            }

            $request = $request->withUri($request->getUri()->withPath($path)); // 替换 path
            $request = $request->withQueryParams($queryParams); // 替换请求参数
        }
        // 关键代码 end

        return parent::dispatch($request);
    }
}

• 依赖置换

// config/dependencies.php

return [
    Hyperf\HttpServer\CoreMiddleware::class => App\Middleware\CoreMiddleware::class,
];

[limingxinleo]

$request = $request->withQueryParams($queryParams);

代码要改成这样，不然你没办法 unset 掉请求参数