hanscity/macaw

简单的PHP路由类。

维护者

详细信息

github.com/Hanscity/macaw

源代码

dev-master 2020-04-08 14:17 UTC

This package is auto-updated.

Last update: 2024-09-09 00:59:30 UTC


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;
}

我将取消注释这行

  • 我想修改这段代码,因为我认为这不是最简单的方法