Schnellstart

Du benötigst eine bestehende Laravel-11-, -12- oder -13-Anwendung mit funktionierender Datenbank und PHP 8.2+; Laravel 13 benötigt PHP 8.3+. Der Core ist unter der MIT-Lizenz kostenlos. Ein Konto oder eine Pro-Lizenz ist nicht erforderlich.

Installation

Führe diese Befehle im Verzeichnis deiner Anwendung aus:

bash

composer require rankbeam/laravel-seo
php artisan vendor:publish --tag=seo-config
php artisan migrate

Der Service Provider wird automatisch registriert. Die Migration erstellt die SEO-Tabellen, aber keine Inhaltsmodelle für deine Anwendung.

Vor dem Beispiel

Die folgenden Schritte setzen ein Post-Modell, einen gespeicherten Beitrag und eine Route posts.show voraus. Deren Blade-View erhält den Beitrag als $post. Passe die Namen an deine Anwendung an. Diese Anleitung ergänzt eine vorhandene Seite um SEO; sie baut keinen Blog auf.

Setze APP_URL in .env auf den öffentlichen Ursprung deiner Website. Für andere Rendering-Stacks gibt es die Anleitungen Inertia und JSON (EN) und Livewire (EN).

1. Trait zum Modell hinzufügen

php

use Illuminate\Database\Eloquent\Model;
use Rankbeam\Seo\Traits\HasSEO;

class Post extends Model
{
    use HasSEO;

    public function getUrlForSEO(): string
    {
        return route('posts.show', $this);
    }
}

getUrlForSEO() liefert dem Resolver die kanonische URL des Modells. Sie wird für Canonical-Tags, og:url und Sitemap-Einträge verwendet.

2. Tags im head ausgeben

blade

<!DOCTYPE html>
<html>
<head>
    @seo($post)
</head>

@seo($post) gibt Titel, Meta-Beschreibung, Canonical, Robots, Open Graph, Twitter Card und vorhandenes JSON-LD aus den aufgelösten Daten aus. Solange keine expliziten Werte gespeichert sind, verwendet der Resolver Modellattribute und konfigurierte Vorgaben. Die Resolver-Priorität beschreibt die Reihenfolge.

3. Explizite Werte setzen

php

$post->saveSEO([
    'title' => 'Custom SEO Title',
    'description' => 'Custom meta description',
]);

Explizite Werte haben Vorrang vor allen Fallbacks. Für übersetzte Metadaten übergibst du zusätzlich die Sprache: $post->saveSEO(['title' => 'Titre'], 'fr').

Modelle mit Seedern anlegen

Laravels standardmäßiger DatabaseSeeder verwendet WithoutModelEvents. Dadurch wird auch der automatische Erstellungs-Hook von HasSEO deaktiviert. Entferne diesen Trait oder rufe saveSEO() im Seeder ausdrücklich auf.

4. Ergebnis prüfen

Öffne die öffentliche Beitragsseite und wähle Seitenquelltext anzeigen. Prüfe im <head>, ob der Titel Custom SEO Title enthält, die Beschreibung Custom meta description lautet und der Canonical auf die öffentliche Beitrags-URL zeigt. Der konfigurierte Titelsuffix kann auf den Titel folgen.

Gib @seo($post) genau einmal pro Seite aus. Erzeugt dein Layout bereits Titel oder Metatags, ersetze diese, damit keine Duplikate entstehen. Bei unerwarteten Werten hilft die Anleitung zur Auflösung (EN).

5. Optional eine Sitemap ergänzen

php

// e.g. in AppServiceProvider::boot()
use App\Models\Post;
use Rankbeam\Seo\Facades\SEO;

SEO::sitemaps()->register('posts', Post::class);

bash

composer require spatie/laravel-sitemap
php artisan seo:sitemap

/sitemap.xml liefert nun den erzeugten Index. Weitere Optionen stehen in der Sitemap-Anleitung.

Nächste Schritte

Resolver-Priorität — Auswahl der Werte
Blade (EN) — alle sieben Direktiven
Inertia und JSON (EN) — Headless-Ausgabe
Schema-Graph (EN) — verknüpftes JSON-LD
Filament-Felder — Verwaltungsoberfläche

Schnellstart ​

Installation ​

Vor dem Beispiel ​

1. Trait zum Modell hinzufügen ​

2. Tags im head ausgeben ​

3. Explizite Werte setzen ​

4. Ergebnis prüfen ​

5. Optional eine Sitemap ergänzen ​

Nächste Schritte ​