Versiones de Node, bun y PHP
Fijar por proyecto la versión de Node, el gestor de paquetes y la versión de PHP, con Vite+ y los builds estáticos de PHP.
La pestaña Runtime (R) muestra lo que el servidor de desarrollo y tus terminales usan en la carpeta del proyecto, y permite fijarlo.

Node y el gestor de paquetes
Joppa se apoya en Vite+, que descarga la versión de Node y el gestor de paquetes (bun, pnpm, npm, yarn) fijados por cada proyecto y luego los pone en el PATH de tus terminales. Si Vite+ no está instalado, la pestaña da el comando para instalarlo.
- Versión de Node: Mantener, Última LTS o una versión concreta.
- Gestor de paquetes y su versión.
- Fijar escribe
.node-versiony el campopackageManagerdepackage.json: todas las terminales y el servidor de desarrollo usan entonces esas versiones (vp env pin).
Joppa lee las versiones en este orden: devEngines, luego un archivo de versión (.node-version, .nvmrc) y luego engines.
PHP
Joppa descarga builds estáticos de PHP (static-php.dev), de la 8.1 a la 8.5, y los guarda en su carpeta.
- Fijar una versión…: elige la versión; Instalar y usar la descarga si hace falta y escribe
.php-versionen la raíz del proyecto. - Quitar fijación elimina
.php-version.
PHP en tus terminales
Joppa pone en su carpeta bin un comando php y un comando composer que leen el .php-version de la carpeta actual (o de una carpeta superior). Para que tus terminales los usen, esta carpeta tiene que estar al principio del PATH.
Añadirlo por mí… (o Ajustes › PHP › Usar el PHP de Joppa en mis terminales) añade este bloque a tu perfil del shell, previa confirmación:
# >>> Joppa (PHP) >>>
export PATH="/Users/tu/Library/Application Support/joppa/bin":"$PATH"
# <<< Joppa (PHP) <<<
| Shell | Archivo modificado |
|---|---|
| zsh | ~/.zshrc |
| bash | ~/.bash_profile (macOS), ~/.bashrc (Linux) |
| fish | ~/.config/fish/conf.d/joppa.fish (con fish_add_path --prepend) |
El bloque se quita desde los mismos ajustes. Abre una terminal nueva después del cambio.
Fuera de los proyectos fijados
Ajustes › PHP › Fuera de los proyectos fijados elige el PHP que se usa en otros sitios: el del sistema o una versión de Joppa.
Composer
Los Ajustes indican qué Composer se usa (el de Joppa o el del sistema). Descargar Composer lo instala en Joppa, tras comprobar su suma de verificación.