Laravel LSP — funzionalità IDE tramite Language Server Protocol

Questo articolo si riferisce alla v0.0.27, informazioni aggiornate a luglio 2026. È ora registrato su Packagist e si installa con composer global require laravel/lsp.

Cos’è Laravel LSP

Laravel LSP (Language Server Protocol) è lo strumento ufficiale che fornisce all’editor funzionalità IDE consapevoli del framework Laravel. Il Language Server Protocol è il protocollo standard di comunicazione tra client LSP (l’editor) e server LSP (Laravel LSP): grazie a questo, ottieni la stessa esperienza di sviluppo su editor diversi. Le funzionalità offerte da Laravel LSP:

Completamento — completamento automatico di route, view, chiavi di config, chiavi di traduzione, componenti Livewire ecc.
Hover — al passaggio del cursore mostra descrizioni, documentazione e informazioni di contesto
Diagnostica — rilevamento in tempo reale dei problemi nel codice
Document link — link tra file e risorse
Quick fix — proposte di correzione automatica per problemi comuni
Jump to definition — salto alla definizione dei simboli

Perché serve

Il completamento PHP di base di un editor non capisce il livello di astrazione del framework Laravel. Ad esempio:

Nel primo argomento di Route::get() non c’è completamento per i pattern URI
Digitando il nome di una view in view('users.index') non ottieni completamento sui file view reali
Le chiavi dei file di config (config('app.name')) e di traduzione (trans('messages.welcome')) non sono completate
Nemmeno completamento e verifica dentro i template Blade sono supportati dall’editor di base

Laravel LSP comprende questi “contesti specifici del framework” e fornisce completamento e diagnostica precisi.

Installazione

Installazione globale

Installa globalmente con Composer:

composer global require laravel/lsp

Verifica che la directory bin globale di Composer sia nel PATH; puoi avviare con:

laravel-lsp

Installazione da sorgenti

Per la versione di sviluppo, clona il repository ed esegui direttamente:

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

Aggiungi un alias di shell per usare laravel-lsp:

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

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

Configurazione per singolo editor

Laravel LSP usa il protocollo LSP standard, quindi funziona con qualsiasi editor che supporti LSP. Ecco come configurare i principali.

Sublime Text

Installa e configura l’estensione ufficiale Laravel Sublime Text extension.

Zed

Installa e configura l’estensione ufficiale Laravel Zed extension.

VS Code

Installa e configura l’estensione ufficiale Laravel VS Code extension.

Cursor

Cursor è compatibile con le estensioni VS Code, quindi puoi usare direttamente Laravel VS Code extension.

Neovim

Con Neovim 0.11 o superiore puoi aggiungere direttamente una configurazione LSP personalizzata:

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

vim.lsp.enable("laravel_lsp")

Con nvim-lspconfig registralo così:

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

In opencode.json abilita il supporto LSP e configura Laravel LSP come server personalizzato:

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

Configurazione con GitHub Copilot CLI

Se usi GitHub Copilot CLI, puoi configurare a livello globale in ~/.copilot/lsp-config.json. Non serve una configurazione separata per l’editor:

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

La configurazione dei server LSP di Copilot CLI supporta anche initializationOptions, quindi puoi usare tutte le opzioni avanzate descritte più avanti.

Opzioni di configurazione

Il client LSP può passare a Laravel LSP configurazioni dettagliate tramite initializationOptions.

Rilevamento dell’ambiente PHP

L’opzione phpEnvironment controlla il comando PHP usato per indicizzare i dati del progetto. Il default è auto:

Valore	Comportamento del comando PHP
`auto`	Rileva nell’ordine: Herd → Valet → Sail → Lando → DDEV → PHP locale
`herd`	Usa `herd which-php`
`valet`	Usa `valet which-php`
`sail`	Con Sail attivo usa `./vendor/bin/sail php`
`lando`	Usa `lando php`
`ddev`	Usa `ddev php`
`local`	Usa direttamente il binario PHP locale

Se il rilevamento fallisce o viene passato un valore non valido, ricade su php.

Esempio di configurazione di base

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

