phpenv 仅管理 PHP 版本切换，不提供虚拟目录（Alias）配置能力；Alias 必须由 Apache/Nginx 在 Web 服务器层配置，需启用 mod_alias 模块并手动添加路径映射规则，与 phpenv 完全解耦。
phpenv 本身不提供虚拟目录（Alias）或 Web 路由层面的配置能力 —— 它只是一个 PHP 版本管理工具，只管编译、安装、切换 php 可执行文件，不碰 Apache/Nginx 配置，也不处理 URL 映射。
如果你在搜索 “phpenv 设置虚拟目录” 或 “phpenv Alias”，大概率是混淆了两个完全无关的机制：
-
phpenv：控制终端里敲php -v用的是哪个 PHP 二进制 -
Alias指令：Apache 的模块级配置，用于把/foo这类 URL 映射到磁盘上某个非 DocumentRoot 的路径
下面直接说清楚怎么做、为什么不能混用、以及常见踩坑点。
为什么 phpenv 无法配置 Alias 或虚拟目录
phpenv 的工作范围仅限于 shell 环境变量和 PATH 切换。它生成的 php 命令只是解释器，不启动 Web 服务，也不读取 .htaccess 或 httpd.conf。所谓“设置虚拟目录”，必须由 Web 服务器（Apache/Nginx）完成，和 phpenv 完全解耦。
立即学习“PHP免费学习笔记（深入）”；
Alias 配置必须在 Apache 中手动写
要在 Apache 中启用 Alias，需确保以下三点同时满足：
- 已加载
mod_alias模块（检查httpd.conf中是否有LoadModule alias_module modules/mod_alias.so） - 在
VirtualHost或主配置中添加类似如下片段：
<IfModule alias_module>
Alias /api "/var/www/myproject/api"
<Directory "/var/www/myproject/api">
Options None
AllowOverride None
Require all granted
</Directory>
</IfModule>重启 Apache 后，访问 http://localhost/api/test.php 就会执行该目录下的脚本 —— 这个过程与你当前用 phpenv global 8.2.12 还是 7.4.33 无关，只要该 PHP 版本被 Apache 的 libphp 或 php-fpm 正确调用即可。
phpenv 和虚拟目录共存时的关键配合点
当项目依赖特定 PHP 版本 + 自定义 URL 路径（如 /admin 映射到 /opt/myapp/backend），你要分两步配，且注意顺序：
- 用
phpenv local 8.1.25在项目根目录设好版本，确保命令行运行php artisan serve或php think run时用对版本 - 若走 Apache，则必须让 Apache 使用同一版本的 PHP 处理请求：通过
php-fpm方式时，确认www.conf中php_admin_value[extension_dir]和php-cgi路径指向phpenv安装的对应版本（例如/usr/local/phpenv/versions/8.1.25/bin/php-cgi） - 若用 Apache
mod_php（不推荐新项目），则需重新编译模块，绑定到指定phpenv版本 —— 这非常麻烦，实际中几乎没人这么干
最容易忽略的一点：phpenv 切换后，php --ini 显示的 Loaded Configuration File 路径可能和 Apache 加载的 php.ini 完全不同。务必用 phpinfo() 页面确认 Web 环境实际生效的配置位置。
别名（alias）命令和 Alias 指令别搞混
你在 ~/.bashrc 里加的 alias pei='phpenv install' 是 shell 别名，只在终端生效；而 Apache 的 Alias 是 HTTP 协议层的路径重映射，两者命名巧合相同，但毫无技术关联。不要试图用 phpenv 命令去“创建虚拟目录”——它连 DocumentRoot 都不知道在哪。
