路由

Slim 框架的路由基于 nikic/fastroute 组件进行构建,它格外地快速稳定。

如何创建路由

你在可以使用 \Slim\App 实例的代理(proxy)方法来定义应用程序路由。Slim 框架提供了最流行的HTTP方法。

Get 路由

使用 Slim 应用程序的 get() 方法添加一个只处理 GET HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->get('/books/{id}', function ($request, $response, $args) {
 // Show book identified by $args['id']
});

POST 路由

使用 Slim 应用程序的 post() 方法添加一个只处理 POST HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->post('/books', function ($request, $response, $args) {
 // Create new book
});

PUT 路由

使用 Slim 应用程序的 put() 方法添加一个只处理 PUT HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->put('/books/{id}', function ($request, $response, $args) {
 // Update book identified by $args['id']
});

DELETE 路由

使用 Slim 应用程序的 delete() 方法添加一个只处理 DELETE HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->delete('/books/{id}', function ($request, $response, $args) {
 // Delete book identified by $args['id']
});

OPTIONS 路由

使用 Slim 应用程序的 options() 方法添加一个只处理 OPTIONS HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->options('/books/{id}', function ($request, $response, $args) {
 // Return response headers
});

PATCH 路由

使用 Slim 应用程序的 patch() 方法添加一个只处理 PATCH HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->patch('/books/{id}', function ($request, $response, $args) {
 // Apply changes to book identified by $args['id']
});

任意路由

使用 Slim 应用程序的 any() 方法添加一个可以处理处理所有 HTTP 请求的路由。它接收两个参数:

  1. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  2. 路由回调
$app = new \Slim\App();
$app->any('/books/[{id}]', function ($request, $response, $args) {
 // Apply changes to books or book identified by $args['id'] if specified.
 // To check which method is used: $request->getMethod();
});

记住,第二个参数是一个回调。你需要指定一个类(Class,需要一个 __invoke() 实现方法。)来替换闭包(Closure)。接着,你可以映射到其他位置:

$app->any('/user', 'MyRestfulController');

自定义路由

使用 Slim 应用程序的 map() 方法来添加一个可以处理多个 HTTP 请求方法的路由。它接收三个参数:

  1. HTTP 方法的数组
  2. 路由模式(带有可选的命名占位符)/The route pattern (with optional named placeholders)
  3. 路由回调
$app = new \Slim\App();
$app->map(['GET', 'POST'], '/books', function ($request, $response, $args) {
 // Create new book or list all books
});

路由回调

上述的每个路由方法都接收一个回调例程作为其最后一个参数。这个参数可以是任意 PHP 调用(callable),并且它默认接受三个参数。

请求/Request

第一个参数是一个 Psr\Http\Message\ServerRequestInterface 对象,表示当前的 HTTP 请求。

响应/Response

第二个参数是一个 Psr\Http\Message\ResponseInterface 对象,表示当前的 HTTP 响应。

参数数组/Arguments

第三个参数是一个关联数组,包含包含当前路由的命名占位符。

将内容写入响应

有两种方式可以将内容写入 HTTP 响应。第一钟,可以使用 echo() 简单地从路由回调中输出内容。其内容将会呗追加到当前 HTTP 请求对象中。第二种,你可以返回一个 Psr\Http\Message\ResponseInterface 对象。

闭包绑定/Closure binding

如果你使用一个闭包(Closure)实例作为路由回调,闭包的状态受Container实例约束。这意味着你将通过 $this 关键字访问闭包内部的 DI 容器实例:

$app = new \Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
 // Use app HTTP cookie service
 $this->get('cookies')->set('name', [
 'name' => $args['name'],
 'expires' => '7 days'
 ]);
});

路由策略

路由回调签名由路由策略决定。默认地,Slim 寄望路由回调来接收请求、响应和由路由占位符参数组成的数组。这称为请求响应策略(RequestResponse strategy)。然而,你可以通过使用另一个不同策略来改变这种寄望。例如,Slim 提供了一个另类的策略,叫做 RequestResponseArgs ,它接收请求和响应,加上由每一个路由占位符组成的单独参数。这里的例子展示了如何使用这个另类的策列;轻松替代了默认\Slim\Container提供的 foundHandler 依赖:

$c = new \Slim\Container();
$c['foundHandler'] = function() {
 return new \Slim\Handlers\Strategies\RequestResponseArgs();
};

$app = new \Slim\App($c);
$app->get('/hello/{name}', function ($request, $response, $name) {
 return $response->write($name);
});

通过实现 \Slim\Interfaces\InvocationStrategyInterface 你可以提供一个你自己的路由策略。

路由占位符

上诉的每个路由方法都会收到一个 URL 模式(URL pattern),它将与当前 HTTP 请求的 URI 相匹配。路由模式将使用命名占位符(named placeholder)来动态匹配 HTTP 请求的URI 片段。

格式

路由模式占位符起始与一个 {, 然后是占位符名称, 最后以 } 结束。这是一个名为 name 的占位符例子:

