Tusk PHP

Un servidor de lenguaje PHP, escrito en Go

Asistencia para PHP rápida y que entiende tu framework, en un solo binario pequeño.

Autocompletado, hover, navegación, refactorización y diagnósticos que entienden Laravel, Symfony, WordPress y Magento 2, de PHP 7.4 a 8.5. Está listo en menos de un tercio de segundo en una app Laravel de 9.700 archivos, y sirve a los editores por LSP, a la CI con tusk-php check y a los agentes de IA por MCP.

0
versiones desde el 21 de marzo de 2026
0 ms
hasta la primera respuesta con 9.700 archivos
7.4→8.5
versiones de PHP, toda la sintaxis
0
reglas de diagnóstico nativas
0/37
funciones de genéricos de PHPStan, completas
0
frameworks con soporte específico

Novedades en 0.14.0

Tipos según la rama, estrechamiento con instanceof y nuevos diagnósticos

Una variable ahora puede tener más de un tipo a la vez, e instanceof lo estrecha, tal como lo ve PHP. El hover, el autocompletado y los diagnósticos coinciden, la escritura nunca espera a los diagnósticos y tusk-php check lleva los mismos resultados a tu CI.

app/Services/Uploader.php
if ($request->boolean('remote')) {
    $disk = new S3Disk($config);
} else {
    $disk = new LocalDisk($root);
}

$diskS3Disk|LocalDisk $disk->put($path, $contents);

NuevoAntes de la 0.14.0 solo contaba la última asignación: LocalDisk.

$user = $request->user();

if (! $user instanceof Admin) {
    abort(403);
}

if ($user->ƒ canImpersonate()boolƒ permissions()arrayƒ getAuthIdentifier()mixed) { … }

NuevoTambién después de assert(), en elseif y match (true), y después de && o ||.

try {
    $post = Post::findOrFail($id);
} catch (ModelNotFoundException $e) {
    return response($e->ƒ getModel()?stringƒ getIds()arrayƒ setModel()staticƒ getMessage()string);
}

Nuevocatch (A|B $e) da A|B, y se avisa de los miembros desconocidos.

// Mailer::send(string $to, string $subject)

$mailer->send⚠ Too few arguments to send(): 1 passed, at least 2 required
argument-count-mismatch
($order->email);

NuevoAquí PHP lanzaría un ArgumentCountError. Los argumentos de más en un método ya no se avisan: PHP los permite.

if (method_exists($notification, 'toArray')) {
    return $notification->toArray✓ Sin aviso: la llamada se comprueba antes($notifiable);
}

// También se entienden: property_exists(), is_callable([$x, 'name']),
// los returns tempranos y los ternarios sobre el mismo receptor.

AntesUnknown member 'toArray' on 'Notification'

$measure = strlen(...);
$bound   = $measure->bindTo(null);

$measureClosure(string $string): int('tusk'); // int

NuevoLa sintaxis de callable de primera clase da un Closure con la firma de la función llamada.

  • Tipos de variable según la rama

    Después de if/else, switch, try, bucles y ??=, una variable tiene los tipos de todas las ramas. El hover muestra la unión completa.

  • instanceof estrecha las variables

    Dentro del if, después de una guarda que retorna y en match (true). Un Foo|Bar comprobado contra Foo es Bar en el else.

  • Variables de catch tipadas

    $e-> completa los métodos de la clase capturada, también en el hover y en los diagnósticos.

  • Faltan argumentos

    Se avisa en funciones, llamadas estáticas y llamadas con -> sobre una clase conocida, donde PHP lanzaría una excepción. Los argumentos con nombre, los spreads y __call no se comprueban.

  • Las guardas silencian los avisos de miembro desconocido

    method_exists(), property_exists() e is_callable() silencian el aviso de miembro desconocido en la llamada que protegen.

  • Importaciones automáticas con alias cuando el nombre ya está en uso

    Al completar una clase cuyo nombre ya está en uso, se importa con un alias, User as UserAuth. El estilo se elige con autoImport.aliasStyle.

  • Otras correcciones
    • · $this->type::tryFrom() y new static::$builder()
    • · Funciones que devuelven por referencia, &__get($name)
    • · Parámetros de closures que ocultan una variable exterior
    • · Propiedades de DateInterval, $this->$name = …
    • · $q = $q->where() conserva su tipo, y se ignoran los comentarios después de una asignación
    • · Un comentario en una lista de parámetros, getValues(/* … */), no es un parámetro
    • · Se resuelven los métodos después de una lista de argumentos larga de varias líneas, hasta 2.000 líneas
