README

Macaw是一个简单、开源的PHP路由器。它非常小巧（约150行代码），速度快，并有一些优秀的注释源代码。这个类允许你将其直接扔进项目中并立即开始使用。

安装

如果你有Composer，只需在项目的composer.json中将Macaw作为依赖项包含即可。如果没有，只需下载.ZIP文件并将其解压缩到你的项目目录中。

require: {
    "noahbuscher/macaw": "dev-master"
}

示例

首先，使用Macaw命名空间

use \NoahBuscher\Macaw\Macaw;

Macaw不是一个对象，因此你可以直接对该类进行操作。以下是一个Hello World示例

Macaw::get('/', function() {
  echo 'Hello world!';
});

Macaw::dispatch();

Macaw也支持lambda URI，例如

Macaw::get('/(:any)', function($slug) {
  echo 'The slug is: ' . $slug;
});

Macaw::dispatch();

你还可以在Macaw中请求HTTP方法，因此你还可以这样做

Macaw::get('/', function() {
  echo 'I'm a GET request!';
});

Macaw::post('/', function() {
  echo 'I'm a POST request!';
});

Macaw::any('/', function() {
  echo 'I can be both a GET and a POST request!';
});

Macaw::dispatch();

最后，如果未为某个位置定义路由，你可以让Macaw运行自定义回调，例如

Macaw::error(function() {
  echo '404 :: Not Found';
});

如果你没有指定错误回调，Macaw将只输出404。

为了让服务器知道URI不指向真实文件，你可能需要使用示例配置文件之一。

示例：传递到控制器而不是闭包

对于这个演示，让我们假设我有一个名为controllers的文件夹，其中有一个demo.php文件

index.php

require('vendor/autoload.php');

use NoahBuscher\Macaw\Macaw;

Macaw::get('/', 'Controllers\demo@index');
Macaw::get('page', 'Controllers\demo@page');
Macaw::get('view/(:num)', 'Controllers\demo@view');

Macaw::dispatch();

demo.php

<?php
namespace controllers;

class Demo {

    public function index()
    {
        echo 'home';
    }

    public function page()
    {
        echo 'page';
    }

    public function view($id)
    {
        echo $id;
    }

}

这是通过Composer安装Macaw的情况。

composer.json

{
   "require": {
        "noahbuscher/macaw": "dev-master"
    },
    "autoload": {
        "psr-4": {
            "" : ""
        }
    }
}

.htaccess(Apache)

RewriteEngine On
RewriteBase /

# Allow any files or directories that exist to be displayed directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule ^(.*)$ index.php?$1 [QSA,L]

.htaccess(Nginx)

rewrite ^/(.*)/$ /$1 redirect;

if (!-e $request_filename){
	rewrite ^(.*)$ /index.php break;
}