PHP Laravel框架路由配置及设置技巧全解

jopen 9年前

Laravel框架在PHP开发中使用十分广泛,本文主要对Laravel框架中的路由设置作详细的介绍,Laravel的路由配置非常灵活,如何设置好路由对PHP应用来说也是相当关键的。

PHP Laravel框架路由配置及设置技巧全解

基本路由

您的应用程序的绝大多数路由将在 app/routes.php 文件中定义。Laravel 中最简单的路由由一个 URI 和一个闭包调用组成。

基本 GET 路由

Route::get('/', function()  {  return 'Hello World';  });

基本 POST 路由

Route::post('foo/bar', function()  {  return 'Hello World';  });

注册一个路由以响应所有 HTTP 方法

Route::any('foo', function()  {     return 'Hello World';  });

强制一个路由必须通过 HTTPS 访问

Route::get('foo', array('https', function()  {      return 'Must be over HTTPS';  }));

经常您需要根据路由产生 URLs,您可以通过使用 URL::to 方法:

$url = URL::to('foo');

路由参数

Route::get('user/{id}', function($id)  {  return 'User '.$id;  });

可选的路由参数

Route::get('user/{name?}', function($name = null)  {  return $name;  });

带默认值的可选的路由参数

Route::get('user/{name?}', function($name = 'John')  {  return $name;  });

带正则表达式约束的路由

Route::get('user/{name}', function($name)  {  //  })  ->where('name', '[A-Za-z]+');  Route::get('user/{id}', function($id)  {  //  })  ->where('id', '[0-9]+');

路由过滤器

路由过滤器提供了一种限制访问指定路由的简单的方法,这在您需要为您的站点创建需要认证区域的时候非常有用。Laravel 框架中包含了一些路由过滤器,比如 auth 过滤器、auth.basic 过滤器、guest 过滤器、以及 csrf 过滤器。它们被存放在 app/filters.php 文件中。

定义一个路由过滤器

Route::filter('old', function()  {  if (Input::get('age') < 200)  {  return Redirect::to('home');  }  });

如果一个响应从一个路由过滤器中返回,这个响应即被认为是这个请求的响应,路由将不被执行,任何关于这个路由的 after 过滤器也将被取消执行。

为一个路由指定一个路由过滤器

Route::get('user', array('before' => 'old', function()  {  return 'You are over 200 years old!';  }));

为一个路由指定多个路由过滤器

Route::get('user', array('before' => 'auth|old', function()  {  return 'You are authenticated and over 200 years old!';  }));

指定路由过滤器参数

Route::filter('age', function($route, $request, $value)  {  //  });  Route::get('user', array('before' => 'age:200', function()  {  return 'Hello World';  }));

当路由过滤器接收到作为第三个参数的响应 $response:

Route::filter('log', function($route, $request, $response, $value)  {  //  });

基本路由过滤器的模式

您可能希望根据 URI 为一组路由指定过滤器。

Route::filter('admin', function()  {  //  });  Route::when('admin/*', 'admin');

在上面的例子中,admin 过滤器将应用带所有以 admin/ 开头的路由。星号作为一个通配符,将适配到所有字符的组合。

您也可以通过指定 HTTP 方法约束模式过滤器:

Route::when('admin/*', 'admin', array('post'));

过滤器类

对于高级的过滤器,您可以使用一个类代替闭包函数。因为过滤器类是位于应用程序之外的 IoC 容器,您能够在过滤器中使用依赖注入,更易于测试。

定义一个过滤器类

class FooFilter {  public function filter()  {  // Filter logic...  }  }

注册一个基于类的过滤器

Route::filter('foo', 'FooFilter');

命名路由

命名路由在更易于在生成跳转或 URLs 时指定路由。您可以像这样为路由指定一个名字:

Route::get('user/profile', array('as' => 'profile', function()  {  //  }));

您也可以为控制器的方法指定路由名字:

Route::get('user/profile', array('as' => 'profile', 'uses' =>   'UserController@showProfile'));

现在您在生成 URLs 或跳转的时候使用路由的名字:

$url = URL::route('profile');  $redirect = Redirect::route('profile');

您可以使用 currentRouteName 方法获取一个路由的名字:

$name = Route::currentRouteName();

路由组

有些时候您可能希望应用过滤器到一组路由。您不必要为每个路由指定过滤器,可以使用路由组:

Route::group(array('before' => 'auth'), function()  {  Route::get('/', function()  {  // Has Auth Filter  });  Route::get('user/profile', function()  {  // Has Auth Filter  });  });

子域名路由

Laravel 路由也能够处理通配符的子域名,并且从域名中获取通配符参数:

注册子域名路由

Route::group(array('domain' => '{account}.myapp.com'), function()  {  Route::get('user/{id}', function($account, $id)  {  //  });  });

路由前缀

一组路由可以通过在属性数组中使用 prefix 选项为路由组添加前缀:

为路由组添加前缀

Route::group(array('prefix' => 'admin'), function()  {  Route::get('user', function()  {  //  });  });

路由模型绑定

模型绑定提供了一个简单的方法向路由中注入模型。比如,不仅注入一个用户的 ID,您可以根据指定的 ID 注入整个用户模型实例。首先使用 Route::model 方法指定所需要的模型:

为模型绑定一个变量

Route::model('user', 'User');

然后, 定义一个包含 {user} 参数的路由:

Route::get('profile/{user}', function(User $user)  {  //  });

因为我们已经绑定 {user} 参数到 User 模型,一个 User 实例将被注入到路由中。因此,比如一个 profile/1 的请求将注入一个 ID 为 1 的 User 实例。

注意: 如果在数据库中没有找到这个模型实例,将引发404错误。

如果您希望指定您自己定义的没有找到的行为,您可以为 model 方法传递一个闭包作为第三个参数:

Route::model('user', 'User', function()  {  throw new NotFoundException;  });

有时您希望使用自己的方法处理路由参数,可以使用 Route::bind 方法:

Route::bind('user', function($value, $route)  {  return User::where('name', $value)->first();  });

引发404错误

有两种方法在路由中手动触发一个404错误。首先,您可以使用 App::abort 方法:

App::abort(404);

其次,您可以抛出一个 Symfony\Component\HttpKernel\Exception\NotFoundHttpException 的实例。

更多关于处理404异常和为这些错误使用使用自定义响应的信息可以在 错误 章节中找到。

路由至控制器

Laravel 不仅允许您路由至闭包,也可以路由至控制器类,甚至允许创建 资源控制器.

来源:codeceo