QueryPHP

Appearance

Router ​

Testing Is Documentation

tests/Router/RouterTest.php

路由是整个框架一个非常重要的调度组件，完成从请求到响应的完整过程，通常我们使用代理 \Leevel\Router\Proxy\Router 类进行静态调用。

路有服务提供者

路由服务是系统核心服务，会在系统初始化时通过路由服务提供者注册。

php
namespace App\Infra\Provider;

use App\Auth\Middleware\Auth;
use Leevel\Router\RouterProvider;
use Leevel\Session\Middleware\Session;

class Router extends RouterProvider
{
    /**
     * 控制器相对目录.
     */
    protected ?string $controllerDir = 'Controller';

    /**
     * 应用是否带有默认应用命名空间.
     */
    protected bool $withDefaultAppNamespace = true;

    /**
     * 中间件分组.
     *
     * - 分组可以很方便地批量调用组件.
     */
    protected array $middlewareGroups = [
        // web 请求中间件
        'web' => [
            'session',
        ],

        // api 请求中间件
        'api' => [],
    ];

    /**
     * 中间件别名.
     *
     * - HTTP 中间件提供一个方便的机制来过滤进入应用程序的 HTTP 请求.
     * - 例外在应用执行结束后响应环节也会调用 HTTP 中间件.
     */
    protected array $middlewareAlias = [
        'auth' => Auth::class,
        'session' => Session::class,
    ];

    /**
     * 基础路径.
     */
    protected array $basePaths = [
        'api/demo' => [
            'middlewares' => 'api',
        ],
        'apiQL/v*' => [
            'middlewares' => 'auth',
        ],
        '/app:*/apiQL/v*' => [
            'middlewares' => 'auth',
        ],
    ];

    /**
     * 分组.
     */
    protected array $groups = [
        'pet' => [],
        'store' => [],
        'user' => [],
        '/apiQL/v1' => [
            'middlewares' => 'api',
        ],
        'apiQL/v2' => [
            'middlewares' => 'api',
        ],
        '/web/v1' => [
            'middlewares' => 'web',
        ],
        'web/v2' => [
            'middlewares' => 'web',
        ],
    ];

    /**
     * {@inheritDoc}
     */
    public function bootstrap(): void
    {
        parent::bootstrap();
    }

    /**
     * {@inheritDoc}
     */
    public function getRouters(): array
    {
        return parent::getRouters();
    }
}

Uses

php
<?php

use Leevel\Di\Container;
use Leevel\Http\Request;
use Leevel\Kernel\Utils\Api;
use Leevel\Router\IRouter;
use Leevel\Router\Router;
use Leevel\Router\RouterNotFoundException;
use PHPUnit\Framework\Attributes\DataProvider;
use Symfony\Component\HttpFoundation\ParameterBag;
use Symfony\Component\HttpFoundation\Response;
use Tests\Router\Middlewares\Demo1;
use Tests\Router\Middlewares\Demo2;
use Tests\Router\Middlewares\Demo3;
use Tests\Router\Middlewares\DemoForGroup;

基本使用 ​

fixture 定义

Tests\Router\Controllers\Home

php
namespace Tests\Router\Controllers;

class Home
{
    public function index(): string
    {
        return 'hello my home';
    }
}
php
public function testBaseUse(): void
{
    $pathInfo = '/app:tests';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello my home', $result->getContent());
}

控制器方法单独成为类 ​

方法类的方法固定为 handle，返回响应结果。

fixture 定义

Tests\Router\Controllers\Hello\ActionClass

php
namespace Tests\Router\Controllers\Hello;

class ActionClass
{
    public function handle(): string
    {
        return 'hello action class';
    }
}
php
public function testActionAsClass(): void
{
    $pathInfo = '/app:tests/hello/actionClass';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello action class', $result->getContent());
}

控制器方法支持短横线和下换线转换为驼峰规则 ​

fixture 定义

Tests\Router\Controllers\Hello\ActionConvertFooBar

php
namespace Tests\Router\Controllers\Hello;

class ActionConvertFooBar
{
    public function handle(): string
    {
        return 'hello action convert foo bar';
    }
}
php
public function testActionConvert(): void
{
    $pathInfo = '/app:tests/hello/action_convert-foo_bar';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello action convert foo bar', $result->getContent());
}

控制器支持短横线和下换线转换为驼峰规则 ​

fixture 定义

Tests\Router\Controllers\ControllerConvertFooBar

php
namespace Tests\Router\Controllers;

class ControllerConvertFooBar
{
    public function bar(): string
    {
        return 'hello controller convert';
    }
}
php
public function testControllerConvert(): void
{
    $pathInfo = '/app:tests/controller_convert-foo_bar/bar';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello controller convert', $result->getContent());
}

控制器支持子目录 ​

控制器子目录支持无限层级。

fixture 定义

Tests\Router\Controllers\Sub\World

