sojf/routing

Sojf Routing Component

路由类库（Routing）

本路由类库最终目的只是提供路由编译结果，拿到结果后可以按实际需求开发。, _(*1)

安装

``` php composer require sojf/routing, <sub>(*2)</sub>

## 快速例子：
```php
// 使用composer自动加载
require 'vendor/autoload.php';

use Sojf\Routing\Route;
use Sojf\Routing\Compiler;
use Sojf\Routing\Compiled;

// 设置路由
$route = new Route('NORM:/api-(?<token>\w*)', 'Blog@user');

$compiler = new Compiler(); // 实例化编译器
$compiled = new Compiled(); // 实例化编译结果存储对象

$result = $compiler
    ->setRoute($route) // 设置要编译的路由
    ->setCompiled($compiled) // 设置编译结果存储类
    ->compile(); // 执行路由编译

print_r($result);
/*
Sojf\Routing\Compiled Object
(
    [appName:protected] => blog
    [routePath:protected] => /api-(?<token>\w*)
    [routePathRegexp:protected] => ~^/api-(?<token>\w*)$~iu
    [controllerMethod:protected] => user
    [controller:protected] => app\Controller\Blog
    [viewNameSpace:protected] => app\View
    [modelNameSpace:protected] => app\Model
    [routeType:protected] => NORM
    [matchRes:protected] => Array
        (
        )

    [hasCaptureVar] => 
)
*/

// 获取路由匹配正则表达式
$reg = $result->getRoutePathRegexp();

// 假设这是当前请求路由
$requestUlr = '/api-3bbe1210b';

// 执行匹配
preg_match($reg, $requestUlr, $matches);

if ($matches) {
    echo '路由配置成功, 接着执行其它逻辑', '<br>', PHP_EOL;
    print_r($matches);
    /*
        Array
        (
            [0] => /api-3bbe1210b
            [token] => 3bbe1210b
            [1] => 3bbe1210b
        )
    */
} else {
    echo '路由匹配失败';
}

web开发，离不开http协议，http协议抽象化后可得出2个概念: 请求 响应。 路由处理的便是http请求，具体来说，路由处理http请求中的URL部分。 本路由类库有三个概念：路由类型，路由规则，路由目标。, <sub>(*3)</sub>

• 路由类型：用来区分不同使用场景
• 路由规则：用来匹配判断当前请求URL
• 路由目标：当请求URL匹配成功后，需要执行的目标（通常是控制器的方法）

路由规则：

• 路由规则 == 正则表达式 == 请求URL
• 作用是判断当前请求URL是否和路由规则匹配

路由规则例子:

捕获变量：

如何获取当前请求URL中的值？ 由于路由规则就是正则表达式，所以可以使用正则子组，为了方便使用这个子组， 还可以给子组命名，这样便可以在正则匹配结果中获取的到，然后进行你下一步的操作。, <sub>(*4)</sub>

路由类型：

路由类型，用来区分不同使用场景。 需要说明的是，本路由类库最终目的只是提供路由编译结果，拿到结果后可以按实际需求开发，如不适合，完全可以替换掉。 下面是默认的路由类型，主要用于自己的框架，供大家参考。, <sub>(*5)</sub>

本类库主要有四个类：

• Route（定义路由信息）
• Collection（路由信息集合）
• Compiler（路由编译类，输出编译结果对象）
• Compiled（存储路由编译后信息，供其它类使用，进行下一步操作）

Route类

构造函数：, <sub>(*6)</sub>

例子1:, <sub>(*7)</sub>

// 使用composer自动加载
require 'vendor/autoload.php';

// 创建路由信息对象
$route = new Sojf\Routing\Route('NORM:/user', 'UserController@detailsMethod', 'html|shtml', 'routeName');
 ```

例子2: 
```php
// 使用composer自动加载
require 'vendor/autoload.php';

// 实例化路由信息对象
$route = new Sojf\Routing\Route();

// 设置路由信息
$route->setScheme('NORM:/api-(?<token>\w*)')
      ->setController('Blog@user')
      ->setSuffix('html|shtml')
      ->setRouteName('routeName');

Collection类

如果有很多路由，可以使用Collection对象来存储路由, <sub>(*8)</sub>

• 注：Collection类没有构造方法

例子:, <sub>(*9)</sub>

