Node、bun 和 PHP 版本

运行时 标签页（R）显示开发服务器和你的终端在项目文件夹中使用的版本，并允许你固定它们。

Node 和包管理器

Joppa 借助 Vite+：它会下载每个项目固定的 Node 版本和包管理器（bun、pnpm、npm、yarn），并将其加入终端的 PATH。如果未安装 Vite+，标签页会给出安装命令。

• Node 版本：保持不变、最新 LTS 或某个具体版本。
• 包管理器 及其版本。
• 固定 会写入 .node-version 和 package.json 的 packageManager 字段：之后所有终端和开发服务器都会使用这些版本（vp env pin）。

Joppa 按以下顺序读取版本：devEngines，然后是版本文件（.node-version、.nvmrc），最后是 engines。

PHP

Joppa 会下载 PHP 的静态构建（static-php.dev），版本从 8.1 到 8.5，并存放在自己的文件夹中。

• 固定一个版本…：选择版本；安装并使用 会在需要时下载它，并在项目根目录写入 .php-version。
• 取消固定 会删除 .php-version。

终端中的 PHP

Joppa 在其 bin 文件夹中放置了 php 和 composer 命令，它们会读取当前文件夹（或上级文件夹）的 .php-version。要让你的终端使用它们，这个文件夹必须位于 PATH 的最前面。

帮我添加…（或 设置 › PHP › 在我的终端中使用 Joppa 的 PHP）会在你确认后将以下代码块添加到 shell 配置文件中：

# >>> Joppa (PHP) >>>
export PATH="/Users/you/Library/Application Support/joppa/bin":"$PATH"
# <<< Joppa (PHP) <<<

Shell	修改的文件
zsh	~/.zshrc
bash	~/.bash_profile（macOS）、~/.bashrc（Linux）
fish	~/.config/fish/conf.d/joppa.fish（使用 fish_add_path --prepend）

可以在同一设置中移除该代码块。更改后请打开一个新终端。

未固定版本的项目

设置 › PHP › 未固定版本的项目 用于选择其他地方使用的 PHP：系统 PHP 或 Joppa 的某个版本。

Composer

设置中会显示使用的是哪个 Composer（Joppa 的还是系统自带的）。下载 Composer 会在验证校验和后将其安装到 Joppa 中。