phpenv不处理域名解析，泛域名需Nginx（server_name .example.com）、PHP应用层（如ThinkPHP的Route::domain('')）和本地hosts（逐行映射）三层协同配置，缺一不可。
phpenv 本身不处理域名或泛域名解析
phpenv 是 PHP 版本管理工具，和 Web 服务器（Nginx/Apache）、DNS、路由层完全无关。它不解析 HTTP_HOST，也不参与 server_name 匹配或子域名分发。试图在 phpenv 配置里找“泛域名”选项，注定找不到——那不是它的职责范围。
常见错误现象：
- 在
.php-version或phpenv global中写*.example.com—— 会报错或被忽略 - 以为切换 PHP 版本后能自动支持多子域访问 —— 实际仍需 Web 服务器和应用层配合
真正需要配置泛域名的三层位置
泛域名生效依赖三个独立但必须协同的部分，缺一不可：
-
Nginx 层：在
server_name中写*.example.com（仅限单层通配符），并确保 SSL 证书 SAN 包含该模式（example.com根域需单独加） -
PHP 应用层：用
$_SERVER['HTTP_HOST']或Request::domain()（ThinkPHP）提取完整 Host，再用parse_url()或正则切出子域名部分 -
本地调试层：hosts 文件不能写
127.0.0.1 *.example.com（无效），必须逐行添加，如：127.0.0.1 shop.example.com、127.0.0.1 api.example.com
ThinkPHP 泛域名路由必须显式声明 domain 规则
很多人误以为在 route.php 里写普通 Route::get() 就能匹配子域名，实际不会生效。ThinkPHP 的泛域名路由必须用 Route::domain('*') 显式包裹，并手动调用 Request::subDomain() 解析：
立即学习“PHP免费学习笔记（深入）”；
-
Route::domain('*')是唯一有效写法；Route::domain('*.example.com')直接报错 -
Request::subDomain()在主域名（如 example.com）下返回空字符串''，不是null，别用=== null判断 - 子域名映射逻辑建议抽离成独立类（如
SubDomainDispatcher），避免路由闭包里堆满 switch - HTTPS 反向代理环境下，原始
Host头可能被覆盖，需检查 Nginx 是否透传：proxy_set_header Host $host;
CORS 场景下泛域名 Origin 校验不能偷懒
当接口需支持多个子域名前端（如 app.example.com、admin.example.com）且携带 cookie 时，Access-Control-Allow-Origin 不能设为 *，否则请求直接被浏览器拦截：
- 必须动态读取
$_SERVER['HTTP_ORIGIN']，再与白名单数组严格比对（协议 + 域名 + 端口） - 禁止用
strpos($_SERVER['HTTP_ORIGIN'], 'example.com')模糊匹配，evil.example.com会被误放行 - 推荐用
parse_url($origin, PHP_URL_HOST)提取 host 后，再判断是否以.example.com结尾（注意开头补点） - 除
Access-Control-Allow-Origin外，Access-Control-Allow-Methods和Access-Control-Allow-Headers也必须显式设置，否则预检（OPTIONS）失败
server_name 通配规则、证书 SAN 的层级限制、PHP 框架的路由注册方式、浏览器对 CORS credentials 的硬性要求——漏掉任何一层，都会在某个看似合理的场景下突然失效。 
