phpEnv下载安装常见疑问解答 phpEnv入门手册-php教程-PHP中文网

phpenv命令找不到的主因是path未包含~/.phpenv/bin或shell配置未生效；需确认安装路径、将该路径加入对应shell配置文件（如~/.zshrc）、source重载，并运行phpenv rehash重建shims。

phpenv下载安装常见疑问解答 phpenv入门手册

phpenv 命令找不到？不是没装好，大概率是 PATH 或初始化没生效。

这是最常遇到的第一道坎。根本原因不是安装失败，而是 shell 找不到 phpenv 可执行文件。

先确认安装路径是否正确：ls ~/.phpenv/bin/phpenv 应该存在且有可执行权限
检查 $PATH 是否包含 ~/.phpenv/bin：echo $PATH | grep phpenv，若无输出，说明没加进去
别只改 ~/.bashrc 就完事——如果你用的是 zsh（macOS Catalina+ 默认），得改 ~/.zshrc；Ubuntu 新版本也默认用 bash，但部分桌面环境可能加载 ~/.profile
加完配置后必须重载：用 source ~/.zshrc（或对应文件），而不是仅靠新开终端——有些终端不会自动读取 login shell 配置

这不是 phpenv 的问题，是系统缺编译工具链。php-build 插件需要完整 GCC 环境才能编译 PHP 源码。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

Ubuntu/Debian：sudo apt-get install -y build-essential autoconf bison libxml2-dev libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev
macOS（Homebrew）：brew install autoconf automake openssl libxml2，再确保 Xcode Command Line Tools 已安装：xcode-select --install
报错里出现 libzip、oniguruma 相关缺失时，不要跳过——它们是 PHP 8.0+ 的硬依赖，漏掉会导致后续扩展加载失败
安装中途失败，日志在 ~/.phpenv/plugins/php-build/share/php-build/log/8.3.13.log（以实际版本号为准），直接 tail -n 50 查最后几十行比盲试更省时间

说明 phpenv 的 shim 机制没接管住 php 命令，系统优先调用了其他路径的 PHP。

查真实调用路径：which php —— 如果返回 /usr/bin/php 或 /opt/homebrew/bin/php，就证明 phpenv 没生效
运行 phpenv rehash 强制重建所有 shim 文件（~/.phpenv/shims/php 等），这是解决“版本已装但不生效”的最快操作
检查是否有其他版本管理工具干扰：比如 MAMP、XAMPP、Homebrew 自带的 php，它们的 bin 目录如果在 $PATH 中排在 ~/.phpenv/shims 前面，就会抢跑
验证 shim 是否起作用：phpenv which php 应该输出类似 ~/.phpenv/versions/8.3.13/bin/php，否则就是 shims 层没挂上

phpenv 支持目录级版本控制，但触发条件很具体，容易被忽略。

.php-version 文件必须放在项目根目录，且内容只能是纯版本号，例如 8.3.13，不能带空格、注释或额外字符
确保当前 shell 是登录 shell（login shell），否则 eval "$(phpenv init -)" 中的 hook 不会加载——Zsh 用户注意：默认非 login shell 不加载 ~/.zshrc，需在终端设置里勾选 “Run command as a login shell”
执行 phpenv version 看输出：如果是 system，说明没检测到本地设置；如果是 8.3.13 (set by /path/to/project/.php-version)，才表示成功识别
不建议混用 phpenv local 和手动写 .php-version —— 后者是前者生成的，重复操作可能导致冲突