Basics - 08. URL Generation

URLs For Named Routes

Der route-Helper kann verwendet werden, um URLs zu benannten Routen zu generieren. Benannte Routen ermöglichen es Ihnen, URLs zu generieren, ohne mit der auf der Route definierten tatsächlichen URL gekoppelt zu sein. Wenn sich die URL der Route ändert, sind daher keine Änderungen an Ihren Aufrufen der route-Function erforderlich. Stellen Sie sich beispielsweise vor, Ihre Anwendung enthält eine Route, die wie folgt definiert ist:

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

Um eine URL zu dieser Route zu generieren, können Sie den route-Helper wie folgt verwenden:

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

// http://example.com/post/1

Häufig werden Sie URLs mit dem Primärschlüssel von Eloquent Models generieren. Aus diesem Grund können Sie Eloquente Modelle als Parameterwerte übergeben. Der route-Helper extrahiert automatisch den Primärschlüssel des Modells:

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

Der route-Helper kann auch verwendet werden, um URLs für Routen mit mehreren Parametern zu generieren:

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

Signed URLs

Mit Laravel können Sie ganz einfach "signierte" URLs zu benannten Routen erstellen. Diese URLs haben einen "Signatur"-Hash an den Query-String angehängt, der es Laravel ermöglicht, zu überprüfen, ob der URL seit seiner Erstellung nicht geändert wurde. Signierte URLs sind besonders nützlich für Routen, die öffentlich zugänglich sind, aber einen Schutz vor URL-Manipulationen benötigen.

Beispielsweise können Sie signierte URLs verwenden, um einen öffentlichen "Abmeldelink" zu implementieren, der per E-Mail an Ihre Kunden gesendet wird. Um eine signierte URL für eine benannte Route zu erstellen, verwenden Sie die Methode signedRoute der URL-Facade:

use Illuminate\Support\Facades\URL;

return URL::signedRoute('unsubscribe', ['user' => 1]);

Wenn Sie eine temporäre signierte Routen-URL generieren möchten, die abläuft, können Sie die temporarySignedRoute-Methode verwenden:

use Illuminate\Support\Facades\URL;

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

Validating Signed Route Requests

Um zu überprüfen, ob eine eingehende Anforderung eine gültige Signatur hat, sollten Sie die hasValidSignature-Methode auf der eingehenden Request aufrufen:

use Illuminate\Http\Request;

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

    // ...
})->name('unsubscribe');

Alternativ können Sie der Route auch die Middleware Illuminate\Routing\Middleware\ValidateSignature zuweisen. Wenn sie noch nicht vorhanden ist, sollten Sie dieser Middleware einen Schlüssel im routeMiddleware-Array Ihres HTTP-Kernels zuweisen:

/**
 * The application's route middleware.
 *
 * These middleware may be assigned to groups or used individually.
 *
 * @var array
 */
protected $routeMiddleware = [
    'signed' => \Illuminate\Routing\Middleware\ValidateSignature::class,
];

Sobald Sie die Middleware in Ihrem Kernel registriert haben, können Sie sie an eine Route anhängen. Wenn die eingehende Anforderung keine gültige Signatur hat, gibt die Middleware automatisch eine 403-Fehlerantwort zurück:

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

URLs For Controller Actions

Die Action-Funktion erzeugt eine URL für die angegebene Controller-Aktion. Sie müssen nicht den gesamten Namensraum des Controllers übergeben. Stattdessen übergeben Sie den Namen der Controller-Klasse relativ zum Namensraum App\Http\Controllers:

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

Sie können auch auf Aktionen mit einer "callable"-Array-Syntax verweisen:

use App\Http\Controllers\HomeController;

$url = action([HomeController::class, 'index']);

Wenn die Controller Method Routenparameter akzeptiert, können Sie diese als zweites Argument an die Funktion übergeben:

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

Default Values

Für einige Anwendungen können Sie für bestimmte URL-Parameter anforderungsweite Standardwerte festlegen. Stellen Sie sich zum Beispiel vor, dass viele Ihrer Routen einen {locale} Parameter definieren:

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

Es ist umständlich, das Gebietsschema (locale) jedes Mal zu übergeben, wenn Sie den route-Helper aufrufen. Sie können also mit der Methode URL::defaults einen Standardwert für diesen Parameter definieren, der immer während der aktuellen Anforderung angewendet wird. Möglicherweise möchten Sie diese Methode von einer Route-Middleware aus aufrufen, damit Sie Zugriff auf die aktuelle Anforderung (Request) haben:

<?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);
    }
}

Nachdem der Standardwert für den locale-Parameter festgelegt wurde, müssen Sie seinen Wert nicht mehr übergeben, wenn Sie URLs über den route-Helper generieren.