NuevoLínea de comandos

Diagnósticos desde la línea de comandos con tusk-php check

tusk-php check indexa el proyecto igual que el servidor, con tu versión de PHP, tu framework y tus diagnosticRules, y muestra lo que mostraría tu editor. Sale con 1 si hay errores o avisos.

  • ✓Un proyecto entero, o los archivos, directorios y globs que indiques
  • ✓Texto en formato path:line:col, o --format json
  • ✓Una línea base (baseline), para que la CI solo falle con hallazgos nuevos, aunque el código cambie de sitio
laravel/framework
$ tusk-php check src/Illuminate \
    --write-baseline .tusk-baseline.txt >/dev/null
1670 files, 96 findings (indexed in 4.816s, checked in 4.976s)

$ tusk-php check src/Illuminate \
    --baseline .tusk-baseline.txt
1670 files, 96 findings, 0 not in the baseline, 0 in the
baseline no longer found (indexed in 2.385s, checked in 4.836s)

$ echo $?
0

El código fuente del propio framework de Laravel, en un Apple M3 Max.

Historial de versiones

18 versiones desde marzo de 2026

Todas las versiones desde la 0.1.0, de la más reciente a la más antigua. Las respuestas correctas van antes que las funciones nuevas, y ningún cambio puede hacer esperar a la escritura.

Versiones por mes, 2026parches incluidos

Soporte del lenguaje

Funciones admitidas por área

Todo lo marcado como incluido está en main y sale en la 0.14.0. También listamos lo que falta, para que sepas qué esperar.

IncluidoEn cursoAún no

Cobertura por área

elementos listados en esta página

De PHP 7.4 a 8.5

La versión se toma de tu plataforma de Composer, de .tusk-php.json o de tu php local. Cada función se comprueba con el servidor en marcha: el autocompletado, el hover, la definición y los diagnósticos la reconocen.

Diagnósticos y herramientas

Diagnósticos nativos, PHPStan y Laravel Pint

Las reglas nativas se ejecutan en segundo plano cuando haces una pausa al escribir. PHPStan y Laravel Pint se ejecutan al guardar, desde tu proyecto, y sus resultados aparecen junto a los nuestros sin mezclarse.

Diagnósticos nativos

Integrado

18 reglas con códigos estables, además de los errores de sintaxis. Cada una se puede desactivar o tener su propia severidad en diagnosticRules.

  • ✓Se comprueba en segundo plano cuando haces una pausa al escribir
  • ✓Una severidad por regla, de off a error
  • ✓Respeta tu versión de PHP y tus extensiones de composer.json
  • ✓El código sin usar aparece en gris y el obsoleto, tachado
  • ✓Eloquent: columnas y relaciones desconocidas en los query builders
  • ✓Blade: solo se comprueba el PHP dentro de una vista
  • ✓Los mismos resultados desde la línea de comandos, con tusk-php check
Tiempo de diagnóstico, 329 archivos de tests de Laravel
0.12.013,7 s
0.13.0+3,4 s

PHPStan

Al guardar

Si PHPStan está instalado en tu proyecto, Tusk PHP lo ejecuta al guardar con tu propia configuración y nivel, y muestra lo que encuentra en el archivo que estás editando.

  • ✓Tu phpstan.neon, tu línea base y tu nivel
  • ✓Separado de las reglas nativas, con su propio origen
  • ✓Solo se ejecuta al guardar, nunca mientras escribes
  • ✓Los genéricos se leen como los define PHPStan, así que ambos coinciden en los tipos
  • –No disponible en la compilación para navegador (vscode.dev)
"tuskPhpLsp.diagnostics.phpstan.enable": true

Laravel Pint

Al guardar

Pint comprueba el estilo de tu código al guardar e informa de lo que cambiaría, con tu pint.json. Pint sigue siendo el formateador: no vamos a publicar uno que compita con él.

  • ✓Los problemas de estilo, como diagnósticos, a partir de la ejecución de prueba de Pint
  • ✓El binario y el preset de Pint de tu proyecto
  • ✓Sin formateador propio: Pint sigue siendo el único
  • ○Aplicar las correcciones de Pint desde el editor: aún no
  • –No disponible en la compilación para navegador (vscode.dev)
