HTTP 路由

基础路由

您将在 app/Http/routes.php 中定义应用中的大多数路由，这个文件被 bootstrap/app.php 加载。 就如 Laravel 一样, 大部分路由只需要接受一个 URI 和 一个 闭包(Closure) 参数：

基本的 GET 路由

  1. $app->get('/', function() {
  2.     return 'Hello World';
  3. });

其他基础路由

  1. $app->post('foo/bar', function() {
  2.     return 'Hello World';
  3. });
  5. $app->patch('foo/bar', function() {
  6.     //
  7. });
  9. $app->put('foo/bar', function() {
  10.     //
  11. });
  13. $app->delete('foo/bar', function() {
  14.     //
  15. });

你可以使用 url 辅助函数生成 URL : 

  1. $url = url('foo');

把请求导向控制器

请查阅此文档 controllers.

路由参数

你可以从 URL 中抓取你想要的参数。

基本路由参数

  1. $app->get('user/{id}', function($id) {
  2.     return 'User '.$id;
  3. });

正则表达式约束

注意： 这个地方和 Laravel 不兼容, 如果你想升级到 Laravel, 请把你的正则表达式约束放置在 where 方法里面。

  1. $app->get('user/{name:[A-Za-z]+}', function($name) {
  2.     //
  3. });

命名路由

命名路由让你更方便地产生 URL 与重定向特定路由。您可以用 as 的数组键值指定名称给路由：

  1. $app->get('user/profile', ['as' => 'profile', function() {
  2.     //
  3. }]);

也可以为控制器动作指定路由名称：

  1. $app->get('user/profile', [
  2.     'as' => 'profile', 'uses' => 'UserController@showProfile'
  3. ]);

现在你可以使用路由名称产生 URL 或进行重定向：

  1. $url = route('profile');
  3. $redirect = redirect()->route('profile');

路由群组

有时候, 你想对好几个路由进行统一逻辑处理, 如中间件, 你可以使用路由群组功能.

中间件

中间件会对路由群组里面的路由进行作用, 使用参数 middleware 进行设定, 可以设定多个中间件, 请注意中间件的顺序是执行的顺序. 

  1. $app->group(['middleware' => 'foo|bar'], function($app)
  2. {
  3.     $app->get('/', function() {
  4.         // Uses Foo & Bar Middleware
  5.     });
  7.     $app->get('user/profile', function() {
  8.         // Uses Foo & Bar Middleware
  9.     });
  10. });

命名空间

您一样可以在 group 属性数组中使用 namespace 参数，指定在这群组中控制器的命名空间：

  1. $app->group(['namespace' => 'Admin'], function($app) {
  2.     // Controllers Within The "App\Http\Controllers\Admin" Namespace
  3. });

CSRF 保护

Note: 你必须 开启会话 来使用此功能.

Lumen 提供简易的方法，让您可以保护您的应用程序不受到 CSRF (跨网站请求伪造) 攻击。跨网站请求伪造是一种恶意的攻击，借以代表经过身份验证的用户执行未经授权的命令。

Lumen 会自动在每一位用户的 session 中放置随机的 token ，这个 token 将被用来确保经过验证的用户是实际发出请求至应用程序的用户：

插入 CSRF Token 到表单

  1. <input type="hidden" name="_token" value="<?php echo csrf_token(); ?>">

当然也可以在 Blade 模板引擎 使用：

  1. <input type="hidden" name="_token" value="{{ csrf_token() }}">

您不需要手动验证在 POST、PUT、DELETE 请求的 CSRF token。如果你在 bootstrap/app.php 文件里面开启的话, Laravel\Lumen\Http\Middleware\VerifyCsrfToken HTTP 中间件 将保存在 session 中的请求输入的 token 配对来验证 token 。

X-CSRF-TOKEN

除了寻找 CSRF token 作为「POST」参数，中间件也检查 X-XSRF-TOKEN 请求头，比如，你可以把 token 存放在 meta 标签中, 然后使用 jQuery 将它加入到所有的请求头中：

  1. <meta name="csrf-token" content="{{ csrf_token() }}" />
  3. $.ajaxSetup({
  4.     headers: {
  5.         'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
  6.     }
  7. });

现在所有的 AJAX 请求会自动加入 CSRF token：

  1. $.ajax({
  2.    url: "/foo/bar",
  3. })

X-XSRF-TOKEN

Lumen 也在 cookie 中存放了名为 XSRF-TOKEN 的 CSRF token。你可以使用这个 cookie 值来设置 X-XSRF-TOKEN 请求头。一些 Javascript 框架，比如 Angular ，会自动设置这个值。

Note: X-CSRF-TOKEN 和 X-XSRF-TOKEN 的不同点在于前者使用的是纯文本而后者是一个加密的值，因为在 Lumen 中 cookies 始终是被加密过的。如果你使用 csrf_token() 函数来作为 token 的值， 你需要设置 X-CSRF-TOKEN 请求头。

请求方法欺骗

HTML 表单没有支持 PUT 、PATCH 或 DELETE 请求。所以当定义 PUT 、PATCH 以及 DELETE 路由并在 HTML 表单中被调用的时候，您将需要添加隐藏 _method 字段在表单中。

发送的 _method 字段对应的值会被当做 HTTP 请求方法。举例来说：

  1. <form action="/foo/bar" method="POST">
  2.     <input type="hidden" name="_method" value="PUT">
  3.     <input type="hidden" name="_token" value="{{ csrf_token() }}">
  4. </form>

抛出 404 错误

这里有两种方法从路由手动触发 404 错误。

首先，您可以使用 abort 辅助函数：

  1. abort(404);

abort 辅助函数只是简单抛出带有特定状态代码的 Symfony\Component\HttpFoundation\Exception\HttpException 异常 。

第二，您可以手动抛出 Symfony\Component\HttpKernel\Exception\NotFoundHttpException 的实体。

有关如何处理 404 异常状况和自定响应的更多信息，可以参考 错误 章节内的文档。