路由

• 基本路由
  • #路由重定向
  • 視圖路由
• 路由參數
  • #必選參數
  • 可選參數
  • 正規表示式參數
• #命名路由
• ##路由群組
  • 中間件
  • 命名空間
  ##子網域路由
  #路由前綴
  路由命名前綴
#路由模型綁定
• 隱含綁定
  明確綁定
回退路由
頻率限制
#表單方法偽造
#存取目前路由

建構基本的路由只需要一個URI 與一個

，這裡提供了一個非常簡單優雅定義路由的方法：

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

預設路由檔案

所有的 Laravel 路由都在 routes 目錄中的路由檔案中定義，這些檔案都由框架自動載入。 routes/web.php 檔案用於定義 web 介面的路由。這裡面的路由都會被指派給 web 中間件群組，它提供了會話狀態和 CSRF 保護等功能。定義在 routes/api.php 中的路由都是無狀態的，並且被指派了 api 中間件群組。

大多數的應用程式構建，都是以在 routes/web.php 檔案定義路由開始的。可以透過在瀏覽器中輸入定義的路由 URL 來存取 routes/web.php 中定義的路由。例如，你可以在瀏覽器中輸入http://your-app.dev/user 來存取以下路由

Route::get('/user', 'UserController@index');

routes/api.php 檔案中定義的路由透過RouteServiceProvider 被嵌套到一個路由群組裡面。在這個路由群組中，會自動新增 URL 前綴 /api 到此檔案中的每個路由，這樣你就無需再手動新增了。你可以在 RouteServiceProvider 類別中修改此前綴以及其他路由組選項。

可用的路由方法

路由器允許你註冊能回應任何HTTP 請求的路由：

Route::get($uri, $callback);
Route::post($uri, $callback);
Route::put($uri, $callback);
Route::patch($uri, $callback);
Route::delete($uri, $callback);
Route::options($uri, $callback);

有的時候你可能需要註冊一個可回應多個HTTP 請求的路由，這時你可以使用match 方法，也可以使用any 方法註冊一個實現回應所有HTTP 請求的路由：

Route::match(['get', 'post'], '/', function () { 
   //
});
Route::any('foo', function () {  
  //
});

CSRF 保護

指向web 路由檔案中定義的POST、PUT 或DELETE#路由的任何HTML 表單都應該包含一個CSRF 令牌字段，否則，這個請求將會被拒絕。可以在CSRF 文件中閱讀有關CSRF 更多的資訊:

<form method="POST" action="/profile">
    @csrf 
     ...
</form>

重定向路由

如果要定義重定向到另一個URI 的路由，可以使用Route::redirect 方法。這個方法可以快速的實作重定向，而不再需要去定義完整的路由或控制器:

Route::redirect('/here', '/there');

#Route::redirect 預設會回傳狀態碼302 。你可以透過第三個參數自訂回傳碼：

Route::redirect('/here', '/there', 301);

你也可以使用Route::permanentRedirect 方法來回傳301 狀態碼：

Route::permanentRedirect('/here', '/there');

視圖路由

如果你的路由只需要回傳一個視圖，可以使用 Route::view 方法。它和 redirect 一樣方便，不需要定義完整的路由或控制器。 view 方法有三個參數，其中第一個是必填參數，是包含視圖名稱的 URI 。第二個也是必填參數，是需要渲染的視圖名稱。第三個參數是可選參數，可以傳入一個數組，數組中的資料會傳遞給視圖:

Route::view('/welcome',  'welcome');
Route::view('/welcome', 'welcome', ['name' => 'Taylor']);

路由參數

必填參數

當然，有時需要在路由中擷取一些URL 片段。例如，從URL 擷取使用者的ID，可以透過定義路由參數來執行此操作：

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

也可以根據需要在路由中定義多個參數：

Route::get('posts/{post}/comments/{comment}', function ($postId, $commentId) { 
   //
});

