Projects [SHOW]

08. URL Generation

URL Generation

Einführung

Laravel bietet mehrere Helfer, die Sie bei der Generierung von URLs für Ihre Anwendung unterstützen. Diese sind vor allem hilfreich, wenn Sie Links in Ihren Vorlagen und API-Antworten (Responses) erstellen oder Redirect Responses für einen anderen Teil Ihrer Anwendung generieren.

The Basics

Generating Basic URLs

Der URL-Helfer kann verwendet werden, um beliebige URLs für Ihre Anwendung zu generieren. Die generierte URL verwendet automatisch das Schema (HTTP oder HTTPS) und den Host aus der aktuellen Anfrage:

$post = App\Post::find(1);

echo url("/posts/{$post->id}");

// http://example.com/posts/1

Accessing The Current URL

Wenn dem URL-Helfer kein Pfad angegeben wird, wird eine Illuminate\Routing\UrlGenerator-Instanz zurückgegeben, so dass Sie auf Informationen über die aktuelle URL zugreifen können:

// 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();

Auf jede dieser Methoden kann auch über die URL-Facade zugegriffen werden:

use Illuminate\Support\Facades\URL;

echo URL::current();

more themes about Basics - Click for open

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');

Projects [SHOW]

Laravel 5.8 Dokumentation

Home

Architecture Concepts

Basics

Frontend

Security

Digging Deeper

Database

Eloquent ORM

Official Packages

Testing

Sonstiges

08. URL Generation

URL Generation

The Basics

more themes about Basics - Click for open

URLs For Named Routes

Signed URLs

URLs For Controller Actions

Default Values