phpenv安装后无法访问的根本原因在于Web服务（Nginx/Apache）与PHP-FPM未正确打通，或shim未生成、PATH未包含~/phpenv/shims、fastcgi_pass配置错误、.php未被解析等；需执行phpenv rehash、检查which php、验证PHP-FPM监听及Nginx fastcgi_param路径。
phpEnv 安装后无法访问，本质不是 PHP 版本没装好，而是 Web 服务（Nginx/Apache）和 PHP-FPM 没打通，或者权限/路径配置错位。
phpenv 命令可用但 php -v 报错或版本不对
这说明 phpenv 自身环境变量已生效，但 PHP 二进制未被正确识别或 shim 未生成。
- 运行
phpenv versions确认目标版本（如8.2.12）确实出现在列表里 - 执行
phpenv global 8.2.12后，**必须立刻运行phpenv rehash** —— 否则php命令仍指向旧版本或系统默认 PHP - 检查
which php输出是否为~/phpenv/shims/php；如果不是，说明~/phpenv/shims未加入$PATH，需在~/.bashrc或~/.zshrc中补上：export PATH="$HOME/phpenv/shims:$PATH"
Nginx 报 502 Bad Gateway 或 “File not found”
这是最常被忽略的环节：phpEnv 只管 CLI PHP，不自动配 PHP-FPM。你得手动启动并关联它。
- 确认 PHP-FPM 是否启用：
php-fpm -t测试配置，php-fpm -D后台启动（注意：phpEnv 不自带 php-fpm，需用phpenv install --fpm或自行编译带 FPM 的版本） - Nginx 配置中
fastcgi_pass必须指向真实 socket 或端口，例如：fastcgi_pass unix:/tmp/php-fpm.sock;—— 不能写成127.0.0.1:9000却没开对应监听 - 检查
fastcgi_param SCRIPT_FILENAME路径是否拼错，常见错误是写成$document_root$fastcgi_script_name却漏了$realpath_root，导致index.php找不到
浏览器访问显示空白页或直接下载 index.php
说明 Nginx/Apache 根本没把 .php 文件交给 PHP 解析，而是当成静态文件处理了。
立即学习“PHP免费学习笔记（深入）”；
- Apache 用户：确认启用了
mod_php或正确配置了ProxyPassMatch转发到 PHP-FPM；禁用mod_mime对 .php 的误判 - Nginx 用户：检查
location ~ \.php$ { ... }块是否被注释、是否放在正确的server块内、是否重复定义覆盖了前面的规则 - Windows 下用 phpEnv（非 phpenv）的用户：注意其默认 Apache 绑定的是
8080端口，浏览器要访问http://localhost:8080，而非:80
PHP 页面报 require(.../vendor/autoload.php) failed
这不是 phpEnv 的问题，而是项目依赖未就位 —— 尤其常见于 ThinkPHP、Laravel 等框架安装后。
- 先确认当前目录是项目根目录（含
composer.json），再运行composer install，不要在父级或子级目录操作 - 如果提示
Could not open input file: composer，说明composer命令不可用，需用curl -sS https://getcomposer.org/installer | php下载composer.phar，再mv composer.phar /usr/local/bin/composer - Windows 下路径分隔符容易出错，
autoload.php路径中若含反斜杠\且未转义，会导致require失败；建议统一用正斜杠或__DIR__ . '/vendor/autoload.php'
真正卡住人的地方，往往不在 phpenv install 这一步，而在 Nginx 的 fastcgi_pass 指向了不存在的 socket，或者 composer install 在错误目录下静默失败——这两处不报明显错误，但整站就挂了。