Docblock per gli helper di Pest

Opzione aggiunta in v0.0.27. Genera e aggiorna automaticamente il docblock per gli helper di Pest quando cambiano i test Pest o i file di autoload di Composer:

Opzione	Tipo	Default	Descrizione
`pestGenerateDocBlocks`	`boolean`	`true`	Se generare e mantenere aggiornati i docblock degli helper di Pest
`pestHelperFilePath`	`string`	`"storage/framework/testing/_pest.php"`	Percorso di output degli helper Pest (relativo alla root del progetto)

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

Configurazione per singola funzionalità

Ogni funzionalità può essere abilitata o disabilitata singolarmente. I suffissi sono Completion, Diagnostics, Hover, Link ecc.:

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

Elenco delle funzionalità offerte

Area	Completamento	Hover	Diagnostica	Link	Quick fix
Route	✓	✓	✓	✓	-
View & Blade	✓	✓	✓	✓	✓
Traduzioni	✓	✓	-	-	-
Configurazione	✓	✓	✓	✓	-
Variabili d’ambiente	✓	✓	✓	✓	✓
Asset & Mix	✓	✓	✓	✓	-
Middleware	✓	✓	✓	✓	-
Inertia	✓	-	✓	✓	-
Livewire	✓	✓	-	✓	-
Auth & Policies	✓	✓	✓	✓	-
Binding del container	✓	✓	✓	✓	-
Validazione	✓	-	-	-	-
Action di controller	✓	-	✓	✓	-
Eloquent	✓	-	-	-	-

Quick start

Installa — composer global require laravel/lsp
Configura l’editor — segui la guida per il tuo editor
Apri un progetto Laravel — il server indicizza dalla root i dati del progetto: route, view, traduzioni, config ecc.
Usa il completamento — nei file PHP e nei template Blade il completamento consapevole del framework funziona in automatico

Conclusioni

Laravel LSP è uno strumento che migliora sensibilmente l’esperienza di sviluppo. Comprende contesti specifici del framework che l’editor da solo non gestisce, offrendo completamento e diagnostica più precisi e utili. Requisiti:

PHP 8.2 o superiore
Composer
Editor compatibile LSP (Sublime Text, Neovim, Cursor, VS Code ecc.)

Riferimenti:

Changelog

Laravel 13

Prodotti

Presentazione dei pacchetti

Analisi di nuovi repository

Guide di aggiornamento

Autenticazione

Frontend

Configurazione dell'ambiente

Laravel LSP — funzionalità IDE tramite Language Server Protocol

Cos’è Laravel LSP

Perché serve

Installazione

Installazione globale

Installazione da sorgenti

Configurazione per singolo editor

Sublime Text

Zed

VS Code

Cursor

Neovim

OpenCode

Configurazione con GitHub Copilot CLI

Opzioni di configurazione

Rilevamento dell’ambiente PHP

Esempio di configurazione di base

Docblock per gli helper di Pest

Configurazione per singola funzionalità

Elenco delle funzionalità offerte

Quick start

Conclusioni

​Cos’è Laravel LSP

​Perché serve

​Installazione

​Installazione globale

​Installazione da sorgenti

​Configurazione per singolo editor

​Sublime Text

​Zed

​VS Code

​Cursor

​Neovim

​OpenCode

​Configurazione con GitHub Copilot CLI

​Opzioni di configurazione

​Rilevamento dell’ambiente PHP

​Esempio di configurazione di base

​Docblock per gli helper di Pest

​Configurazione per singola funzionalità

​Elenco delle funzionalità offerte

​Quick start

​Conclusioni

Cos’è Laravel LSP

Perché serve

Installazione

Installazione globale

Installazione da sorgenti

Configurazione per singolo editor

Sublime Text

Zed

VS Code

Cursor

Neovim

OpenCode

Configurazione con GitHub Copilot CLI

Opzioni di configurazione

Rilevamento dell’ambiente PHP

Esempio di configurazione di base

Docblock per gli helper di Pest

Configurazione per singola funzionalità

Elenco delle funzionalità offerte

Quick start

Conclusioni