Laravel LSP – IDE-Erweiterung per Language Server Protocol

Dieser Artikel entspricht dem Stand von v0.0.27, Juli 2026. Das Paket ist inzwischen bei Packagist registriert und lässt sich mit composer global require laravel/lsp installieren.

Was ist Laravel LSP?

Laravel LSP (Language Server Protocol) ist das offizielle Tool, das IDE-Funktionen mit Bewusstsein für das Laravel-Framework in Editoren bereitstellt. Das Language Server Protocol ist der Standardprotokoll für die Kommunikation zwischen LSP-Clients (Editoren) und LSP-Servern (Laravel LSP). Dadurch wird ein einheitliches Entwicklungserlebnis über mehrere Editoren hinweg möglich. Von Laravel LSP bereitgestellte Funktionen:

Autovervollständigung – automatische Vervollständigung für Routen, Views, Config-Keys, Übersetzungs-Keys, Livewire-Komponenten usw.
Hover-Informationen – beim Überfahren mit dem Cursor werden Erklärungen, Dokumentation und Kontextinfos angezeigt
Diagnosen – Erkennung von Codeproblemen in Echtzeit
Dokumentlinks – Verlinkungen zwischen Dateien und Ressourcen
Quick Fixes – automatische Behebungsvorschläge für gängige Probleme
Springen zur Definition – Sprung an die Definition eines Symbols

Warum das nötig ist

Die Standard-PHP-Autovervollständigung eines Editors versteht die Abstraktionsschichten des Laravel-Frameworks nicht. Beispielsweise:

keine Autovervollständigung für das erste Argument von Route::get() (URI-Pattern)
keine Vervollständigung realer View-Dateinamen für den View-Namen in view('users.index')
Config-Keys wie config('app.name') und Übersetzungs-Keys wie trans('messages.welcome') sind kein Vervollständigungsziel
Innerhalb von Blade-Templates gibt es standardmäßig keine Vervollständigung oder Validierung

Laravel LSP versteht diesen „Framework-spezifischen Kontext” und liefert präzise Vervollständigung und Diagnosen.

Installation

Globale Installation

Installation global über Composer:

composer global require laravel/lsp

Stellen Sie sicher, dass das globale Bin-Verzeichnis von Composer in PATH liegt; danach lässt sich der Server so starten:

laravel-lsp

Installation aus dem Quellcode

Möchten Sie die Entwicklerversion nutzen, klonen Sie das Repository und führen es aus:

gh repo clone laravel/lsp
cd lsp
composer install
php server

Richten Sie einen Shell-Alias ein, um das Kommando laravel-lsp verwenden zu können:

# Für Zsh
echo 'alias laravel-lsp="php /path/to/lsp/server"' >> ~/.zshrc
source ~/.zshrc

# Für Bash
echo 'alias laravel-lsp="php /path/to/lsp/server"' >> ~/.bashrc
source ~/.bashrc

Editor-spezifische Konfiguration

Da Laravel LSP das Standard-LSP-Protokoll verwendet, funktioniert es in jedem Editor, der LSP unterstützt. Nachfolgend die Konfiguration für gängige Editoren.

Sublime Text

Installieren und konfigurieren Sie die offizielle Laravel Sublime Text extension.

Zed

Installieren und konfigurieren Sie die offizielle Laravel Zed extension.

VS Code

Installieren und konfigurieren Sie die offizielle Laravel VS Code extension.

Cursor

Da Cursor VS-Code-Erweiterungen unterstützt, können Sie die oben genannte Laravel VS Code extension direkt verwenden.

Neovim

Ab Neovim 0.11 lassen sich benutzerdefinierte LSP-Konfigurationen direkt hinzufügen:

vim.lsp.config("laravel_lsp", {
    cmd = { "laravel-lsp" },
    filetypes = { "php", "blade" },
    root_markers = { "artisan", "composer.json", ".git" },
})

vim.lsp.enable("laravel_lsp")

Wenn Sie nvim-lspconfig verwenden, registrieren Sie es wie folgt:

local lspconfig = require("lspconfig")
local configs = require("lspconfig.configs")

if not configs.laravel_lsp then
    configs.laravel_lsp = {
        default_config = {
            cmd = { "laravel-lsp" },
            filetypes = { "php", "blade" },
            root_dir = lspconfig.util.root_pattern("artisan", "composer.json", ".git"),
        },
    }
end

lspconfig.laravel_lsp.setup({})

OpenCode

Aktivieren Sie in opencode.json die LSP-Unterstützung und richten Sie Laravel LSP als benutzerdefinierten Server ein:

{
    "$schema": "https://opencode.ai/config.json",
    "lsp": {
        "laravel-lsp": {
            "command": ["laravel-lsp"],
            "extensions": [".php", ".blade.php"]
        }
    }
}

Konfiguration in der GitHub Copilot CLI

Wenn Sie die GitHub Copilot CLI verwenden, konfigurieren Sie Laravel LSP global in ~/.copilot/lsp-config.json. Eine separate Editor-Konfiguration ist nicht erforderlich:

{
  "lspServers": {
    "laravel-lsp": {
      "command": "laravel-lsp",
      "fileExtensions": {
        ".php": "php",
        ".blade.php": "blade"
      }
    }
  }
}

Da die LSP-Server-Konfiguration der Copilot CLI auch initializationOptions unterstützt, sind alle unten beschriebenen Detaileinstellungen möglich.

Konfigurationsoptionen

LSP-Clients können Detaileinstellungen über initializationOptions an Laravel LSP übergeben.

Erkennung der PHP-Umgebung

