trae需手动配置系统已安装的多个PHP版本绝对路径，如/usr/bin/php8.1-cgi或/opt/homebrew/bin/php-cgi82，确保其支持CGI SAPI且cgi.fix_pathinfo=0，切换后需重启对应php-fpm服务。
trae 中如何启用多个 PHP 版本
trae 本身不内置多 PHP 版本管理，它依赖系统已安装的 PHP 可执行文件。要实现多版本共存，关键是在系统层面装好多个 PHP（如 php7.4、php8.1、php8.3），再让 trae 知道它们的位置。
常见错误是只装了一个 PHP（比如通过 apt 装了 php 包），结果 trae 始终只能识别到默认版本。Ubuntu/Debian 用户推荐用 ondrej/php PPA 源；macOS 用户可用 brew install php@8.1 php@8.2 php@8.3 分别安装。
- 确认各版本二进制路径：通常为
/usr/bin/php7.4、/opt/homebrew/bin/php@8.2等，用which php8.2或ls -l /usr/bin/php*查看 - trae 不会自动扫描这些路径，必须手动配置
- 不要卸载系统默认
php，否则可能影响其他工具（如 composer）
在 trae 配置中指定 PHP 版本路径
trae 的站点配置（.trae/config.json 或 Web UI 中的「PHP 版本」下拉）本质是设置 php-cgi 或 php-fpm 的路径。它不认 php -v 输出，只认你填进去的绝对路径是否可执行且能响应 FastCGI 请求。
- 填入完整路径，例如：
/usr/bin/php8.1-cgi（Ubuntu）或/opt/homebrew/bin/php-cgi82（macOS brew 安装后需软链或查实际名） - 如果填
php，trae 会走$PATH，最终调用的是 shell 默认版本，不可靠 - 务必测试该路径能否直接运行：
/usr/bin/php8.1-cgi -v应输出版本号，且无报错 - 部分 PHP 版本默认没开 CGI SAPI（尤其 brew 安装的），需确认编译时含
--enable-cgi；若只有 CLI，trae 无法使用
切换 PHP 版本时常见的 502 和空白页问题
trae 报 502 Bad Gateway 或页面空白，90% 是因为指定的 PHP-CGI 进程启动失败或监听异常，不是配置没保存。
立即学习“PHP免费学习笔记（深入）”；
- 检查日志：
.trae/logs/php-error.log和.trae/logs/nginx-error.log，重点找connect() failed或Primary script unknown - 确保对应 PHP 版本的
php.ini中cgi.fix_pathinfo=0（否则 Nginx 传参异常） - 如果用了
php-fpm，trae 要求每个版本独立配置 pool（如www81.sock），不能多个版本共用一个 socket，否则切换后旧进程未退出，新请求被错误转发 - trae 不自动 reload php-fpm，改完 PHP 版本后，需手动重启对应 fpm 服务：
sudo systemctl restart php8.1-fpm
为什么不能用 alias 或环境变量切换 PHP 版本
trae 启动时读取配置并 fork 子进程跑 PHP-CGI，它不继承你的 shell alias 或当前终端的 $PATH 修改。你在终端里 alias php=php8.2 对 trae 完全无效。
- trae 的 worker 进程由主服务以最小环境启动，
$PATH通常是/usr/local/bin:/usr/bin:/bin - 试图用
export PATH="/opt/homebrew/bin:$PATH"并启动 trae，仅对当前终端有效，GUI 启动或开机自启仍走系统默认环境 - 唯一可靠方式：在 trae 站点配置中写死绝对路径，并确保该路径指向的二进制具备 CGI 能力
真正麻烦的不是配路径，而是每个 PHP 版本的扩展、php.ini、OPcache 设置都得单独维护。比如 pdo_mysql 在 php8.1 和 php8.3 里可能需要不同版本的 .so 文件，一不留神就报 undefined symbol —— 这类底层兼容问题，trae 不报错，只静默失败。
