phpenv是专为CLI设计的PHP版本隔离管理器，通过shims机制按local＞shell＞global优先级切换版本，不干预Web服务器配置，所有安装、扩展、配置均独立于系统包管理器。
phpenv 不是“设置多版本共存”的工具，而是按需隔离版本的环境管理器——它不启动多个 PHP-FPM 实例，也不改系统全局 php 命令，只管 CLI 场景下哪个 php 可执行文件被当前 shell 或项目调用。
phpenv install 会编译安装，不是 apt 安装
你运行 phpenv install 8.1.25 时，它会从源码下载、配置、编译、安装到 ~/.phpenv/versions/8.1.25/，全程不触碰系统包管理器。这意味着：
- 每个版本的
php、php-fpm、扩展路径（如extension_dir）完全独立，不会和apt install php8.1冲突 - 但你也得自己手动启用 FPM：进入
~/.phpenv/versions/8.1.25/etc/php-fpm.d/www.conf改listen，再用~/.phpenv/versions/8.1.25/sbin/php-fpm启动 - 没有
php8.1-fpm这种 systemd 服务名，得自己写 service 文件或用 supervisor 管理
phpenv local 和 global 的优先级关系
三类作用域生效顺序为：local > shell > global。实际行为取决于当前目录是否有 .php-version 文件：
-
phpenv local 7.4.33→ 在当前目录生成.php-version，内容就是7.4.33；下次cd进来自动生效 -
phpenv shell 8.2.0→ 只在当前终端 session 有效，关闭终端即失效；适合临时测试 -
phpenv global 8.3.13→ 写入~/.phpenv/version，作为兜底版本；但若项目里有.php-version，它就完全被忽略
验证方式始终是 phpenv version（显示当前生效版本）和 which php（确认路径是否指向 ~/.phpenv/versions/xxx/bin/php）。
立即学习“PHP免费学习笔记（深入）”；
phpenv 不处理 Web 服务器绑定，别指望它配 Nginx
phpenv 对 Apache 或 Nginx 配置零干预。想让某个网站走 phpenv 装的 8.1，你必须手动做三件事：
- 确保
~/.phpenv/versions/8.1.25/sbin/php-fpm正在运行，且www.conf中listen = /run/php/php81-env.sock（不能和系统 apt 版本的php8.1-fpm.sock冲突） - 在 Nginx 的
server块里显式写：fastcgi_pass unix:/run/php/php81-env.sock; - 检查
fastcgi_param SCRIPT_FILENAME是否仍指向正确文档根目录（phpenv不改这个）
漏掉任一环，页面就会 502。尤其注意：phpenv 启动的 php-fpm 默认以当前用户身份运行，而 Nginx 通常用 www-data，socket 文件权限不对也会 502。
扩展编译必须匹配对应 phpenv 版本
用 pecl install redis 前，先确认 phpenv which php 输出的是目标版本路径。否则：
- PECL 会用当前
php-config找include_dir和extension_dir，错版本会导致编译失败或undefined symbol -
redis.so编译出来后，必须放进对应版本的lib/php/extensions/目录，再在php.ini里加extension=redis -
opcache.enable_cli=1这类配置项也得进对应版本的etc/php.ini改，不同版本互不影响但也不会继承
最易被忽略的是：phpenv rehash 必须在每次 install 或手动放了新扩展后运行——它负责重建所有 shim 脚本，否则 php --ri redis 可能报 extension not found。
