基本路由
應用中的大多數路都會定義在 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';
}));
實際開發中經常需要根據路由生成 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,路由將不會被執行,並且,此路由中所有定義在此過濾器之後的代碼也都不會被執行。
為路由綁定過濾器
復制代碼 代碼如下:
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'));
現在,你可以使用路由名稱來創建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 錯誤
有兩種從路由中手動觸發404錯誤的方法。首先,你可以使用App::abort方法:
復制代碼 代碼如下:
App::abort(404);
其次,你可以拋出Symfony\Component\HttpKernel\Exception\NotFoundHttpException異常。
更多關於處理404異常以及錯誤發生時自定義response的信息可以查看錯誤文檔。
控制器路由
Laravel不光提供了利用閉包函數處理路由的功能,還可以路由到控制器,甚至支持創建 resource controllers。