phpEnv中ServerAlias *.example.com无效，因默认未启用mod_vhost_alias模块且未加载httpd-vhosts.conf；需取消httpd.conf中对应LoadModule和Include行的注释，重启Apache，并在httpd-vhosts.conf中配置完整VirtualHost块，含ServerName、ServerAlias、DocumentRoot及Directory权限。
phpEnv 是 Windows 下的集成环境，它默认不启用 mod_vhost_alias，也不自动加载虚拟主机配置文件，所以直接写 ServerAlias *.example.com 会无效——不是语法错，是模块没开、配置没读。
确认 phpEnv 的 Apache 是否加载了 vhost_alias 模块
phpEnv 封装的是 Apache 2.4.x（常见为 2.4.52+），但默认仅启用基础模块。泛域名解析依赖 mod_vhost_alias（用于动态目录）或至少 mod_rewrite（用于重写路由），而 ServerAlias *.example.com 本身只需核心匹配能力，但实际生效仍需模块支持和正确加载顺序。
- 打开 phpEnv 安装目录下的
Apache\conf\httpd.conf - 搜索
mod_vhost_alias.so，确认该行未被注释：LoadModule vhost_alias_module modules/mod_vhost_alias.so - 若已注释（前面有
#），删掉并保存 - 再搜
httpd-vhosts.conf，确保这一行也已启用：Include conf/extra/httpd-vhosts.conf - 改完后必须重启 phpEnv 的 Apache 服务（不是只点“重启”，要彻底停止再启动）
在 httpd-vhosts.conf 中正确配置 ServerAlias 泛解析
phpEnv 的 httpd-vhosts.conf 默认是空的或只有示例。你要手动添加一个完整 <VirtualHost> 块，不能只写 ServerAlias —— Apache 不认孤立的 ServerAlias。
- 必须配
ServerName（哪怕只是占位，如example.com） -
ServerAlias写成*.example.com，注意星号前有英文点，不能写成**.example.com或*.example.* -
DocumentRoot必须是绝对路径，且 phpEnv 下常见路径含空格或中文时要用双引号包裹，例如：DocumentRoot "D:/phpEnv/www/example" - 务必加上
<Directory>段落并设置权限，否则 403 Forbidden：
<VirtualHost *:80>
ServerName example.com
ServerAlias *.example.com
DocumentRoot "D:/phpEnv/www/example"
<Directory "D:/phpEnv/www/example">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
DNS 泛解析必须提前配好，且本地 hosts 无法替代
很多人在本地测试时习惯改 hosts 文件，但 hosts 不支持通配符。你加 127.0.0.1 test.example.com 只能匹配这一个子域，127.0.0.1 *.example.com 是无效语法，会被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 真实泛解析必须靠 DNS：在域名控制台添加 A 记录，主机名填
*，记录值填服务器公网 IP - 若用 phpEnv 本机调试，可临时用多个
hosts条目模拟（如127.0.0.1 a.example.com、127.0.0.1 b.example.com），但这是假泛解，不能验证ServerAlias *.example.com是否真起作用 - 浏览器访问时，地址栏必须显示子域名（如
https://demo.example.com），不能是localhost或 IP，否则 Apache 不会触发ServerAlias匹配逻辑
常见错误现象与绕过陷阱
即使配置看起来全对，也可能遇到以下问题：
- 访问
test.example.com返回 404：检查DocumentRoot路径是否存在、大小写是否与磁盘一致（Windows 不敏感但 phpEnv 有时会因路径缓存出错） - 返回 403 Forbidden：八成是
<Directory>缺失或Require all granted写成旧版Allow from all（Apache 2.4+ 已废弃） - 所有子域名都跳转到主站首页（如 index.php）：说明
ServerAlias生效了，但 PHP 代码里没读$_SERVER['HTTP_HOST']做区分，这是业务层问题，不是 Apache 配置失败 - 修改后重启无反应：phpEnv 的 Apache 服务可能卡在后台，任务管理器中结束所有
httpd.exe进程再重启
泛解析本身不难，难在 phpEnv 这种封装环境把模块开关、配置加载、路径权限全藏在表层之下——漏掉任意一环，ServerAlias *.example.com 就只是段安静的文本。
