* * * * * [TOC] ## 簡介 Laravel 提供了幾個輔助函數來為應用程序生成 URL。主要用于在模板和 API 響應中構建 URL 或者在應用程序的其它部分生成重定向響應。 ## 基礎 ### 生成基礎 URL 輔助函數?`url`?可以用于應用的任何一個 URL。生成的 URL 將自動使用當前請求中的方案（ HTTP 或 HTTPS ）和主機： ~~~ $post = App\Post::find(1); echo url("/posts/{$post->id}"); // http://example.com/posts/1 ~~~ ### 訪問當前 URL 如果沒有給輔助函數?`url`?提供路徑，則會返回一個?`Illuminate\Routing\UrlGenerator`?實例，來允許你訪問有關當前 URL 的信息： ~~~ // 獲取沒有查詢字符串的當前的 URL ... echo url()->current(); // 獲取包含查詢字符串的當前的 URL ... echo url()->full(); // 獲取上一個請求的完整的 URL... echo url()->previous(); ~~~ 上面的這些方法都可以通過?`URL`?[facade](http://www.hmoore.net/tonyyu/laravel_5_6/786058)?訪問： ~~~ use Illuminate\Support\Facades\URL; echo URL::current(); ~~~ ## 命名路由的 URL 輔助函數?`route`?可以用于為指定路由生成 URL。命名路由生成的 URL 不與路由上定義的 URL 相耦合。因此，就算路由的 URL 有任何更改，都不需要對?`route`?函數調用進行任何更改。例如，假設你的應用程序包含以下路由： ~~~ Route::get('/post/{post}', function () { // })->name('post.show'); ~~~ 要生成此路由的 URL，可以像這樣使用輔助函數?`route`： ~~~ echo route('post.show', ['post' => 1]); // http://example.com/post/1 ~~~ 將?[Eloquent 模型](http://www.hmoore.net/tonyyu/laravel_5_6/786272)?作為參數值傳給?`route`?方法，它會自動提取模型的主鍵來生成 URL。 ~~~ echo route('post.show', ['post' => $post]); ~~~ ## 控制器行為的 URL `action`?功能可以為給定的控制器行為生成 URL。這個功能不需要你傳遞控制器的完整命名空間，但你需要傳遞相對于命名空間?`App\Http\Controllers`?的控制器類名： ~~~ $url = action('HomeController@index'); ~~~ 如果控制器方法需要路由參數，那就將它們作為第二個參數傳遞給?`action`?函數： ~~~ $url = action('UserController@profile', ['id' => 1]); ~~~ ## 默認值 對于某些應用程序，你可能希望為某些 URL 參數的請求范圍指定默認值。例如，假設有些路由定義了 {locale} 參數： ~~~ Route::get('/{locale}/posts', function () { // })->name('post.index'); ~~~ 每次都通過?`locale`?來調用輔助函數?`route`?也是一件很麻煩的事情。因此，使用?`URL::defaults`?方法定義這個參數的默認值，可以讓該參數始終存在當前請求中。然后就能從?[路由中間件](http://www.hmoore.net/tonyyu/laravel_5_6/786089#_101)?調用此方法來訪問當前請求： ~~~ <?php namespace App\Http\Middleware; use Closure; use Illuminate\Support\Facades\URL; class SetDefaultLocaleForUrls { public function handle($request, Closure $next) { URL::defaults(['locale' => $request->user()->locale]); return $next($request); } } ~~~ 一旦設置了?`locale`?參數的默認值，您就不再需要通過輔助函數?`route`?生成 URL 時傳遞它的值。