路由的參數通常都會被放在{} 內，且參數名稱只能為字母，同時路由參數不能包含- 符號，如果需要可以用底線(_)代替。路由參數會依序依序注入路由回呼或控制器中，而不受回呼或控制器的參數名稱的影響。

可選擇參數

#有時，你可能需要指定一個路由參數，但你希望這個參數是可選的。你可以在參數後面加上? 標記來實現，但前提是要確保路由的對應變數有預設值

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

where 方法約束路由參數的格式。 where 方法接受參數名稱和定義參數應如何約束的正規表示式：

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(['id' => '[0-9]+', 'name' => '[a-z]+']);

pattern 方法在 RouteServiceProvider 的 boot 方法中定義這些模式：

/**
 * 定义你的路由模型绑定, pattern 过滤器等。
 *
 * @return void
 */
 public function boot(){
     Route::pattern('id', '[0-9]+');    
     parent::boot();
  }

Route::get('user/{id}', function ($id) { 
   // 只有在 id 为数字时才执行。
 });

/ 之外的所有字元。你必須使用where 條件正規表示式明確地允許/ 成為佔位符的一部分：

Route::get('search/{search}', function ($search) { 
   return $search;
 })->where('search', '.*');

Route::get('user/profile', function () {  
  //
})->name('profile');

Route::get('user/profile', 'UserProfileController@show')->name('profile');

// 生成 URL...
$url = route('profile');
// 生成重定向...
return redirect()->route('profile');

Route::get('user/{id}/profile', function ($id) {
    //
 })->name('profile');
 $url = route('profile', ['id' => 1]);

/**
 * 处理一次请求。
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Closure  $next
 * @return mixed
 */
 public function handle($request, Closure $next){
     if ($request->route()->named('profile')) {    
         //  
        } 
    return $next($request);
 }

Route::middleware(['first', 'second'])->group(function () { 
   Route::get('/', function () { 
       // // 使用 first 和 second 中间件  
       });
    Route::get('user/profile', function () {  
       // // 使用 first 和 second 中间件
        });
    });

Route::namespace('Admin')->group(function () {  
  // 在 "App\Http\Controllers\Admin" 命名空间下的控制器
 });

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

Route::prefix('admin')->group(function () { 
   Route::get('users', function () {   
        // 匹配包含 "/admin/users" 的 URL  
       });
   });

Route::name('admin.')->group(function () { 
   Route::get('users', function () {   
        // 指定路由名为 "admin.users"...  
   })->name('users');});

Route::get('api/users/{user}', function (App\User $user) { 
   return $user->email;
});

/**
 * 获取该模型的路由的自定义键名。
 *
 * @return string
 */
 public function getRouteKeyName(){
     return 'slug';
  }

public function boot(){
    parent::boot();
    Route::model('user', App\User::class);
  }

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

/**
 * 启动应用服务。
 *
 * @return void
 */
 public function boot(){
         parent::boot();        
         Route::bind('user', function ($value) {          
               return App\User::where('name', $value)->first() ?? abort(404);   
               });
    }

/**
 * 检索绑定值的模型。
 *
 * @param  mixed  $value
 * @return \Illuminate\Database\Eloquent\Model|null
 */
 public function resolveRouteBinding($value){ 
    return $this->where('name', $value)->first() ?? abort(404);
 }

Route::fallback(function () {
    //
 });

Route::middleware('auth:api', 'throttle:60,1')->group(function () { 
   Route::get('/user', function () { 
          //   
       });
  });

Route::middleware('auth:api', 'throttle:rate_limit,1')->group(function () {
    Route::get('/user', function () {  
          //  
      });
  });

<form action="/foo/bar" method="POST"> 
  <input type="hidden" name="_method" value="PUT"> 
  <input type="hidden" name="_token" value="{{ csrf_token() }}">
</form>

<form action="/foo/bar" method="POST">
    @method('PUT')
    @csrf
</form>

$route = Route::current();
$name = Route::currentRouteName();
$action = Route::currentRouteAction();