$app = new \Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
 echo "Hello, " . $args['name'];
});

可选的分段 / Optional segments

使一个片段可选,只需用将其放在方括号中:

$app->get('/users[/{id}]', function ($request, $response, $args) {
    // reponds to both `/users` and `/users/123`
    // but not to `/users/`
});

支持多个可选参数嵌套:

$app->get('/news[/{year}[/{month}]]', function ($request, $response, $args) {
    // reponds to `/news`, `/news/2016` and `/news/2016/03`
});

对于数目不确定的可选参数,可以这样做:

$app->get('/news[/{params:.*}]', function ($request, $response, $args) {
    $params = explode('/', $request->getAttribute('params'));

    // $params is an array of all the optional segments
});

在这个例子中,/news/2016/03/20 的 URI 将使得 $params 数组包含三个元素:['2016', '03', '20'].

正则表达式匹配

默认地,占位符被写在 {} 之中,并可以接收任意值。然而,占位符同样可以要求 HTTP 请求 URI 匹配特定的正则表达式。如果当前的HTTP 请求URI 不能与占位符的正则表达式匹配,路由路由将不会启动。下面这个示例占位符要求 id 必须是个数字:

$app = new \Slim\App();
$app->get('/users/{id:[0-9]+}', function ($request, $response, $args) {
 // Find user identified by $args['id']
});

路由名称

应用程序的路由可以被指定一个名称。这非常有用,如果你想要使用路由的 pathFor() 方法以编程的形式生成一个特定路由的 URL 。上述的每个路由方法都会返回一个 \Slim\Route 对象,这个对象带来了 setName() 方法。

$app = new \Slim\App();
$app->get('/hello/{name}', function ($request, $response, $args) {
 echo "Hello, " . $args['name'];
})->setName('hello');

使用应用程序路由的 pathFor() 方法,为已命名的路由生成一个 URL 。

echo $app->router->pathFor('hello', [
 'name' => 'Josh'
]);
// Outputs "/hello/Josh"

路由的 pathFor() 方法接收两个参数:

  1. 路由名称
  2. 由路由模式占位符及替换值组成的关联数组。

路由组

为了帮助将路由整理成条理分明的路由组, \Slim\App 还提供了一个 group() 方法。 每个路由组的路由模式预置于路由或路由组中的路由组,路由组模式的任何占位符参数最终使得嵌套的路由都是可用的:

$app = new \Slim\App();
$app->group('/users/{id:[0-9]+}', function () {
 $this->map(['GET', 'DELETE', 'PATCH', 'PUT'], '', function ($request, $response, $args) {
 // Find, delete, patch or replace user identified by $args['id']
 })->setName('user');
 $this->get('/reset-password', function ($request, $response, $args) {
 // Route for /users/{id:[0-9]+}/reset-password
 // Reset the password for user identified by $args['id']
 })->setName('user-password-reset');
});

记住,在路由组闭包的内部,使用 $this 替代 $app 。Slim 将闭包绑定到应用程序实例,就像路由回调的情况那样。

路由中间件

你可以将中间件与任意路由或路由组相连接。 了解更多.

容器识别 / Container Resolution

你不必限于为路由定义函数。在 Slim 中,有一些不同的方式来定义你的路由行为函数。

除了函数外,你还可以使用: - 可调用的类 - Class:method

这个函数由 Slim 的 Callable 解角器(Resolver) 类提供支持。它将字符串入口(entry)转变为函数调用。例如:

$app->get('/home', '\HomeController:home');

在上面这段代码中,我们定义了一个 /home 路由,并告诉 Slim 执行 \HomeController 类中的 home() 方法。

Slim 首先在容器中寻找 \HomeController 的入口,如果找到了,它将使用该实例。否则,它将它的构造函数,并将容器作为第一个参数。一旦这个类的实例创建了,它将使用你已定义的策略(Strategy)去调用指定的方法。

作为另一种办法,你可以使用一个可调用的(invokable)类,比如:

class MyAction {
   protected $ci;
   //Constructor
   public function __construct(ContainerInterface $ci) {
       $this->ci = $ci;
   }

   public function __invoke($request, $response, $args) {
        //your code
        //to access items in the container... $this->ci->get('');
   }
}

你可以这样使用这个累:

$app->get('/home', '\MyAction');

在更为传统的 MVC 方法中,你构建包含许多行为(actions)的控制器来替代只能处理一个行为的可调用类。

class MyController {
   protected $ci;
   //Constructor
   public function __construct(ContainerInterface $ci) {
       $this->ci = $ci;
   }

   public function method1($request, $response, $args) {
        //your code
        //to access items in the container... $this->ci->get('');
   }

   public function method2($request, $response, $args) {
        //your code
        //to access items in the container... $this->ci->get('');
   }

   public function method3($request, $response, $args) {
        //your code
        //to access items in the container... $this->ci->get('');
   }
}

你可以这样使用控制器方法:

$app->get('/method1', '\MyController:method1');
$app->get('/method2', '\MyController:method2');
$app->get('/method3', '\MyController:method3');