"tuskPhpLsp.diagnostics.pint.enable": true
Cobertura de tests

El hover muestra qué parte de un método cubren tus tests, con su puntuación CRAP, a partir del informe Clover de PHPUnit o de Pest. También funcionan los informes generados en Docker y Sail.

🟡 ████░ 80% · 12/15 · CRAP 5
Agentes de IA (MCP)

tusk-php mcp da a Claude Code, Codex y Cursor el mismo índice que a tu editor: símbolos, diagnósticos, rutas, modelos, cobertura y el esquema de tu base de datos.

Hover de Composer y paquetes sin usar

Pasa el cursor sobre un paquete en composer.json para ver su versión instalada y su compatibilidad con PHP. tusk-php deps unused encuentra los paquetes que no usas.

Compilación para WebAssembly

Una compilación para WebAssembly hace funcionar la extensión en vscode.dev, por debajo de unos 448 MB de memoria.

Rendimiento

Comparativa con otros servidores de lenguaje PHP

Todos los servidores reciben las mismas peticiones en las mismas posiciones del cursor, por stdio y con la caché en frío. El número de respuestas correctas se publica junto a los tiempos.

Apple M3 Max, PHP 8.5.11, medido el 9 de noviembre de 2026 con el código de la 0.13.0 de Tusk PHP, Intelephense 1.18.5, Phpactor 2026.06.23.0, php-lsp 0.25.1 y PHPantom 0.10.0. Las respuestas correctas abarcan autocompletado, definición, hover, referencias, ayuda de firmas, símbolos y diagnósticos. Para reproducirlo: make bench.

Tiempos de respuesta

Mediana de las respuestas correctas en la app Laravel, tras el arranque.

0,2 ms
autocompletado
0,1 ms
hover
0,1 ms
ir a la definición
<0,1 ms
ayuda de firmas

Respuestas correctas antes y después de la 0.13.0

Preguntas del benchmark respondidas correctamente.

Symfony7 → 11 de 11
Laravel11 → 14 de 19
6 novganadas con la 0.13.0pendientes

Diagnósticos en segundo plano

Nuevo en 0.14.0

Tras una edición, los diagnósticos se calculan en segundo plano cuando haces una pausa de unos 200 ms, así que el autocompletado, el hover y la ayuda de firmas responden al momento. Se descartan los resultados de un texto que ya has cambiado.

Autocompletado justo después de pulsar una tecla, en un archivo de 6.700 líneas
0.13.0~440 ms
0.14.0<40 ms

Avisos en proyectos reales, 0.12.0 comparada con 0.13.0

Avisos reportados sobre las mismas muestras del código fuente de cada proyecto, 0.12.0 frente a 0.13.0. Los genéricos eliminaron 80 más en sus propias muestras.

0.12.00.13.0

Instalación

Extensiones para editores, binarios y el servidor MCP

Las extensiones incluyen el servidor y lo fijan por SHA-256, así que no hay nada más que instalar. Todos los valores por defecto están elegidos para funcionar sin configuración.

VS Code y VSCodium

Disponible

Proyectos locales, Remote SSH y vscode.dev en el navegador.

Zed

Pronto en el registro

La publicación en el registro de extensiones de Zed está pendiente de revisión. Mientras tanto, instálala como extensión de desarrollo.

Neovim y cualquier editor con LSP

Disponible

Binarios para Linux, macOS y Windows, en amd64 y arm64.

tusk-php --transport stdio

Agentes de IA

Disponible

Claude Code, Codex, Cursor y cualquier cliente MCP por stdio obtienen los símbolos, diagnósticos, rutas, modelos, cobertura y esquema de base de datos de tu proyecto.

claude mcp add tusk-php -- tusk-php mcp --root "$(pwd)"

Descarga

Licencia MIT

Todas las versiones, con sumas de verificación y la compilación para WebAssembly.

Hoja de ruta

Hitos en curso

Cada hito tiene una issue pública de seguimiento. ¿Has encontrado una respuesta incorrecta? Un fragmento corto de PHP en GitHub es la forma más rápida de que se corrija.

Tusk PHP 0.14.0 para VS Code, Zed, Neovim y agentes de IA

Gratuito y de código abierto, con licencia MIT.