生成 URL

• 簡介
• 基礎
  • 生成基礎 URL
  • 訪問當前 URL
• 命名路由的 URL
  • 簽名 URL
• 控制器行為的 URL
• 默認值

簡介

Laravel 提供了幾個輔助函數(shù)來為應用程序生成 URL。主要用于在模板和 API 響應中構建 URL 或者在應用程序的其它部分生成重定向響應。

基礎

生成基礎 URL

輔助函數(shù) url 可以用于應用的任何一個 URL。生成的 URL 將自動使用當前請求中的方案（ HTTP 或 HTTPS ）和主機：

$post = App\Post::find(1);
echo url("/posts/{$post->id}");
// http://example.com/posts/1

訪問當前 URL

如果沒有給輔助函數(shù) url 提供路徑，則會返回一個 Illuminate\Routing\UrlGenerator 實例，來允許你訪問有關當前 URL 的信息：

// Get the current URL without the query string...
echo url()->current();
// Get the current URL including the query string...
echo url()->full();
// Get the full URL for the previous request...
echo url()->previous();

上面的這些方法都可以通過 URL facade 訪問:

use Illuminate\Support\Facades\URL;
echo URL::current();

命名路由的 URL

輔助函數(shù) route 可以用于為指定路由生成 URL。命名路由生成的 URL 不與路由上定義的 URL 相耦合。因此，就算路由的 URL 有任何更改，都不需要對 route 函數(shù)調(diào)用進行任何更改。例如，假設你的應用程序包含以下路由：

Route::get('/post/{post}', function () { 
   //
})->name('post.show');

要生成此路由的 URL，可以像這樣使用輔助函數(shù) route：

echo route('post.show', ['post' => 1]);
// http://example.com/post/1

您通常會使用 Eloquent 模型 的主鍵生成 URL。因此，您可以將 Eloquent 模型作為參數(shù)值傳遞。 route 輔助函數(shù)將自動提取模型的主鍵：

echo route('post.show', ['post' => $post]);

輔助函數(shù) route 也可用于為具有多個參數(shù)的路由生成 URL：

Route::get('/post/{post}/comment/{comment}', function () { 
   //
})->name('comment.show');
echo route('comment.show', ['post' => 1, 'comment' => 3]);
// http://example.com/post/1/comment/3

簽名 URL

Laravel 允許你輕松地為命名路徑創(chuàng)建 「簽名」 URL。這些 URL 在查詢字符串后附加了 「簽名」哈希，允許 Laravel 驗證 URL 自創(chuàng)建以來未被修改過。簽名 URL 對于可公開訪問但需要一層防止 URL 操作的路由特別有用。

例如，你可以使用簽名 URL 來實現(xiàn)通過電子郵件發(fā)送給客戶的公共 「取消訂閱」鏈接。要創(chuàng)建指向路徑的簽名 URL，請使用 facade  的 signedRoute 方法 URL：

use Illuminate\Support\Facades\URL;return URL::signedRoute('unsubscribe', ['user' => 1]);

如果要生成過期的臨時簽名路由 URL，可以使用以下 temporarySignedRoute 方法：

use Illuminate\Support\Facades\URL;return URL::temporarySignedRoute( 
   'unsubscribe', now()->addMinutes(30), ['user' => 1]
  );

驗證簽名路由請求

要驗證傳入請求是否具有有效簽名，你應該調(diào)用 hasValidSignature 傳入的方法 Request：

use Illuminate\Http\Request;
Route::get('/unsubscribe/{user}', function (Request $request) { 
   if (! $request->hasValidSignature()) {      
      abort(401);    
    }   
   // ...
})->name('unsubscribe');

或者，你可以將 Illuminate\Routing\Middleware\ValidateSignature 中間件分配給路由。如果它不存在，則應該在 HTTP 內(nèi)核的 routeMiddleware 數(shù)組中為此中間件分配一個鍵：

/**
 * 應用程序的路由中間件
 *
 * 這些中間件可能被分配給組或單獨使用
 *
 * @var array
 */
 protected $routeMiddleware = [ 
    'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
 ];

在內(nèi)核中注冊中間件后，你可以將其附加到路由中。如果傳入請求沒有有效簽名，則中間件將自動返回 403 錯誤響應：

Route::post('/unsubscribe/{user}', function (Request $request) { 
   // ...
})->name('unsubscribe')->middleware('signed');

控制器行為的 URL

action 功能可以為給定的控制器行為生成 URL。這個功能不需要你傳遞控制器的完整命名空間，但你需要傳遞相對于命名空間 App\Http\Controllers 的控制器類名：

$url = action('HomeController@index');

你還可以使用 “可調(diào)用” 數(shù)組語法引用操作：

use App\Http\Controllers\HomeController;
$url = action([HomeController::class, 'index']);

如果控制器方法需要路由參數(shù)，那就將它們作為第二個參數(shù)傳遞給 action 函數(shù)：

$url = action('UserController@profile', ['id' => 1]);

默認值

對于某些應用程序，你可能希望為某些 URL 參數(shù)的請求范圍指定默認值。例如，假設有些路由定義了 {locale} 參數(shù)：

Route::get('/{locale}/posts', function () {    //})->name('post.index');

每次都通過 locale 來調(diào)用輔助函數(shù) route 也是一件很麻煩的事情。因此，使用 URL::defaults 方法定義這個參數(shù)的默認值，可以讓該參數(shù)始終存在當前請求中。然后就能從 路由中間件 調(diào)用此方法來訪問當前請求：

<?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 參數(shù)的默認值，您就不再需要通過輔助函數(shù) route 生成 URL 時傳遞它的值。