Extensión oficial de Laravel para VS Code: ¡Ya disponible en Beta!

En octubre de 2024, Laravel anunció oficialmente que estaba trabajando en una extensión para Visual Studio Code. Desde entonces, muchos nos quedamos a la expectativa de cuándo la veríamos en acción y qué características traería bajo el brazo. ¡La espera ha terminado! El 16 de diciembre de 2024, el equipo de Laravel publicó la primera versión Beta de esta extensión en el Marketplace de VS Code.

¿Dónde conseguirla y qué ofrece?

La extensión ya está disponible de forma pública en el Visual Studio Marketplace. Puedes instalarla directamente desde Visual Studio Code abriendo la pestaña de extensiones (o con el atajo Ctrl + Shift + X / Cmd + Shift + X en macOS) y buscando Laravel.

Aunque se encuentra en versión Beta, la extensión promete un conjunto de funcionalidades que simplifican el desarrollo en Laravel, tales como:

• Resaltado inteligente (intellisense) para Blade y archivos de configuración.

• Autocompletado de directivas y funciones específicas de Laravel.

• Navegación rápida a rutas, controladores y archivos Blade.

• Snippets para facilitar la creación de componentes, directivas y estructuras típicas de Laravel.

• Integración con Artisan para ejecutar comandos sin salir del editor.

Adiós a la multiplicidad de extensiones

Hasta ahora, la comunidad se apoyaba en diferentes extensiones separadas para Blade, para Artisan, para autocompletado de rutas, etc. Esta iniciativa unifica las necesidades más comunes de un desarrollador Laravel en un solo paquete, garantizando una experiencia más coherente y (al menos en teoría) con menos conflictos de configuración.

Características

Una lista no exhaustiva de las funcionalidades cubiertas por la extensión:

App Bindings

• Ejemplos:

  app('auth')
  App::make('auth.driver')
  app()->make('auth.driver')
  App::bound('auth.driver')
  App::isShared('auth.driver')

• Autocompletado

• Enlaces directos a los bindings

• Advertencias si el binding no se encuentra

• Información al pasar el ratón (hover)

Assets

• Ejemplo:

  asset('my-amazing-jpeg.png')

• Autocompletado

• Enlaces directos al recurso

• Advertencias si el recurso no se encuentra

Blade

• Resaltado de sintaxis

Config

• Ejemplos:

  config('broadcasting.connections.reverb.app_id');
  Config::get('broadcasting.connections.reverb.app_id');
  Config::getMany([
      'broadcasting.connections.reverb.app_id',
      'broadcasting.connections.reverb.driver',
  ]);
  config()->string('broadcasting.connections.reverb.app_id');

• Autocompletado

• Enlaces directos al valor de configuración

• Advertencias si la configuración no se encuentra

• Información al pasar el ratón (hover)

Eloquent

• Autocompletado de métodos

• Autocompletado de campos (e.g., métodos where, create, make, creación de objetos)

• Autocompletado de relaciones (e.g., métodos with y claves de arrays)

• Autocompletado en subconsultas (e.g., with con claves de arrays y valores como closure)

Env

• Ejemplos:

  env('REVERB_APP_ID');
  Env::get('REVERB_APP_ID');

• Autocompletado

• Enlaces directos al valor en .env

• Advertencias si el valor no se encuentra, con soluciones rápidas:

  • Añadir al archivo .env

  • Copiar valor desde .env.example

• Información al pasar el ratón (hover)

Inertia

• Ejemplos:

  inertia('Pages/Dashboard');
  Inertia::render('Pages/Dashboard');
  Route::inertia('/dashboard', 'Pages/Dashboard');

• Autocompletado

• Enlaces directos a la vista en JavaScript

• Advertencias si la vista no se encuentra, con soluciones rápidas:

  • Crear vista

• Información al pasar el ratón (hover)

Route

• Ejemplos:

  route('dashboard');
  signedRoute('dashboard');
  Redirect::route('dashboard');
  Redirect::signedRoute('dashboard');
  URL::route('dashboard');
  URL::signedRoute('dashboard');
  Route::middleware('auth');
  redirect()->route('dashboard');

• Autocompletado

• Enlaces directos a la definición de la ruta

• Advertencias si la ruta no se encuentra

• Información al pasar el ratón (hover)

Middleware

• Ejemplos:

  Route::middleware('auth');
  Route::middleware(['auth', 'web']);
  Route::withoutMiddleware('auth');

• Autocompletado

• Enlaces directos al middleware correspondiente

• Advertencias si el middleware no se encuentra

• Información al pasar el ratón (hover)

Traducciones

• Ejemplos:

  trans('auth.failed');
  __('auth.failed');
  Lang::has('auth.failed');
  Lang::get('auth.failed');

• Autocompletado

• Enlaces directos a las traducciones

• Advertencias si la traducción no se encuentra

• Información al pasar el ratón (hover)

• Autocompletado de parámetros

Validación

• Ejemplos:

  Validator::validate($input, ['name' => 'required']);
  request()->validate(['name' => 'required']);
  request()->sometimes(['name' => 'required']);

• Autocompletado para cadenas y arrays (excepto combinaciones con | por ahora)

Views

• Ejemplos:

  view('dashboard');
  Route::view('/', 'home');

• Autocompletado

• Enlaces directos a las vistas Blade

• Advertencias si la vista no se encuentra, con soluciones rápidas:

  • Crear vista

• Información al pasar el ratón (hover)

Próximamente

• Integración con el ejecutor de pruebas de VS Code.

• Soporte para Livewire.

• Soporte para Volt.

• Soporte para Pint.

• Mejoras en el autocompletado, enlaces, información al pasar el ratón y diagnósticos en archivos Blade.

Disponibilidad de LSP

El enfoque actual está en crear la mejor experiencia para desarrolladores Laravel en VS Code. Aunque no se descarta la posibilidad de portar esta funcionalidad a un LSP (Language Server Protocol) en el futuro, por ahora no está en la hoja de ruta inmediata.

Conclusión

La llegada de esta extensión oficial es un paso importante para quienes desarrollan con Laravel en Visual Studio Code. Con una sola instalación, se podrá tener acceso a un ecosistema unificado de herramientas y ayudas contextuales, sin necesidad de combinar múltiples extensiones de terceros. Si aún no la has probado, te animo a que instales la versión Beta, explores sus funcionalidades y compartas tu experiencia con la comunidad.

Con esto, quedamos a la espera de futuras actualizaciones y el anuncio de la versión estable. Mientras tanto, esta versión Beta ya supone una excelente noticia para el día a día de cualquier desarrollador Laravel.