URL


Laravel menyediakan beberapa fungsi pembantu untuk menjana URL untuk permohonan. Digunakan terutamanya untuk membina URL dalam templat dan respons API atau menjana respons ubah hala di bahagian lain aplikasi.

Asas

Jana URL asas

Fungsi tambahan dalam aplikasi boleh digunakan untuk mana-mana URL URL yang dijana akan secara automatik menggunakan skema ( HTTP atau HTTPS ) dan hos daripada permintaan semasa:

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

Akses URL semasa

Jika tiada laluan disediakan kepada fungsi pembantu url, contoh IlluminateRoutingUrlGenerator akan dikembalikan untuk membolehkan anda mengakses maklumat tentang URL semasa: url 提供路径,则会返回一个 IlluminateRoutingUrlGenerator 实例,来允许你访问有关当前 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

辅助函数 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 模型 的主键生成 URL。因此,您可以将 Eloquent 模型作为参数值传递。 route 辅助函数将自动提取模型的主键:

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

辅助函数 route 也可用于为具有多个参数的路由生成 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 允许你轻松地为命名路径创建 「签名」 URL。这些 URL 在查询字符串后附加了 「签名」哈希,允许 Laravel 验证 URL 自创建以来未被修改过。签名 URL 对于可公开访问但需要一层防止 URL 操作的路由特别有用。

例如,你可以使用签名 URL 来实现通过电子邮件发送给客户的公共 「取消订阅」链接。要创建指向路径的签名 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]
  );

验证签名路由请求

要验证传入请求是否具有有效签名,你应该调用 hasValidSignature 传入的方法 Request

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

或者,你可以将 IlluminateRoutingMiddlewareValidateSignature 中间件分配给路由。如果它不存在,则应该在 HTTP 内核的 routeMiddleware 数组中为此中间件分配一个键:

/**
 * 应用程序的路由中间件
 *
 * 这些中间件可能被分配给组或单独使用
 *
 * @var array
 */
 protected $routeMiddleware = [ 
    'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
 ];

在内核中注册中间件后,你可以将其附加到路由中。如果传入请求没有有效签名,则中间件将自动返回 403

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

Atas Kaedah ini boleh diakses melalui fasad URL:

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

URL laluan bernama

Fungsi tambahan laluan boleh digunakan untuk menjana URL bagi laluan yang ditentukan. URL yang dijana oleh laluan bernama tidak digabungkan dengan URL yang ditakrifkan pada laluan. Oleh itu, sebarang perubahan pada URL laluan tidak memerlukan sebarang perubahan pada panggilan fungsi route. Sebagai contoh, katakan aplikasi anda mengandungi laluan berikut: 🎜
use App\Http\Controllers\HomeController;
$url = action([HomeController::class, 'index']);
🎜Untuk menjana URL bagi laluan ini, anda boleh menggunakan fungsi pembantu laluan seperti ini: 🎜
$url = action('UserController@profile', ['id' => 1]);
🎜Anda biasanya akan menjana URL menggunakan kunci utama model Eloquent. Oleh itu, anda boleh lulus model Eloquent sebagai nilai parameter. Fungsi pembantu laluan akan mengekstrak kunci utama model secara automatik: 🎜
Route::get('/{locale}/posts', function () {    //})->name('post.index');
🎜Fungsi pembantu laluan juga boleh digunakan untuk menjana URL bagi laluan dengan berbilang parameter: 🎜
<?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);    
        }
    }
