【Fizzday02】构建显式路由分发网络, 完善框架结构

2016-04-25 本文已影响13811人 fizzday

万丈高楼平地起, 再牛框架路由始

通过这句话, 就可以看出路由的作用有多大.
由于过往接触的框架(如: CodeIgniter(CI3.x), ThinkPHP(TP3.x)) 的路由默认都是隐式的, 何为"隐式", 简单的讲就是"隐藏"起来了(自动路由), 我们直接使用, 不用去管路由. 所以, 造成很多人对路由的概念有点模糊. 在这里, 我准备把路由给显化出来, 何为"显化", 请看如下所示:

<?php
/**
 * get 请求地址:
 * @api: /
 */
Route::get('/', function(){
    echo 'fizzday route test';
});

/**
 * post 请求地址: doman.com/test, 对应的是 `TestController` 的 `index` 方法
 * @api: /test/index
 */
Route::post('test', 'TestController@index');

/**
 * get 或 post 都可以
 */
Route::any('test/test2', 'TestController@test2');

/**
 * 路由组
 * @api /admin
 */
Route::group('admin', function(){
    /**
     * 路由组
     * @api /admin/test/getNews
     */
    Route::post('test/getNews', 'admin\TestController@getNews');

    Route::post('test', 'admin\TestController@index');
});

先过过眼瘾, 这种路由是不是有一种很眼熟的感觉, 没错, 他就是大名鼎鼎的 Laravel 所采用的路由格式, 那是不是意味着, 我们可以直接使用 Laravel 的路由了? 其实, 当我看了下 Laravel 的路由后, 就没有想使用的欲望了, 那个又大又复杂, 对于我们交流和 DIY 有着太多的不便.
没错, 是 DIY , 因为我的目标就是打造一个简单快捷, 人人都可以 DIY 的强悍框架. 所以, 我会用尽可能少的代码, 做到目前尽可能前卫的使用.
当然, 前辈都有走过这条路, 所以, 还是值得借鉴一番的, 这不有一个mini型的 noahbuscher/Macaw, 还有我们非常勤劳与和善的 lvwenhan 先辈的 TinyRouter , 就是在此基础之上改进的. 那是不是意味着, 我也可以直接使用了???
可是, 尽管他是如此的mini, 还是有了改良版的 TinyRouter , 具体改进, 请看源码, 然而, TinyRouter 会是我们想要的类型么, 其实, 遗憾的发现, 也不尽然, 不能做到我们想要的这种类型, 至少还缺少这个一目了然的 group. 所以, 就有了这个 FizzRoute 的诞生:

为啥要用这个"显式"路由

到底为啥呢? 因为这个好处, 有很多很多, 到底有多少, 我就不一一细说了, 只说一点, 现在的 api 大行其道, 其中有一点就是, 我们的接口到底有多少? 接口的参数神马的, 都是啥? 接口的传递方式又是啥? ....... 这一问, 可咋办, 这不, 显式路由的威力就体现出来了, 我通过路由的注释文档, 一目了然的就体现出来了.....

FizzRoute - 简单强悍的路由

下边就看我们如何放大招, 来搞定他了:
我依然借鉴了上边的 Route 的部分, 然后做了部分改进, 路由很简洁, 不足200行, 只有几个重要方法:

// 过滤
filter();

// 捕获静态方法
__callstatic();

// 路由核心处理
dispath();

// 分配控制器
matchController();

具体请看源码: fizzday/fizzRoute

为了省事, 也加入了自动路由, 这样, 即可以手动指定路由对应的文件, 未定义时还可以自动找到

路由分配, 结构完善

好了, 路由有了, 我们需要给他分配个位置, 因为经常会用到, 我们就把他放入根目录吧, 比较好找, 并命名为 routes, 这样可以在他下边放路由文件了
而 FizzRoute 类, 我们需要给他放入框架 Fizzday 核心类中, 属于框架的一部分. 可是框架目录也没有, 因为 , 到时候我们会把框架整体作为一个 composer 包来控制, 所以, 没有给他分配目录, 需要用到composer管理, 就执行一下 composer require fizzday/fizzroute dev-master', 自动安装到 vendor 目录下. 这个时候的基本结构应该差不多了, 我们就顺便把MVC` 的目录也加上, 以后就不用操心了, 现在目录如下:

~
fizzday
|--|--app/
|--|--|--|--Controllers/
|--|--|--|--Models/
|--|--|--|--Views/
|--|--config/
|--|--public/
|--|--|--|-=index.php
|--|--routes/
|--|--|--|-=routes.php
|--|--vendor/
|--|--|--|--composer/
|--|--|--|--fizzday/
|--|--|--|--|--|--fizzroute/
|--|--|--|--|--|--|--src/
|--|--|--|--|--|--|--|-=FizzRoute.php
|--|-=composer.json

这样是不是清爽多了, 接下来, 我们要实际验证下路由分发是否合理

编写对应的文件

编辑composer.json文件, 加入psr-4自动加载, 设定命名空间

$ cd ~/fizzday && vi composer.json

加入内容后:

{
    "name": "Fizzday/Fizzday",
    "description": "A freedom and wonderful PHP Framework based on Composer",
    "keywords": ["fizzday", "freedom", "framework", "php"],
    "license": "MIT",
    "require": {
        "fizzday/fizzroute": "dev-master"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/"
        }
    },
    "config": {
        "preferred-install": "dist"
    }
}

定义了框架 app 目录的命名空间为\App

编辑我们的入口文件:

$ cd ~/fizzday/public && vi index.php

编写内容如下:

<?php
// 定义路径常量
define('ROOT_PATH', __DIR__."/");

// 引入composer自动加载文件
require '../vendor/autoload.php';

编辑路由入口文件:

$ cd ~/fizzday/routes && vi routes.php

编写内容如下:

<?php
use Fizzday\Routing\FizzRoute as Route;
Route::get('/', 'TestController@index');

编写对应的控制器的内容

$ cd ~/fizzday/app/Controllers && vi TestController.php

添加如下内容:

<?php
namespace App\Controller;
class TestControlelr
{
    public function index()
    {
        echo "Fizzday's route success";
    }
}

然后我们访问: fizzday.com , 发现居然什么都没有, 难道是我们的程序出错了? 貌似过程没啥问题, 哈哈, 其实, 我们引入了命名空间, 所以, 必须要让入口文件知道我在命名空间中, 于是乎, 执行composer 更新命令:

$ cd ~/fizzday && composer dump-autoload

继续访问: fizzday.com
Hooray ! It works ~~~

Route_success.png

完美手工~~~