// 使用composer自动加载
require 'vendor/autoload.php';

// 实例化路由编译器
$compiler = new Sojf\Routing\Compiler();

// 实例话路由编译结果存储类
$compiled = new Sojf\Routing\Compiled();

// 实例化路由集合
$collection = new Sojf\Routing\Collection();

// 路由配置
$routes = array(
    array('scheme' => 'NORM:/user', 'controller' => 'Blog@user'),
    array('scheme' => 'NORM:/user', 'controller' => 'Blog@user'),
    array('scheme' => 'NORM:/user', 'controller' => 'Blog@user')
);

// 批量添加路由到集合中
$collection->conf($routes);

// 假设这是当前请求URL
$requestUrl = '/user';

// 遍历路由集合，匹配当前请求URL
foreach ($collection as $name => $route) {

    // 设置要编译的路由对象
    $compiler->setRoute($route);

    // 设置编译结果存储对象
    $compiler->setCompiled($compiled);

    // 开始编译路由对象
    $compiled = $compiler->compile();

    // 判断当前请求是否和路由匹配
    if (!preg_match($compiled->getRoutePathRegexp(), $requestUrl, $matches)) {
        // 没有匹配到路由，继续遍历路由集合
        continue;
    } else {

        /*
         * 匹配到当前请求对应的路由
         * 保存匹配结果
         * */
        $compiled->setMatchRes($matches);

        // 业务逻辑 。。
        print_r($compiled);

        break;
    }
}
 ```

### Compiler类
Compiler类负责对路由信息进行处理，并输出处理结果，其最主要作用是生成路由匹配正则表达式。
默认Compiler类实现了应用名，控制器，控制器方法，模型命名空间，视图命名控制等等功能编译，如果一时不懂，可以看源码即可。
默认Compiler类的实现主要是用于自己框架。如不适合，可自行替换掉Compiler类。

| **方法** | **参数** | **返回值** | **说明** |
| ------------ | ------------ | ------------ | ------------ |
| setRoute | `RouteInterface $route` | `$this` | 设置要编译的路由信息对象
| setCompiled | `CompiledInterface $compiled` | `$this` | 设置编译结果存储对象
| compile | 无 | `Compiled` 对象 | 编译路由信息，并返回编译结果对象
| getCompiled | 无 | `Compiled` 对象| 获取编译结果对象
| getRoute | 无 | `Route` 对象| 获取路由信息对象

例子：
```php
// 使用composer自动加载
require 'vendor/autoload.php';

use Sojf\Routing\Route;
use Sojf\Routing\Compiler;
use Sojf\Routing\Compiled;

// 设置路由
$route = new Route('NORM:/api-(?<token>\w*)', 'Blog@user');

$compiler = new Compiler(); // 实例化编译器
$compiled = new Compiled(); // 实例化编译结果存储对象

$result = $compiler
    ->setRoute($route) // 设置要编译的路由
    ->setCompiled($compiled) // 设置编译结果存储类
    ->compile(); // 执行路由编译

print_r($result);
/*
Sojf\Routing\Compiled Object
(
    [appName:protected] => blog
    [routePath:protected] => /api-(?<token>\w*)
    [routePathRegexp:protected] => ~^/api-(?<token>\w*)$~iu
    [controllerMethod:protected] => user
    [controller:protected] => app\Controller\Blog
    [viewNameSpace:protected] => app\View
    [modelNameSpace:protected] => app\Model
    [routeType:protected] => NORM
    [matchRes:protected] => Array
        (
        )

    [hasCaptureVar] => 
)
*/

// 获取路由匹配正则表达式
$reg = $result->getRoutePathRegexp();

// 假设这是当前请求路由
$requestUlr = '/api-3bbe1210b';

// 执行匹配
preg_match($reg, $requestUlr, $matches);

if ($matches) {
    echo '路由配置成功, 接着执行其它逻辑', '<br>', PHP_EOL;
    print_r($matches);
    /*
        Array
        (
            [0] => /api-3bbe1210b
            [token] => 3bbe1210b
            [1] => 3bbe1210b
        )
    */
} else {
    echo '路由匹配失败';
}

Compiled类

Compiled类，主要用来保存编译结果，供后续逻辑使用。 默认Compiled类的实现主要是用于自己框架。如不适合，可自行替换掉Compiled类。, <sub>(*10)</sub>