Laravel LSP — extensión de funciones del IDE mediante Language Server Protocol

Este artículo se basa en la v0.0.27, información de julio de 2026. Ya está publicada en Packagist y puede instalarse con composer global require laravel/lsp.

Qué es Laravel LSP

Laravel LSP (Language Server Protocol) es la herramienta oficial que ofrece al editor funcionalidades de IDE conscientes del framework Laravel. El Language Server Protocol es un protocolo estándar de comunicación entre un cliente LSP (el editor) y un servidor LSP (Laravel LSP); esto permite lograr una experiencia de desarrollo uniforme en varios editores. Funciones que ofrece Laravel LSP:

Autocompletado — autocompletado de rutas, vistas, claves de configuración, claves de traducción, componentes de Livewire, etc.
Información en hover — al pasar el cursor muestra descripciones, documentación e información contextual.
Diagnósticos — detección en tiempo real de problemas en el código.
Enlaces de documento — enlaces entre archivos y recursos.
Correcciones rápidas — sugerencias de corrección automática para problemas comunes.
Ir a definición — navegación a la ubicación donde se define el símbolo.

Por qué es necesario

El autocompletado de PHP estándar del editor no comprende las capas de abstracción del framework Laravel. Por ejemplo:

Al escribir el primer argumento de Route::get() con un patrón de URI, no hay autocompletado.
Al escribir el nombre de vista de view('users.index'), el editor no autocompleta con nombres reales de archivos de vista.
Las claves de los archivos de configuración (config('app.name')) o las claves de traducción (trans('messages.welcome')) quedan fuera del alcance del autocompletado.
El autocompletado y la validación dentro de las plantillas Blade tampoco están cubiertos por el editor estándar.

Laravel LSP comprende ese «contexto específico del framework» y ofrece autocompletado y diagnósticos precisos.

Instalación

Instalación global

Instálalo globalmente con Composer:

composer global require laravel/lsp

Verifica que el directorio de binarios globales de Composer está en el PATH y podrás arrancarlo con:

laravel-lsp

Instalación desde el código fuente

Si quieres usar la versión de desarrollo, clona el repositorio y ejecútalo:

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

Configura un alias de shell para poder usar el comando laravel-lsp:

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

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

Guía de configuración por editor

Laravel LSP utiliza el protocolo LSP estándar, así que funciona en cualquier editor que soporte LSP. A continuación se presentan los métodos de configuración de los editores principales.

Cursor

Cursor es compatible con las extensiones de VS Code, así que la extensión oficial de Laravel para VS Code también funciona tal cual.

Neovim

En Neovim 0.11 o superior puedes añadir directamente una configuración LSP personalizada:

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, regístralo de la siguiente forma:

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

Activa el soporte LSP en opencode.json y configura Laravel LSP como servidor personalizado:

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

Configuración en GitHub Copilot CLI

Si utilizas GitHub Copilot CLI, puedes configurarlo globalmente en ~/.copilot/lsp-config.json. No hace falta ninguna configuración adicional del editor:

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

La configuración de servidor LSP de Copilot CLI también soporta initializationOptions, así que puedes utilizar todas las opciones de configuración detalladas que se describen a continuación.

Opciones de configuración

El cliente LSP puede pasar opciones detalladas a Laravel LSP a través de initializationOptions.

Detección del entorno PHP

Con la opción phpEnvironment controlas el comando PHP que se usa para indexar los datos del proyecto. Por defecto es auto, que hace detección automática:

Valor	Comportamiento del comando PHP
`auto`	Detecta en el orden Herd → Valet → Sail → Lando → DDEV → PHP local
`herd`	Usa `herd which-php`
`valet`	Usa `valet which-php`
`sail`	Usa `./vendor/bin/sail php` mientras Sail esté en ejecución
`lando`	Usa `lando php`
`ddev`	Usa `ddev php`
`local`	Utiliza directamente el binario de PHP local

Si la detección falla o se pasa un valor inválido, hace fallback a php.

Ejemplo de configuración básica

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

Docblocks de helpers de Pest