🎜🎜🎜
🎜🎜URL yang ditandatangani🎜🎜Laravel membolehkan anda membuat URL "ditandatangani" dengan mudah untuk laluan yang dinamakan. URL ini mempunyai cincang "ditandatangani" yang dilampirkan pada rentetan pertanyaan, membolehkan Laravel mengesahkan bahawa URL itu tidak diubah suai sejak penciptaannya. URL yang ditandatangani amat berguna untuk laluan yang boleh diakses secara umum tetapi memerlukan lapisan perlindungan terhadap manipulasi URL. 🎜🎜Sebagai contoh, anda boleh menggunakan URL yang ditandatangani untuk melaksanakan pautan "nyahlanggan" awam yang dihantar melalui e-mel kepada pelanggan anda. Untuk membuat URL bertandatangan yang menghala ke laluan, gunakan kaedah signedRoute fasad URL: 🎜rrreee🎜 Jika anda ingin menjana URL laluan ditandatangani sementara yang telah tamat tempoh, anda boleh menggunakan mengikuti temporarySignedRoute Kaedah: 🎜rrreee
🎜

Sahkan Permintaan Penghalaan Tandatangan

🎜Untuk mengesahkan bahawa permintaan yang masuk mempunyai sah tandatangan, anda harus memanggil < code>hasValidSignature yang diserahkan kepada kaedah Request: 🎜rrreee🎜 Sebagai alternatif, anda boleh menetapkan perisian tengah IlluminateRoutingMiddlewareValidateSignature kepada laluan. Jika ia tidak wujud, perisian tengah ini harus diberikan kunci dalam tatasusunan routeMiddleware teras HTTP: 🎜rrreee🎜Selepas mendaftarkan middleware dalam teras, anda boleh melampirkannya pada laluan. Jika permintaan masuk tidak mempunyai tandatangan yang sah, middleware secara automatik akan mengembalikan respons ralat 403: 🎜rrreee🎜🎜🎜🎜🎜🎜

URL untuk tindakan pengawal

Fungsi action boleh menjana URL untuk tindakan pengawal tertentu. Ciri ini tidak memerlukan anda untuk melepasi ruang nama penuh pengawal, tetapi anda perlu menghantar nama kelas pengawal berbanding dengan ruang nama AppHttpControllers: action 功能可以为给定的控制器行为生成 URL。这个功能不需要你传递控制器的完整命名空间,但你需要传递相对于命名空间 AppHttpControllers 的控制器类名:

rrreee

你还可以使用 “可调用” 数组语法引用操作:

rrreee

如果控制器方法需要路由参数,那就将它们作为第二个参数传递给 action 函数:

rrreee

默认值

对于某些应用程序,你可能希望为某些 URL 参数的请求范围指定默认值。例如,假设有些路由定义了 {locale} 参数:

rrreee

每次都通过 locale 来调用辅助函数 route 也是一件很麻烦的事情。因此,使用 URL::defaults 方法定义这个参数的默认值,可以让该参数始终存在当前请求中。然后就能从 路由中间件 调用此方法来访问当前请求:

rrreee

一旦设置了 locale 参数的默认值,您就不再需要通过辅助函数 routerrreee

Anda juga boleh menggunakan tatasusunan "boleh dipanggil" sintaks untuk merujuk operasi :
🎜
🎜🎜Nilai lalai🎜🎜Untuk sesetengah aplikasi, anda mungkin mahu menentukan nilai lalai untuk skop permintaan parameter URL tertentu. Sebagai contoh, katakan beberapa laluan mentakrifkan parameter {locale}: 🎜rrreee🎜Memanggil fungsi bantu route melalui locale setiap kali juga merupakan perkara yang sangat menyusahkan. Oleh itu, menggunakan kaedah URL::defaults untuk menentukan nilai lalai parameter ini membolehkan parameter sentiasa wujud dalam permintaan semasa. Kaedah ini kemudiannya boleh dipanggil daripada perisian tengah laluan untuk mengakses permintaan semasa: 🎜rrreee🎜 Setelah nilai lalai parameter locale ditetapkan, anda tidak perlu lagi melepasi fungsi helper route Lulus nilainya apabila menjana URL. 🎜🎜Artikel ini pertama kali diterbitkan di laman web 🎜LearnKu.com🎜. 🎜🎜