phpenv 的配置文件主要位于三个位置：~/.phpenv/version（全局默认版本）、项目根目录的 .php-version（本地版本锁定）、~/.phpenv/versions/<version>/etc/（PHP 实例配置如 php.ini 和 conf.d）；它不管理站点级配置，仅通过轻量文件控制版本切换。
phpenv 的配置文件到底存在哪？
phpenv 本身不存“站点配置”，它只管 PHP 版本切换；你看到的“站点配置被重置”，大概率是项目级或系统级的配置（比如 .php-version、php.ini、Web 服务器虚拟主机配置）被覆盖或丢失了。
关键路径只有三个：
-
~/.phpenv/versions/：已安装的 PHP 版本二进制和配置，删了就得重装 -
~/.phpenv/version：全局默认版本（纯文本，一行内容如8.3.13） - 项目根目录下的
.php-version：本地版本锁定文件，由phpenv local 8.3.13自动生成
如果 .php-version 消失，进入项目目录再执行一次 phpenv local 8.3.13 就能恢复——它不依赖面板或服务，只读这个文件。
为什么 phpenv local 设置会失效？
常见原因不是 phpenv 出问题，而是 shell 环境没加载或被覆盖：
立即学习“PHP免费学习笔记（深入）”；
- 你在非登录 shell（比如 VS Code 终端、某些 IDE 内置终端）里运行命令，
~/.bashrc或~/.zshrc没执行，导致eval "$(phpenv init -)"没生效 - 其他工具（如 oh-my-zsh 插件、nvm、direnv）在 shell 初始化时重写了
$PATH或覆盖了cdhook，导致phpenv的自动切换逻辑被跳过 -
.php-version文件权限错误（如 root 写入，普通用户无法读），执行phpenv version会静默失败
验证方式：在项目目录下运行 phpenv version-name，输出应为实际设置的版本号；若显示 system 或报错，说明本地配置未触发。
如何备份真正影响站点行为的 PHP 配置？
phpenv 不管理 php.ini，但你的站点很可能依赖其中某几项（如 date.timezone、opcache.enable、upload_max_filesize）。必须单独备份：
- 先定位生效的配置文件：
php --ini查看Loaded Configuration File路径，例如/home/user/.phpenv/versions/8.3.13/etc/php.ini - 不要只备份这个文件——扩展启用靠的是
conf.d/目录下的碎片化 ini 文件，漏掉一个（比如20-opcache.ini）就可能让 OPcache 失效 - 推荐打包整个
etc/目录：tar -czf php-8.3.13-etc-backup.tar.gz ~/.phpenv/versions/8.3.13/etc/ - 若用 FPM，还要备份对应池配置（如
~/.phpenv/versions/8.3.13/etc/php-fpm.d/www.conf），否则重启后进程可能起不来
容器或 CI 环境中怎么避免配置丢失？
在 Docker 或 GitHub Actions 这类无状态环境里，phpenv 安装完不持久——每次构建都是全新镜像。不能靠 .php-version，得把版本固化进构建流程：
- Dockerfile 中显式指定版本：
RUN phpenv install 8.3.13 && phpenv global 8.3.13，并确保php-build插件已就位 - CI 脚本里避免用
phpenv local，改用phpenv global+ 提前cp自定义php.ini到~/.phpenv/versions/8.3.13/etc/php.ini - 注意：phpenv 的
global设置写在~/.phpenv/version，但该文件在容器里常被挂载覆盖或忽略，所以最好在启动脚本里加一句echo "8.3.13" > ~/.phpenv/version强制生效
真正的风险点不在 phpenv 命令本身，而在于你以为它“记住了”，其实它只依赖几个极轻量的文件——这些文件一旦不在预期位置、权限不对、或被上层环境重置，整个版本控制就形同虚设。
