phpenv不管理端口或Web服务，仅负责PHP多版本的安装、切换与隔离；端口由实际运行的PHP内置服务器（如php -S）等决定，需先通过phpenv local/global切换版本，再调用对应php启动服务。
phpenv 本身**不管理端口**，也不启动 Web 服务（如 PHP 内置服务器、Apache 或 Nginx）。它只负责安装、切换和隔离不同版本的 php 可执行文件及其扩展。所谓“修改多版本端口”，是常见误解——端口由你实际运行的 Web 服务决定，不是 phpenv 控制的。
如果你看到“PHP 多版本 + 不同端口”这种需求，真实场景通常是：**用 PHP 内置服务器（php -S）为不同项目启动多个本地开发服务，每个绑定不同端口，并确保它们使用各自所需的 PHP 版本**。下面直奔实操：
怎么让不同 PHP 版本监听不同端口？
核心逻辑：先用 phpenv 切到目标版本，再用该版本的 php 启动内置服务器。
-
phpenv local 7.4.33进入旧项目目录 →php -S localhost:8001 router.php -
phpenv local 8.2.18进入新项目目录 →php -S localhost:8002 router.php - 两个命令互不干扰，因为
php命令会调用当前phpenv激活的版本
注意：php -S 是 CLI SAPI，不依赖 Apache/Nginx，但也不适合生产环境；端口冲突时直接改数字即可（如 :8080、:8081）。
安装 phpenv 时最常卡在哪？
不是 Git 克隆失败，而是后续三步没走完就以为装好了：
- PATH 没生效：确认
echo $PATH输出里含$HOME/.phpenv/bin -
phpenv init -没执行：缺这句，phpenv就不会注入 shim 机制，php命令永远调不到它管理的版本 - 没运行
phpenv rehash：安装新 PHP 后必须执行，否则php、composer等 shim 文件不会生成
验证是否真通：运行 which php，输出应类似 /home/you/.phpenv/shims/php，而不是 /usr/bin/php。
立即学习“PHP免费学习笔记（深入）”；
为什么 phpenv install 总报错？
绝大多数编译失败，是因为系统缺构建依赖，不是 phpenv 本身问题：
- Ubuntu/Debian：
sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev libxml2-dev libsqlite3-dev - macOS（Homebrew）：
brew install autoconf automake openssl@3 libxml2 sqlite3 curl，并设置export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH" - 跳过 configure 检查（慎用）：
export PHP_BUILD_CONFIGURE_OPTS="--disable-opcache --without-pear"，可绕过某些扩展缺失导致的失败
另外：phpenv install 实际调用的是 php-build 插件，如果没自动安装，需手动：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build。
项目里怎么确保别人也用对 PHP 版本？
phpenv local X.Y.Z 会在项目根目录生成 .php-version 文件，内容就是版本号（如 8.2.18）。这个文件要提交进 Git。
但注意两点：
- 团队成员必须已安装
phpenv并完成初始化，否则该文件无效 - 如果某人本地没装对应版本（比如文件写的是
8.4.0，但他只装了8.3.13），php命令会 fallback 到全局版本或报错，不会自动安装
建议在 README.md 里加一句：phpenv install $(cat .php-version)，降低新人上手门槛。
phpenv 管的是 php 命令本身，不是 Web 服务器进程、不是 FPM 配置、也不是 IDE 的语言级别设置**。你改了 phpenv local，VS Code 的 PHP Intelephense 插件可能还在用旧版本索引，得手动重启语言服务器。 
