Versions de Node, bun et PHP
Épingler par projet la version de Node, le gestionnaire de paquets et la version de PHP, avec Vite+ et les builds statiques de PHP.
L’onglet Runtime (R) montre ce que le serveur de dev et vos terminaux utilisent dans le dossier du projet, et permet de l’épingler.

Node et le gestionnaire de paquets
Joppa passe par Vite+, qui télécharge la version de Node et le gestionnaire de paquets (bun, pnpm, npm, yarn) épinglés par chaque projet, puis les met dans le PATH de vos terminaux. Si Vite+ n’est pas installé, l’onglet donne la commande pour l’installer.
- Version de Node : Garder, Dernière LTS ou une version précise.
- Gestionnaire de paquets et sa version.
- Épingler écrit
.node-versionet le champpackageManagerdepackage.json: tous les terminaux et le serveur de dev utilisent alors ces versions (vp env pin).
Joppa lit les versions dans cet ordre : devEngines, puis un fichier de version (.node-version, .nvmrc), puis engines.
PHP
Joppa télécharge des builds statiques de PHP (static-php.dev), de 8.1 à 8.5, et les range dans son dossier.
- Épingler une version… : choisissez la version ; Installer et utiliser la télécharge si besoin et écrit
.php-versionà la racine du projet. - Retirer l’épinglage supprime
.php-version.
PHP dans vos terminaux
Joppa met dans son dossier bin une commande php et une commande composer qui lisent le .php-version du dossier courant (ou d’un parent). Pour que vos terminaux les utilisent, ce dossier doit être en tête du PATH.
Ajouter pour moi… (ou Réglages › PHP › Utiliser le PHP de Joppa dans mes terminaux) ajoute ce bloc à votre profil de shell, après confirmation :
# >>> Joppa (PHP) >>>
export PATH="/Users/vous/Library/Application Support/joppa/bin":"$PATH"
# <<< Joppa (PHP) <<<
| Shell | Fichier modifié |
|---|---|
| zsh | ~/.zshrc |
| bash | ~/.bash_profile (macOS), ~/.bashrc (Linux) |
| fish | ~/.config/fish/conf.d/joppa.fish (avec fish_add_path --prepend) |
Le bloc se retire depuis les mêmes réglages. Ouvrez un nouveau terminal après le changement.
Hors des projets épinglés
Réglages › PHP › Hors des projets épinglés choisit le PHP utilisé ailleurs : celui du système ou une version de Joppa.
Composer
Les Réglages indiquent quel Composer est utilisé (celui de Joppa ou du système). Télécharger Composer l’installe dans Joppa, après vérification de sa somme de contrôle.