基本路由
應用中的大多數路都會定義在 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';
}));
實際開發(fā)中經常需要根據路由生成 url,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]+');
傳遞參數限定的數組
當然,必要的時候你還可以傳遞一個包含參數限定的數組作為參數:
代碼如下:
route::get('user/{id}/{name}', function($id, $name)
{
//
})
->where(array('id' => '[0-9]+', 'name' => '[a-z]+'))
定義全局模式
如果希望在全局范圍用指定正則表達式限定路由參數,可以使用 pattern 方法:
代碼如下:
route::pattern('id', '[0-9]+');
route::get('user/{id}', function($id)
{
// only called if {id} is numeric.
});
訪問路由參數
如果想在路由范圍外訪問路由參數,可以使用 route::input 方法:
代碼如下:
route::filter('foo', function()
{
if (route::input('id') == 1)
{
//
}
});
路由過濾器
路由過濾器提供了非常方便的方法來限制對應用程序中某些功能訪問,例如對于需要驗證才能訪問的功能就非常有用。laravel框架自身已經提供了一些過濾器,包括 auth過濾器、auth.basic過濾器、guest過濾器以及csrf過濾器。這些過濾器都定義在app/filter.php文件中。
定義一個路由過濾器
代碼如下:
route::filter('old', function()
{
if (input::get('age') < 200)
{
return redirect::to('home');
}
});
如果從路由過濾器中返回了一個response,那么該response將被認為對應的是此次request,路由將不會被執(zhí)行,并且,此路由中所有定義在此過濾器之后的代碼也都不會被執(zhí)行。
為路由綁定過濾器
代碼如下:
route::get('user', array('before' => 'old', function()
{
return 'you are over 200 years old!';
}));
將過濾器綁定為控制器action
代碼如下:
route::get('user', array('before' => 'old', 'uses' => 'usercontroller@showprofile'));
為路由綁定多個過濾器
代碼如下:
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 container實現解析的,所有,你可以在這些過濾器中利用依賴注入(dependency injection)的方法實現更好的測試能力。
定義一個過濾器類
代碼如下:
class foofilter {
public function filter()
{
// filter logic...
}
}
注冊過濾器類
代碼如下:
route::filter('foo', 'foofilter');
命名路由
重定向和生成url時,使用命名路由會更方便。你可以為路由指定一個名字,如下所示:
代碼如下:
route::get('user/profile', array('as' => 'profile', function()
{
//
}));
還可以為 controller action指定路由名稱:
代碼如下:
route::get('user/profile', array('as' => 'profile', 'uses' => 'usercontroller@showprofile'));
現在,你可以使用路由名稱來創(chuàng)建url和重定向:
代碼如下:
$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錯誤將被拋出。
如果你希望自定義not found行為,可以通過傳遞一個閉包函數作為 model 方法的第三個參數:
代碼如下:
route::model('user', 'user', function()
{
throw new notfoundexception;
});
如果你想自己實現路由參數的解析,只需使用route::bind方法即可:
代碼如下:
route::bind('user', function($value, $route)
{
return user::where('name', $value)->first();
});
拋出 404 錯誤
有兩種從路由中手動觸發(fā)404錯誤的方法。首先,你可以使用app::abort方法:
代碼如下:
app::abort(404);
其次,你可以拋出symfony\component\httpkernel\exception\notfoundhttpexception異常。