mod_macro 是 Apache 的第三方宏定义模块，支持将重复配置抽为可复用块；适用于大量结构雷同的 VirtualHost 或 Directory 配置场景，但少量重复时反而增加维护成本。
mod_macro 是什么，值不值得启用
mod_macro 不是 Apache 默认启用的模块，它属于第三方扩展模块，作用是让配置文件支持“宏定义”——类似函数，把重复的
、
或权限组合抽成可复用块。如果你的
或站点配置里反复出现结构雷同的段落（比如十几个子域名都配一样的 PHP-FPM 代理规则），那它就值得启用；但如果只有两三个重复块，硬加 mod_macro 反而增加维护成本和启动依赖。
注意：Apache 2.4.33+ 官方仍未内置 mod_macro，必须手动编译或通过包管理器安装额外包（如 Debian/Ubuntu 的
，CentOS/RHEL 需启用 EPEL 后装
）。
加载 mod_macro 并验证是否生效
加载失败是后续所有操作的前提障碍。常见错误是启用了模块但没启用对应指令，导致重启时报
。
确认模块文件存在：
（Debian）或
（RHEL）
在主配置中添加加载行（位置需在任何
使用之前）：
检查语法并验证指令可用：
应输出
；再运行
确保无报错
如果用 systemd，记得 reload 而非 restart：
（避免配置错误导致服务中断）
定义和调用一个基础 VirtualHost 宏
典型场景：多个二级域名指向同一代码路径，仅域名和日志路径不同。直接复制粘贴
块极易漏改某处，用宏能锁死结构、暴露变量。
在
或独立的
（需被
）中写：
调用方式（注意不能嵌套在其他指令块内，必须顶层）：
关键点：
和
是纯字符串替换，不支持表达式或默认值；宏名
区分大小写；
行末不能跟注释（会破坏解析）。
宏里嵌套条件判断？别试了，mod_macro 没这功能
有人想写 “如果传入
为 true 就加 PHP-FPM 代理”，这是常见误解。mod_macro 是纯文本预处理器，**不执行逻辑判断，不读取环境变量，也不支持 if/else**。所有分支必须拆成不同宏（如
和
），或退回到传统
（Apache 2.4+）配合
变量。
真正容易踩的坑是路径拼接错误：比如
末尾带斜杠，和宏里写的
一拼就变成
，虽多数情况能容错，但在 SELinux 或严格权限下可能失败。建议统一约定参数不带尾部
，并在宏内部显式处理。
复杂宏调试困难——Apache 不报宏展开后的实际配置，只能靠
看最终生效的虚拟主机列表，或临时把宏内容复制出来手工替换变量验证。
httpd.conflibapache2-mod-macrohttpd-mod-macroInvalid command 'Macro'ls /usr/lib/apache2/modules/mod_macro.so/usr/lib64/httpd/modules/mod_macro.soMacroLoadModule macro_module modules/mod_macro.soapachectl -t -D DUMP_MODULES | grep macromacro_module (shared)apachectl -tsystemctl reload apache2httpd.confmacros.confInclude
ServerName $domain
DocumentRoot $docroot
ErrorLog $docroot/../logs/$domain-error.log
CustomLog $docroot/../logs/$domain-access.log combined
Require all granted
Use VHostBase example.com /var/www/example
Use VHostBase api.example.com /var/www/api$domain$docrootVHostBaseUse$phpVHostWithPHPVHostStaticDefine$docroot$docroot/../logs/var/www/example//../logs/apachectl -t -D DUMP_VHOSTS