phpenv怎么设置二级域名 phpenv本地泛域名解析教程-php教程-PHP中文网

phpenv 不支持泛域名解析，需 hosts 文件逐条添加、web 服务器配置 serveralias 或 server_name 通配、php 层安全提取子域名并业务分发。

phpenv怎么设置二级域名 phpenv本地泛域名解析教程

phpenv 本身不处理域名解析，它只是 PHP 版本管理工具，二级域名和泛解析必须靠系统 hosts + Web 服务器（Apache/Nginx）+ PHP 应用层协同完成。直接改 phpenv 配置无法实现泛域名访问。

本地 hosts 文件怎么加多行二级域名

Windows 路径是 C:\Windows\System32\drivers\etc\hosts，macOS/Linux 是 /etc/hosts。不能写 *.test.com 这种通配符 —— 系统 hosts 不支持，必须逐条添加：

127.0.0.1 a.test.com
127.0.0.1 b.test.com
127.0.0.1 shop.test.com
127.0.0.1 api.test.com

保存后无需重启，但浏览器可能缓存 DNS，可执行 ping a.test.com 验证是否解析到 127.0.0.1；若失败，试试 ipconfig /flushdns（Windows）或 sudo dscacheutil -flushcache（macOS）。

Apache 虚拟主机必须用 ServerAlias 支持泛匹配

在 httpd-vhosts.conf 里，不能只写 ServerName test.com，否则 a.test.com 会 404 或落到默认站点。正确写法是：

<virtualhost>
    DocumentRoot "/path/to/your/project"
    ServerName test.com
    ServerAlias *.test.com
    <directory>
        Require all granted
        AllowOverride All
    </directory></virtualhost>

注意点：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

ServerAlias *.test.com 是关键，Apache 会把所有子域名都路由到这里
确保 httpd.conf 中已启用 Include conf/extra/httpd-vhosts.conf
修改后必须运行 apachectl configtest（或 httpd -t）验证语法，再 sudo apachectl restart

PHP 里怎么安全提取子域名（别踩 explode('.').[0] 的坑）

explode('.', $_SERVER['HTTP_HOST'])[0] 在 www.test.com 或 api.v2.test.com 场景下会出错 —— 前者取到 www，后者取到 api，但你真正想识别的可能是 v2 或主域逻辑。推荐用更健壮的方式：

先定义主域：$mainDomain = 'test.com';
用 str_ends_with($_SERVER['HTTP_HOST'], '.' . $mainDomain) 判断是否为子域名
再截取前缀：$sub = substr($_SERVER['HTTP_HOST'], 0, -strlen('.' . $mainDomain))
对 www、admin 等保留子域做白名单过滤，避免误判

ThinkPHP 用户注意：Request::subDomain() 返回空字符串而非 null，判断要用 === ''，不是 === null；且必须配合 Route::domain('*') 才能进泛域路由分组。

Nginx 下泛域名配置比 Apache 更严格

如果你用的是 Nginx（比如通过 phpstudy、laragon 或手动部署），server_name 必须显式支持通配符，且有顺序限制：

写成 server_name *.test.com; 只匹配一级子域（a.test.com ✅，a.b.test.com ❌）
要支持多级，得加 server_name ~^(?<sub>.+)\.test\.com$;</sub> 并在 location 中用 $sub 变量传参
HTTPS 环境下，如果用了反向代理（如 Cloudflare、Nginx SSL 终止），原始 Host 头可能被覆盖，需确认 fastcgi_param HTTP_HOST $host; 是否透传

最易忽略的是：泛域名生效 ≠ 子域名自动路由到对应模块。PHP 层仍需主动解析 $_SERVER['HTTP_HOST']，并做业务分发 —— 没有框架能替你决定 shop.test.com 该显示商城页还是后台页。