如何下载并使用phpEnv实现多版本PHP运行环境？

本文共计710个文字，预计阅读时间需要3分钟。

当然可以，请您提供需要改写的原文内容，我将按照您的要求进行修改。

phpenv install 命令报 command not found

这是最常见的一环卡死问题：你克隆了仓库、改了 PATH，但 phpenv install 仍不可用 —— 因为 phpenv install 功能由插件提供，并非 phpenv 自带。

• 必须先安装 php-build 插件：git clone https://gitcode.com/gh_mirrors/ph/php-build $(phpenv root)/plugins/php-build
• 确认插件目录存在：ls $(phpenv root)/plugins/ 应输出 php-build
• 部分系统需额外安装编译依赖（Ubuntu/Debian）：sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev
• 插件装好后，phpenv install --list 才能正常列出可用版本

切换 PHP 版本后 php -v 不变

本质是 shell 的 which php 指向了系统自带 PHP（如 /usr/bin/php），而非 phpenv 生成的 shim 文件。phpenv 的机制完全依赖 PATH 中 ~/.phpenv/shims 的优先级。

• 检查当前 php 路径：which php —— 正确应返回 ~/.phpenv/shims/php
• 若不是，说明 ~/.phpenv/shims 未被加到 PATH 开头，或 eval "$(phpenv init -)" 未生效
• 手动验证 shim 是否生成：ls ~/.phpenv/shims/，应有 php、phpize、php-config 等文件
• 必要时强制重建：phpenv rehash

项目级版本不自动生效（.php-version 文件无效）

phpenv 只在进入目录时读取 .php-version，且该文件内容必须是纯版本号（无空格、无前缀、无注释）。

立即学习“PHP免费学习笔记（深入）”；

• 文件位置必须在项目根目录，且名称严格为 .php-version（开头带点，无扩展名）
• 内容只能是类似 8.3.13 或 7.4.33，不能写成 php-8.3.13 或 8.3.13 # latest
• 确保该目录下没有更高优先级的设置（如上层目录也有 .php-version，或已执行过 phpenv shell）
• 可运行 phpenv version 查看当前生效的版本来源（显示 8.3.13 (set by /path/to/project/.php-version) 才算成功）

真正容易被忽略的是 phpenv init 输出的内容必须被 eval 执行——它不只是设置 PATH，还会 hook cd 命令、注入 shims 目录、监听目录变更。漏掉这步，所有“自动”功能都会静默失效。