万丈高楼平地起, 再牛框架路由始
通过这句话, 就可以看出路由的作用有多大.
由于过往接触的框架(如: 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 ~~~
完美手工~~~
