apache 的 documentroot 不支持动态变量，因其在启动时静态解析；应使用 mod_vhost_alias 模块的 virtualdocumentroot 实现等效动态路径映射，并需启用模块、设置 usecanonicalname off 且配置对应 directory 权限。
Apache 本身不支持在 DocumentRoot 指令中直接使用变量（如 $1、%0 或 ${VAR}）来动态指定物理路径——DocumentRoot 是静态指令，不能解析运行时变量。但你可以通过 mod_vhost_alias 模块配合 VirtualDocumentRoot 实现等效的“动态路径映射”，这是官方推荐、生产可用的替代方案。
为什么 DocumentRoot 不能用变量？
DocumentRoot 的上下文仅限于“服务器配置”和“虚拟主机”，它在 Apache 启动时解析一次，不参与请求时的 Host 头匹配或正则拆分。因此像 DocumentRoot /var/www/${HOST_NAME} 或 DocumentRoot /var/www/%1.%2 这类写法会直接报错或被忽略。
正确做法：用 VirtualDocumentRoot 替代 DocumentRoot
启用 mod_vhost_alias 后，用 VirtualDocumentRoot 指令按域名自动计算根目录，效果等同于“带变量的 DocumentRoot”：
-
VirtualDocumentRoot /var/www/%0→ 访问blog.example.com，自动指向/var/www/blog.example.com -
VirtualDocumentRoot /var/www/%2+/%1→ 访问app.dev.local，解析为%2+ = dev.local、%1 = app，路径变成/var/www/dev.local/app - 支持通配符：
%-1取倒数第一段（如com），%3+取从第3段开始的全部（如example.com中的example.com）
必须配套的关键配置
仅写 VirtualDocumentRoot 不够，还需确保以下三点生效：
Apache 2.4.62
下载
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
- 取消注释
LoadModule vhost_alias_module modules/mod_vhost_alias.so - 设置
UseCanonicalName Off，让 Apache 信任请求头中的 Host 字段，而非反向 DNS 解析 - 添加对应路径的
<directory></directory>授权，例如：<directory><br> Require all granted<br> Options FollowSymLinks<br></directory>
配置结构建议：分离管理，避免硬编码
不要把动态规则堆在 httpd.conf 主体里。推荐：
- 新建文件
/etc/httpd/conf/extra/vhost-dynamic.conf（Linux）或conf/extra/vhost-dynamic.conf（Windows） - 将
UseCanonicalName Off、VirtualDocumentRoot和<directory></directory>全部写入该文件 - 在
httpd.conf中加入：Include conf/extra/vhost-dynamic.conf - 验证语法：
sudo httpd -t（输出 Syntax OK 即可）
新增站点完全免重启
完成上述配置后，加一个新站只需三步：
- 创建目录：
sudo mkdir -p /var/www/myapp.test - 放入文件：
echo "<h1>My App</h1>" > /var/www/myapp.test/index.html - 配本地解析：
127.0.0.1 myapp.test加入/etc/hosts或 Windows 的drivers\etc\hosts
访问 http://myapp.test 立即生效，无需改配置、无需 reload、无需 restart。