Mit der Option phpEnvironment steuern Sie das PHP-Kommando, das zur Indexierung der Projektdaten verwendet wird. Standard ist auto (automatische Erkennung):

Wert	Verhalten des PHP-Kommandos
`auto`	Erkennung in der Reihenfolge Herd → Valet → Sail → Lando → DDEV → lokales PHP
`herd`	verwendet `herd which-php`
`valet`	verwendet `valet which-php`
`sail`	verwendet `./vendor/bin/sail php`, während Sail läuft
`lando`	verwendet `lando php`
`ddev`	verwendet `ddev php`
`local`	verwendet direkt die lokale PHP-Binary

Wenn die Erkennung fehlschlägt oder ein ungültiger Wert übergeben wird, greift php als Fallback.

Beispiel für die Basiskonfiguration

{
    "phpEnvironment": "auto",
    "phpCommand": ["php"],
    "definitionProvider": false
}

Docblocks für Pest-Helper

Diese Option kam in v0.0.27 hinzu. Wenn sich Pest-Tests oder die Composer-Autoload-Dateien ändern, werden die Docblocks für die Pest-Helper automatisch generiert und aktualisiert:

Option	Typ	Standardwert	Beschreibung
`pestGenerateDocBlocks`	`boolean`	`true`	Ob Docblocks für Pest-Helper generiert und fortlaufend aktualisiert werden
`pestHelperFilePath`	`string`	`"storage/framework/testing/_pest.php"`	Ausgabepfad der Pest-Helper-Datei (relativ zum Projektstamm)

{
    "pestGenerateDocBlocks": true,
    "pestHelperFilePath": "storage/framework/testing/_pest.php"
}

Konfiguration pro Funktion

Jede Funktion lässt sich einzeln ein- und ausschalten. Übliche Suffixe sind Completion, Diagnostics, Hover, Link usw.:

{
    "routeCompletion": true,
    "routeDiagnostics": true,
    "viewDiagnostics": false,
    "translationHover": true,
    "configLink": true,
    "envCompletion": true,
    "bladeComponentLink": true
}

Übersicht der bereitgestellten Funktionen

Funktionsbereich	Vervollständigung	Hover	Diagnose	Link	Quick Fix
Routen	✓	✓	✓	✓	-
Views und Blade	✓	✓	✓	✓	✓
Übersetzungen	✓	✓	-	-	-
Konfiguration	✓	✓	✓	✓	-
Umgebungsvariablen	✓	✓	✓	✓	✓
Assets und Mix	✓	✓	✓	✓	-
Middleware	✓	✓	✓	✓	-
Inertia	✓	-	✓	✓	-
Livewire	✓	✓	-	✓	-
Auth und Policies	✓	✓	✓	✓	-
Container-Bindings	✓	✓	✓	✓	-
Validation	✓	-	-	-	-
Controller-Actions	✓	-	✓	✓	-
Eloquent	✓	-	-	-	-

Schnellstart

Installieren – composer global require laravel/lsp
Editor konfigurieren – siehe die editor-spezifischen Anleitungen oben
Laravel-Projekt öffnen – der Server indiziert vom Root aus Projektdaten wie Routes, Views, Translations und Config
Autovervollständigung nutzen – in PHP-Dateien und Blade-Templates arbeitet die Framework-bewusste Vervollständigung automatisch

Fazit

Laravel LSP steigert das Entwicklererlebnis erheblich. Es versteht Framework-spezifischen Kontext, den der Editor-Standard nicht abbildet, und liefert präzisere und nützlichere Vervollständigungen und Diagnosen. Voraussetzungen:

PHP 8.2 oder höher
Composer
LSP-fähiger Editor (Sublime Text, Neovim, Cursor, VS Code usw.)

Weiterführende Ressourcen:

Changelog

Laravel 13

Produkte

Paketvorstellungen

Untersuchung neuer Repositories

Upgrade-Anleitungen

Authentifizierung

Frontend

Einrichtung der Umgebung

Laravel LSP – IDE-Erweiterung per Language Server Protocol

Was ist Laravel LSP?

Warum das nötig ist

Installation

Globale Installation

Installation aus dem Quellcode

Editor-spezifische Konfiguration

Sublime Text

Zed

VS Code

Cursor

Neovim

OpenCode

Konfiguration in der GitHub Copilot CLI

Konfigurationsoptionen

Erkennung der PHP-Umgebung

Beispiel für die Basiskonfiguration

Docblocks für Pest-Helper

Konfiguration pro Funktion

Übersicht der bereitgestellten Funktionen

Schnellstart

Fazit

​Was ist Laravel LSP?

​Warum das nötig ist

​Installation

​Globale Installation

​Installation aus dem Quellcode

​Editor-spezifische Konfiguration

​Sublime Text

​Zed

​VS Code

​Cursor

​Neovim

​OpenCode

​Konfiguration in der GitHub Copilot CLI

​Konfigurationsoptionen

​Erkennung der PHP-Umgebung

​Beispiel für die Basiskonfiguration

​Docblocks für Pest-Helper

​Konfiguration pro Funktion

​Übersicht der bereitgestellten Funktionen

​Schnellstart

​Fazit

Was ist Laravel LSP?

Warum das nötig ist

Installation

Globale Installation

Installation aus dem Quellcode

Editor-spezifische Konfiguration

Sublime Text

Zed

VS Code

Cursor

Neovim

OpenCode

Konfiguration in der GitHub Copilot CLI

Konfigurationsoptionen

Erkennung der PHP-Umgebung

Beispiel für die Basiskonfiguration

Docblocks für Pest-Helper

Konfiguration pro Funktion

Übersicht der bereitgestellten Funktionen

Schnellstart

Fazit