Opción añadida en la v0.0.27. Cuando cambian los tests de Pest o el archivo de autoload de Composer, genera y actualiza automáticamente el docblock para los helpers de Pest:

Opción	Tipo	Valor por defecto	Descripción
`pestGenerateDocBlocks`	`boolean`	`true`	Si genera y mantiene actualizado el docblock de los helpers de Pest
`pestHelperFilePath`	`string`	`"storage/framework/testing/_pest.php"`	Ruta de salida del helper de Pest (relativa a la raíz del proyecto)

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

Configuración por funcionalidad

Cada funcionalidad puede activarse o desactivarse individualmente. Los sufijos son Completion, Diagnostics, Hover, Link, etc.:

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

Lista de funcionalidades ofrecidas

Área	Completion	Hover	Diagnostics	Link	Quick fix
Rutas	✓	✓	✓	✓	-
Vistas y Blade	✓	✓	✓	✓	✓
Traducciones	✓	✓	-	-	-
Configuración	✓	✓	✓	✓	-
Variables de entorno	✓	✓	✓	✓	✓
Assets y Mix	✓	✓	✓	✓	-
Middleware	✓	✓	✓	✓	-
Inertia	✓	-	✓	✓	-
Livewire	✓	✓	-	✓	-
Auth y Policies	✓	✓	✓	✓	-
Container Bindings	✓	✓	✓	✓	-
Validation	✓	-	-	-	-
Controller Actions	✓	-	✓	✓	-
Eloquent	✓	-	-	-	-

Inicio rápido

Instalar — composer global require laravel/lsp.
Configurar el editor — consulta la guía por editor arriba.
Abrir el proyecto Laravel — el servidor indexará desde la raíz los datos del proyecto: rutas, vistas, traducciones, configuración, etc.
Usar el autocompletado — dentro de archivos PHP y plantillas Blade, el autocompletado con conocimiento del framework funcionará automáticamente.

Resumen

Laravel LSP es una herramienta que mejora enormemente la experiencia de desarrollo. Comprende el contexto específico del framework, que las funciones estándar del editor no pueden cubrir, y ofrece autocompletado y diagnósticos más precisos y útiles. Requisitos:

PHP 8.2 o superior
Composer
Editor compatible con LSP (Sublime Text, Neovim, Cursor, VS Code, etc.)

Referencias:

Changelog

Laravel 13

Productos

Presentación de paquetes

Análisis de nuevos repositorios

Guías de actualización

Autenticación

Frontend

Configuración del entorno

Laravel LSP — extensión de funciones del IDE mediante Language Server Protocol

Qué es Laravel LSP

Por qué es necesario

Instalación

Instalación global

Instalación desde el código fuente

Guía de configuración por editor

Sublime Text

Zed

VS Code

Cursor

Neovim

OpenCode

Configuración en GitHub Copilot CLI

Opciones de configuración

Detección del entorno PHP

Ejemplo de configuración básica

Docblocks de helpers de Pest

Configuración por funcionalidad

Lista de funcionalidades ofrecidas

Inicio rápido

Resumen

​Qué es Laravel LSP

​Por qué es necesario

​Instalación

​Instalación global

​Instalación desde el código fuente

​Guía de configuración por editor

​Sublime Text

​Zed

​VS Code

​Cursor

​Neovim

​OpenCode

​Configuración en GitHub Copilot CLI

​Opciones de configuración

​Detección del entorno PHP

​Ejemplo de configuración básica

​Docblocks de helpers de Pest

​Configuración por funcionalidad

​Lista de funcionalidades ofrecidas

​Inicio rápido

​Resumen

Qué es Laravel LSP

Por qué es necesario

Instalación

Instalación global

Instalación desde el código fuente

Guía de configuración por editor

Sublime Text

Zed

VS Code

Cursor

Neovim

OpenCode

Configuración en GitHub Copilot CLI

Opciones de configuración

Detección del entorno PHP

Ejemplo de configuración básica

Docblocks de helpers de Pest

Configuración por funcionalidad

Lista de funcionalidades ofrecidas

Inicio rápido

Resumen