前言
本篇将讲述如何构建路由。推荐 https://github.com/NoahBuscher/Macaw,对应的 Composer 包为:noahbuscher/macaw
安装macaw
我们可以直接编辑composer.json文件,添加即可:
{ "require": { "noahbuscher/macaw": "dev-master" } }
然后执行 composer update 即可
或者我们也可以直接使用命令:
composer require noahbuscher/macaw:dev-master
然后我们查看vendor文件夹下面是否有这个文件即可
使用macaw
新建 public 文件夹,这个文件夹将是用户唯一可见的部分。在文件夹下新建index.php 文件:
- <?php
- // Autoload 自动载入
- require '../vendor/autoload.php';
- // 路由配置
- require '../config/routes.php';
上面一行表示引入 Composer 的自动载入功能,下面一行表示载入路由配置文件。新建config 文件夹,在里面新建 routs.php 文件,内容如下:
- <?php
-
- use NoahBuscher\Macaw\Macaw;
-
- Macaw::get('fuck', function () {
- echo "成功!";
- });
- Macaw::get('(:all)', function ($fu) {
- echo '未匹配到路由<br>' . $fu;
- });
- Macaw::dispatch();
Macaw 的文档位于 https://github.com/NoahBuscher/Macaw,请按照你的 HTTP服务软件类型自行设置伪静态,其实跟绝大多数框架一样:“将所有非静态文件全部指向index.php”。
然后,将某一个端口用 Apache 或 Nginx 分配给 MFFC/public 目录,这一步十分建议用 Apache 或者 Nginx 做。
如果使用 PHP 内置 HTTP 服务器:
cd public && php -S 127.0.0.1:3000
将导致路由的 Macaw::get(‘fuck’ 必须写成 Macaw::get(‘/fuck’ 才能响应。
目前的代码使用 Apache + mod_php 和 Nginx + php-fpm 方式均没有问题。
配置成功之后,返回如下:
如果页面乱码,请调整编码为 UTF-8。如果你成功看到以上页面,那么恭喜你,路由配置成功!
Macaw 只有一个文件,去除空行总共也就一百行多一点,通过代码我们能直接看明白它是怎么工作的。下面我简略分析一下:
- Composer 的自动加载在每次 URL 驱动 public/index.php 之后会在内存中维护一个全量命名空间类名到文件名的数组,这样当我们在代码中使用某个类的时候,将自动载入该类所在的文件。
- 我们在路由文件中载入了 Macaw 类:“use NoahBuscher\Macaw\Macaw;”,接着调用了两次静态方法 ::get(),这个方法是不存在的,将由vendor/codingbean/macaw/Macaw.php 中的 __callstatic() 接管。
- 这个函数接受两个参数, $method 和 $params ,前者是具体的 function 名称,在这里就是 get,后者是这次调用传递的参数,即Macaw::get(‘fuck’,function(){…}) 中的两个参数。第一个参数是我们想要监听的 URL 值,第二个参数是一个 PHP 闭包,作为回调,代表 URL 匹配成功后我们想要做的事情。
- __callstatic() 做的事情也很简单,分别将目标URL(即 /fuck)、HTTP方法(即 GET)和回调代码压入 $routes 、 $methods 和 $callbacks 三个Macaw 类的静态成员变量(数组)中。
- 路由文件最后一行的 Macaw::dispatch(); 方法才是真正处理当前 URL 的地方。能直接匹配到的会直接调用回调,不能直接匹配到的将利用正则进行匹配。