php
namespace Tests\Router\Controllers\Sub;

class World
{
    public function foo()
    {
        return 'hello sub world foo';
    }
}
php
public function testSubControllerDir(): void
{
    $pathInfo = '/app:tests/sub/world/foo';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello sub world foo', $result->getContent());
}

控制器子目录支持短横线和下换线转换为驼峰规则 ​

fixture 定义

Tests\Router\Controllers\Sub\World

php
namespace Tests\Router\Controllers\Sub;

class World
{
    public function foo()
    {
        return 'hello sub world foo';
    }
}
php
public function testConvertAll(): void
{
    $this->expectException(RouterNotFoundException::class);
    $this->expectExceptionMessage(
        'The router Tests\\Router\\Controllers\\HeLloWor\\Bar\\Foo\\XYYAc\\ControllerXxYy::actionXxxYzs() was not found.'
    );

    $pathInfo = '/app:tests/he_llo-wor/Bar/foo/xYY-ac/controller_xx-yy/action-xxx_Yzs';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $router->dispatch($request);
}

可以转换为 JSON 的控制器响应 ​

fixture 定义

Tests\Router\Controllers\ShouldJson

php
namespace Tests\Router\Controllers;

class ShouldJson
{
    public function index(): array
    {
        return ['foo' => 'bar'];
    }
}
php
public function testShouldJson(): void
{
    $pathInfo = '/app:tests/should_json';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('{"foo":"bar"}', $result->getContent());
}

不可以转换为 JSON 的控制器响应强制转化为字符串 ​

fixture 定义

Tests\Router\Controllers\Response\IntResponse

php
namespace Tests\Router\Controllers\Response;

class IntResponse
{
    public function handle(): int
    {
        return 123456;
    }
}
php
public function testResponseIsInt(): void
{
    $pathInfo = '/app:tests/Response/IntResponse';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('123456', $result->getContent());
}

RESTFUL 控制器响应 ​

fixture 定义

测试类型例子

php
# Tests\Router\RouterTest::getRestfulData
public static function getRestfulData(): array;

Tests\Router\Controllers\Restful\Show

php
namespace Tests\Router\Controllers\Restful;

use Leevel\Router\IRouter;

class Show
{
    public function handle(): string
    {
        return 'hello for restful '.IRouter::RESTFUL_SHOW;
    }
}

Tests\Router\Controllers\Restful\Store

php
namespace Tests\Router\Controllers\Restful;

use Leevel\Router\IRouter;

class Store
{
    public function handle(): string
    {
        return 'hello for restful '.IRouter::RESTFUL_STORE;
    }
}

Tests\Router\Controllers\Restful\Update

php
namespace Tests\Router\Controllers\Restful;

use Leevel\Router\IRouter;

class Update
{
    public function handle(): string
    {
        return 'hello for restful '.IRouter::RESTFUL_UPDATE;
    }
}

Tests\Router\Controllers\Restful\Destroy

php
namespace Tests\Router\Controllers\Restful;

use Leevel\Router\IRouter;

class Destroy
{
    public function handle(): string
    {
        return 'hello for restful '.IRouter::RESTFUL_DESTROY;
    }
}
php
public function testRestful(string $method, string $action): void
{
    $pathInfo = '/app:tests/restful/5';
    $attributes = [];
    $method = $method;
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello for restful '.$action, $result->getContent());
}

RESTFUL 控制器响应指定方法 ​

fixture 定义

Tests\Router\Controllers\Restful\Action

php
namespace Tests\Router\Controllers\Restful;

use Leevel\Router\IRouter;

class Action
{
    public function handle(): string
    {
        return 'hello action for restful '.IRouter::RESTFUL_SHOW;
    }
}
php
public function testRestful2(): void
{
    $pathInfo = '/app:tests/restful/5/action';
    $attributes = [];
    $method = 'get';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello action for restful show', $result->getContent());
}

setPreRequestMatched 设置路由请求预解析结果 ​

fixture 定义

Tests\Router\Controllers\PreRequestMatched\Prefix\Bar\Foo

php
namespace Tests\Router\Controllers\PreRequestMatched\Prefix\Bar;

class Foo
{
    public function handle(): string
    {
        return 'hello preRequestMatched';
    }
}
php
public function testSetPreRequestMatched(): void
{
    $pathInfo = '';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setPreRequestMatched($request, [
        IRouter::APP => 'Tests',
        IRouter::CONTROLLER => 'Bar',
        IRouter::ACTION => 'foo',
        IRouter::PREFIX => 'PreRequestMatched\\Prefix',
        IRouter::ATTRIBUTES => null,
        IRouter::MIDDLEWARES => null,
        IRouter::VARS => null,
    ]);
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello preRequestMatched', $result->getContent());
}

穿越中间件 ​

fixture 定义

Tests\Router\Controllers\Hello\ThroughMiddleware

php
namespace Tests\Router\Controllers\Hello;

