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 方法:
路由参数
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 不仅允许您路由至闭包,也可以路由至控制器类,甚至允许创建 资源控制器.
更多信息请访问 控制器 文档。
上一篇: php中stream(流)的用法