README

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

安装

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

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

示例

首先，use 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;
}