phpenv global 命令通过shim机制设置cli默认版本，优先级低于local和shell；执行后需确保source配置文件、运行phpenv rehash，并验证.php-version格式正确，否则php -v仍显示旧版本。
phpenv global 命令直接设置 CLI 默认版本
phpenv 不是修改 PATH 或符号链接，而是通过 shim 机制拦截所有对 php 的调用，并按优先级（local → shell → global）路由到对应版本的二进制文件。执行 phpenv global 8.3.13 后，php -v 显示的版本即为当前 CLI 默认版本，路径自动指向 ~/.phpenv/versions/8.3.13/bin/php。
常见错误是运行完 phpenv global 后 php -v 仍显示旧版本——这几乎一定是 shell 配置未生效：
- 确认
~/.bashrc或~/.zshrc中已写入eval "$(phpenv init -)" - 执行
source ~/.zshrc（或对应 shell 配置文件），不是只改了就完事 - 新开终端窗口验证，避免复用旧 shell 进程缓存
为什么不能直接改 /usr/bin/php 符号链接
手动删掉 /usr/bin/php 再 ln -s 到某个版本，会绕过 phpenv 管理体系，导致 phpenv local、phpenv shell 全部失效。更严重的是，系统包管理器（如 apt）在升级 PHP 包时可能重置该链接，引发不可预期的版本回退。
此外，phpenv 安装的版本默认不启用系统扩展（如 opcache、pdo_mysql），若你依赖 /usr/bin/php 的预编译扩展，硬链接过去会导致扩展加载失败或段错误。
phpenv install 后必须运行 phpenv rehash
每次用 phpenv install 8.3.13 装完新版本，phpenv 并不会自动把新版本的 php 二进制加入 shim 链。漏掉这步，phpenv global 8.3.13 会报错 version `8.3.13' not installed，即使目录存在。
正确流程是：
phpenv install 8.3.13-
phpenv rehash（生成或更新~/.phpenv/shims/php） phpenv global 8.3.13-
php -v验证
.php-version 文件比 global 更优先，但仅限目录内生效
进入项目目录后运行 phpenv local 7.4.33，会在当前目录生成 .php-version 文件，内容就是 7.4.33。此时无论你在哪执行 php，只要当前工作目录在该项目下，就会强制使用 7.4.33 —— 这个行为由 shim 在运行时实时读取文件决定，不是靠环境变量继承。
容易被忽略的点：
-
.php-version只影响当前目录及子目录，上层目录不受影响 - 文件内容不能带空格或注释，只能是纯版本号，如
8.2.15，不能是8.2.15 # legacy - Git 提交该文件是推荐做法，让团队成员 clone 后自动获得匹配版本
实际路径本身不需手动指定，phpenv 的设计哲学就是“版本名即路径”，所有路径都由它内部管理。真正要盯住的只有三件事：配置是否 reload、rehash 是否执行、.php-version 是否格式正确。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