class ThroughMiddleware
{
    public function handle(): string
    {
        return 'hello throughMiddleware';
    }
}

Tests\Router\Middlewares\Demo1

php
namespace Tests\Router\Middlewares;

use Leevel\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class Demo1
{
    public function terminate(\Closure $next, Request $request, Response $response): void
    {
        $GLOBALS['demo_middlewares'][] = 'Demo1::terminate';
        $next($request, $response);
    }
}

Tests\Router\Middlewares\Demo2

php
namespace Tests\Router\Middlewares;

use Leevel\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class Demo2
{
    public function handle(\Closure $next, Request $request): Response
    {
        $GLOBALS['demo_middlewares'][] = 'Demo2::handle';

        return $next($request);
    }

    public function terminate(\Closure $next, Request $request, Response $response): void
    {
        $GLOBALS['demo_middlewares'][] = 'Demo2::terminate';
        $next($request, $response);
    }
}

Tests\Router\Middlewares\Demo3

php
namespace Tests\Router\Middlewares;

use Leevel\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class Demo3
{
    public function handle(\Closure $next, Request $request, int $arg1 = 1, string $arg2 = 'hello'): Response
    {
        $GLOBALS['demo_middlewares'][] = sprintf('Demo3::handle(arg1:%s,arg2:%s)', $arg1, $arg2);

        return $next($request);
    }
}

Tests\Router\Middlewares\DemoForGroup

php
namespace Tests\Router\Middlewares;

use Leevel\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class DemoForGroup
{
    public function handle(\Closure $next, Request $request): Response
    {
        $GLOBALS['demo_middlewares'][] = 'DemoForGroup::handle';

        return $next($request);
    }

    public function terminate(\Closure $next, Request $request, Response $response): void
    {
        $GLOBALS['demo_middlewares'][] = 'DemoForGroup::terminate';
        $next($request, $response);
    }
}
php
public function testThroughMiddleware(): void
{
    $pathInfo = '/app:tests/hello/throughMiddleware';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setMiddlewareGroups([
        'group1' => [
            'demo1',
            'demo2',
        ],
        'group2' => [
            'demo1',
            'demo3:10,world',
        ],
        'group3' => [
            'demo1',
            'demo2',
            'demo3:10,world',
        ],
    ]);

    $router->setMiddlewareAlias([
        'demo1' => Demo1::class,
        'demo2' => Demo2::class,
        'demo3' => Demo3::class,
        'demoForGroup' => DemoForGroup::class,
    ]);

    $router->setBasePaths([
        '*' => [
            'middlewares' => [
                'handle' => [
                    Demo2::class.'@handle',
                ],
                'terminate' => [
                    Demo1::class.'@terminate',
                    Demo2::class.'@terminate',
                ],
            ],
        ],
        '/^\\/app:tests\/hello\/throughMiddleware\\/$/' => [
            'middlewares' => [
                'handle' => [
                    Demo3::class.':10,hello@handle',
                ],
            ],
        ],
        '/^\\/app:tests(\\S*)\\/$/' => [
            'middlewares' => [
                'handle' => [
                    DemoForGroup::class.'@handle',
                ],
                'terminate' => [
                    DemoForGroup::class.'@terminate',
                ],
            ],
        ],
    ]);

    $router->setControllerDir($controllerDir);

    if (isset($GLOBALS['demo_middlewares'])) {
        unset($GLOBALS['demo_middlewares']);
    }

    $result = $router->dispatch($request);
    $router->throughTerminateMiddleware($request, $result);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello throughMiddleware', $result->getContent());

    $data = <<<'eot'
        [
            "Demo2::handle",
            "Demo3::handle(arg1:10,arg2:hello@handle)",
            "DemoForGroup::handle",
            "Demo1::terminate",
            "Demo2::terminate",
            "DemoForGroup::terminate"
        ]
        eot;

    self::assertSame(
        $data,
        $this->varJson(
            $GLOBALS['demo_middlewares']
        )
    );

    unset($GLOBALS['demo_middlewares']);
}

控制器支持指定分隔路由前缀 ​

子目录支持无限层级。

fixture 定义

Tests\Router\Controllers\Api\V1\Hello\Index

php
namespace Tests\Router\Controllers\Api\V1\Hello;

class Index
{
    public function handle(): string
    {
        return 'hello api vi';
    }
}
php
public function testPrefixInController(): void
{
    $pathInfo = '/app:tests/api/v1:hello';
    $attributes = [];
    $method = 'GET';
    $controllerDir = 'Router\\Controllers';
    $request = $this->createRequest($pathInfo, $attributes, $method);
    $router = $this->createRouter();
    $router->setControllerDir($controllerDir);
    $result = $router->dispatch($request);

    $this->assertInstanceof(Response::class, $result);
    self::assertSame('hello api vi', $result->getContent());
}

MIT Licensed | Copyright © 2010-present Xiangmin Liu