PHP 8.2 本身不支持宏，HTML 也无原生宏语法；所谓“HTML 模板中的宏”实为 Twig、Blade、ThinkPHP 等模板引擎提供的功能，需按各引擎规则定义与调用。
PHP 8.2 本身不支持“宏”（macro）概念，HTML 中也没有原生宏语法。所谓“HTML 模板中的宏”，实际是模板引擎（如 Twig、Blade、ThinkPHP 的模板引擎）提供的功能，不是 PHP 或 HTML 自带能力。
所以问题本质是：在 PHP 8.2 环境下，如何在所用模板引擎中定义并调用宏？
下面以三种主流场景说明（按使用频率排序）：
✅ Twig 模板中调用宏（最典型）
Twig 是唯一将 macro 作为一级语法支持的主流引擎。
立即学习“PHP免费学习笔记（深入）”；
-
定义宏（通常放在独立文件
macros.twig或模板顶部）：{% macro input(name, value, type = 'text') %} <input type="{{ type }}" name="{{ name }}" value="{{ value|e }}" /> {% endmacro %} -
导入并调用（在目标模板中）：
{% import 'macros.twig' as form %} {{ form.input('username', 'admin', 'password') }}注意：PHP 8.2 对 Twig 3.10+ 完全兼容，确保已安装
twig/twig:^3.10，且禁用已被弃用的{{ macro() }}全局调用方式（需显式import）。
✅ ThinkPHP 8.0 模板中模拟“宏”（无原生 macro，但可封装）
TP8 模板不支持 macro，但可通过模板标签 + 公共模板片段实现等效效果：
-
新建公共片段
template/widget/input.html：<input type="{$type|default='text'}" name="{$name}" value="{$value|default=''}" /> -
在页面中引入并传参：
{include file="widget/input" name="username" value="$user.name" type="text"}这种方式在 PHP 8.2 下完全安全，
$user.name会经 TP8 的变量解析器正确处理（推荐用{$user->name}更稳妥，避免数组键名歧义）。
✅ 原生 PHP + HTML 混写时的“伪宏”函数
不用模板引擎时，可把重复结构封装为普通 PHP 函数：
<?php
function renderInput(string $name, string $value = '', string $type = 'text'): string {
return sprintf('<input type="%s" name="%s" value="%s" />',
htmlspecialchars($type),
htmlspecialchars($name),
htmlspecialchars($value)
);
}
?>
<!-- 在 HTML 中调用 -->
<?= renderInput('email', 'test@example.com', 'email') ?>PHP 8.2 强类型提示让这类函数更健壮，且 IDE 可精准补全参数；注意必须手动转义，不能依赖
echo自动过滤。
⚠️ 容易踩坑的点
-
<script>或<style>标签内写的{% macro %}不会被 Twig 解析——宏只在.twig文件的 PHP/Twig 执行上下文中生效。 - 不要尝试在 HTML 文件里写
<?php macro ... ?>—— PHP 没有macro语言结构，会直接报错Parse error。 - Blade（Laravel）虽有
@component和@slot，但它叫“组件”而非“宏”，语法和调用方式完全不同，不能混用。
本质上，没有“PHP 调用 HTML 宏”这回事，只有“PHP 运行的模板引擎提供了宏机制，你按其规则使用”。选对引擎、看清文档、避开 PHP 8.2 已弃用的 ${var} 插值写法，就稳了。
