基本路由

應用中的大多數路都會定義在 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' => '[email protected]'));

為路由繫結多個過濾器

程式碼如下:

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' => '[email protected]'));

現在，你可以使用路由名稱來建立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。