phpEnv本身不处理域名转发或重定向，它仅管理PHP版本切换，不影响HTTP路由；真正的域名重定向需由Nginx/Apache配置（如return 301）或PHP脚本（如header函数）实现，phpEnv只确保相关脚本在正确PHP版本下执行。
phpenv 本身不处理域名转发或重定向
phpenv 是一个 PHP 版本管理工具，它只负责切换系统或项目级的 php 可执行文件路径，**不参与 HTTP 请求路由、DNS 解析、Web 服务器配置或任何域名跳转逻辑**。你看到的“phpenv 配置域名转发”这类说法，通常是混淆了工具职责：真正做域名重定向的是 Web 服务器（如 Nginx/Apache）或 PHP 脚本本身，而 phpenv 只是确保你运行这些脚本时用的是正确的 PHP 版本。
为什么有人在 phpenv 环境里配域名重定向？
常见真实场景是：你在本地用 phpenv 管理多个 PHP 版本（比如 7.4 / 8.2 / 8.3），同时用 Nginx 或 Apache 搭建本地开发站点（如 test.local），并希望把 old.test.local 301 跳到 new.test.local。这时你需要：
- 确认当前 Web 服务用的是哪个 PHP 版本（
php -v，它受 phpenv 控制） - 在 Nginx 的
server块或 Apache 的.htaccess中写重定向规则 - 避免因 PHP 版本差异导致 header() 发送失败（比如低版本不支持
header('Location: ...', true, 301)的第三个参数）
换句话说：phpenv 影响的是「重定向脚本能否正确执行」，而不是「怎么写重定向」。
Nginx 下给 phpenv 管理的站点加域名重定向
如果你用宝塔、phpstudy 或手动配 Nginx，且已用 phpenv 切换到目标 PHP 版本（如 phpenv local 8.2.15），那么重定向应直接写在站点配置中，而非 PHP 文件里——更可靠、不依赖 PHP 执行流程：
立即学习“PHP免费学习笔记（深入）”；
server {
listen 80;
server_name old.test.local;
return 301 https://new.test.local$request_uri;
}
注意几点：
-
return 301比rewrite ... permanent更高效，Nginx 直接响应，不进 location 匹配 - 别漏掉
$request_uri，否则路径参数会丢失 - 如果目标是 HTTPS，确保证书已为
new.test.local正确配置（mkcert 生成的证书需被浏览器信任） - 改完配置后必须执行
nginx -t && nginx -s reload或点宝塔里的【重载配置】
用 PHP 脚本做重定向时，phpenv 会影响什么？
当你写一个 redirect.php 并用 header("Location: ...") 实现跳转时，phpenv 的作用仅体现在：
- 是否启用
output_buffering：某些旧 PHP 版本默认关闭，导致 header() 报Cannot modify header information - PHP 8.0+ 支持
header('Location: ...', true, 301)显式设状态码；PHP 7.x 需先调http_response_code(301) - CLI 和 Web SAPI 使用的 php.ini 可能不同，检查
php --ini和phpinfo()中的配置路径是否一致
示例安全写法（兼容 7.2+）：
<?php
http_response_code(301);
header('Location: https://new.test.local' . $_SERVER['REQUEST_URI']);
exit;
?>
这种脚本放在根目录，再配合 Nginx 的 try_files $uri $uri/ /redirect.php;，才能兜底处理未匹配路由——但注意，这已不是纯“域名重定向”，而是路径级 fallback。
最容易被忽略的一点：很多人改完 phpenv 版本后，忘记重启 PHP-FPM 进程（如果是 FPM 模式），导致 Nginx 仍在用旧 PHP 解释器跑脚本，header 行为不一致。验证方式是访问一个 phpinfo.php，看显示的版本和 php -v 是否一致。
