phpenv本身不处理站点配置克隆，仅管理php版本切换；新项目继承原项目php版本需复制.php-version文件，扩展需手动对齐并执行phpenv rehash，且cli与web服务器（如php-fpm）配置相互独立。
phpenv 本身不处理站点配置克隆，它只管 PHP 版本切换。所谓“克隆项目站点配置”，实际是三件事：复用 PHP 版本 + 复用扩展组合 + 复用项目级 PHP 版本绑定逻辑。直接拷贝 .php-version 文件 + 手动对齐扩展，比任何自动化脚本都快且可靠。
如何让新项目自动继承原项目的 PHP 版本
phpenv 通过项目根目录下的 .php-version 文件决定使用哪个版本。只要原项目有这个文件（比如内容是 8.1.17），复制时带上它，新项目进入目录后就会自动生效。
- 检查原项目是否存在：
cat /path/to/old-project/.php-version，若无，先运行phpenv local 8.1.17生成 - 复制时别漏掉隐藏文件：
cp /path/to/old-project/.php-version /path/to/new-project/ - 验证是否生效：
cd /path/to/new-project && php -v，输出应与原项目一致 - 注意：如果原项目用的是
phpenv global，那整个终端都走同一个版本，此时新项目没.php-version也能“继承”，但这种全局绑定不推荐用于多项目协作
PHP 扩展不一致导致 Class not found 怎么办
phpenv 切换版本后，每个版本的扩展是独立安装的。即使版本号相同，redis、pdo_mysql 等扩展可能没装或没启用——这和宝塔面板里“PHP 扩展”开关是两套机制。
- 先确认当前版本已安装哪些扩展：
php -m | grep -E "redis|curl|opcache|fileinfo" - 缺哪个就装哪个，比如装 redis：
pecl install redis，然后在对应版本的php.ini里加extension=redis.so - 找到当前版本的
php.ini路径：phpenv which php得到二进制路径，再执行php --ini查配置位置 - 改完
php.ini后必须运行phpenv rehash，否则php命令仍可能调用旧 shim
为什么 phpenv local 不生效，还是跑的系统默认 PHP
常见原因是 shell 初始化没走完，或者 phpenv init - 输出没被正确 eval。最典型的症状是 phpenv version 显示正确，但 php -v 不变。
- 检查
which php输出是不是~/.phpenv/shims/php，如果不是，说明 shim 没接管 - 手动触发初始化：
eval "$(phpenv init -)"，再试php -v - 确认 shell 配置文件（
~/.bashrc或~/.zshrc）里这两行都存在且没被注释：export PATH="$HOME/.phpenv/bin:$PATH"和eval "$(phpenv init -)" - 改完配置后必须
source ~/.bashrc（或对应文件），exec $SHELL -l有时会跳过某些加载逻辑
真正容易被忽略的点是：phpenv 的版本绑定只作用于 CLI，不影响 Web Server（如 Nginx + PHP-FPM）。如果你在浏览器里看到的 PHP 版本和终端不一致，那不是 phpenv 的问题，而是 FPM 进程用的是另一个 PHP 安装路径——这时候得去改 www.conf 或宝塔里的 PHP 版本绑定设置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
