phpenv本身不提供虚拟目录配置能力，它仅管理php版本切换；虚拟目录需由apache/nginx等web服务器单独配置，与phpenv完全解耦。
phpEnv 本身不提供 Apache/Nginx 虚拟主机（VirtualHost）或虚拟目录（Alias / DocumentRoot）配置能力 —— 它只管 PHP 版本切换，不碰 Web 服务器。
phpenv 和虚拟目录是两套独立系统
你看到的「PHPEnv」名字容易混淆：知识库中混杂了两类工具：
- 一类是
phpenv（小写 p、无连字符），纯 CLI 工具，专注 PHP 解释器版本管理，依赖系统已有的 Apache/PHP-FPM/Nginx； - 另一类是 Windows 上的「PHPEnv」（大写 P、常带图形界面），是 Apache + MySQL + PHP 打包集成环境，自带控制面板和虚拟目录配置入口。
从你提到「虚拟目录」这个关键词，大概率你实际用的是后者（Windows 集成版），但搜索时误用了 phpenv 的命令语法。下面按真实场景分述：
Windows 版 PHPEnv（集成环境）怎么配虚拟目录
这是图形化工具，操作路径明确：
- 启动 PHPEnv 控制面板 → 点击「站点管理」或「Web 服务」→「添加站点」
- 填写「站点名称」（如
myapp.local）、「根目录」（如D:\projects\myapp）、「端口」（默认 80，冲突可改 8080） - 勾选「启用虚拟主机」或「自动写入 hosts」（会帮你加
127.0.0.1 myapp.local） - 保存后点击「重启 Apache」
完成后，访问 http://myapp.local 即可加载对应目录。注意：.php-version 文件仍可被识别（如果该集成版集成了 phpenv 逻辑），但虚拟目录路由完全由 Apache 的 vhost 配置驱动，和 phpenv local 无关。
Linux/macOS 下用 phpenv + Apache/Nginx 配虚拟目录
这时你要手动配 Web 服务器，phpenv 只负责确保 php-fpm 或 mod_php 使用指定版本：
- 先用
phpenv global 8.3.13设定目标版本，再运行phpenv rehash更新 shim - 确认
which php指向~/.phpenv/shims/php，且php -v输出正确 - Apache 用户：在
vhost中用SetHandler "proxy:fcgi://127.0.0.1:9000"并确保php-fpm进程使用该版本（需单独启停对应php-fpm实例） - Nginx 用户：在
location ~ \.php$块里配fastcgi_pass 127.0.0.1:9000，同样需让该端口的php-fpm用phpenv shell 8.3.13启动
关键点：phpenv 不生成或修改任何 Apache/Nginx 配置文件，它只影响命令行调用的 php 和 php-fpm 二进制来源。虚拟目录路径必须由 Web 服务器显式声明。
为什么 .php-version 不影响 Web 请求的 PHP 版本
因为 phpenv 的 .php-version 文件只在 shell 会话中生效 —— Apache 子进程不读取你的 shell 环境，也不会执行 eval "$(phpenv init -)"。所以：
- CLI 下
php script.php会遵守.php-version - Web 请求中
phpinfo()显示的版本，取决于 Web 服务器加载的 PHP 模块或连接的php-fpm实例，和项目目录里的.php-version无关 - 想让 Web 请求也受控，必须把
phpenv shell x.y.z嵌入到php-fpm启动脚本，或用PHP_VERSION环境变量透传（部分 FPM 配置支持）
最容易被忽略的是：你以为切了 phpenv local，Web 就自动跟着变 —— 实际上它只改了你敲命令时的解释器，对 HTTP 请求零影响。真要联动，得动 Web 服务器或 FPM 层。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
