php框架邮件模板需支持变量替换、结构复用与路径定位，否则占位符无法渲染；无框架用file_get_contents+str_replace，yii2用compose加载php模板，symfony用twig自动转义，thinkphp则封装全局函数处理。
PHP框架中拼接邮件模板内容不是简单地把HTML字符串拼在一起，而是要让变量可替换、结构可复用、路径可定位，否则发出去的欢迎邮件里用户名字还是{{username}}。
读取模板并手动替换变量
适用于无框架或轻量项目，直接读文件+str_replace最直白。
第一步：在项目根目录下新建mail_templates/welcome.html，写好带占位符的HTML：
欢迎 {{name}}
您的注册邮箱是 {{email}}
第二步：PHP中读取并替换：
$template = file_get_contents('mail_templates/welcome.html');
$message = str_replace(['{{name}}', '{{email}}'], ['张三', 'zhangsan@example.com'], $template);
这一步操作起来很简单，直接把文件拖进去就行。但注意：【占位符必须完全一致，大小写和空格都不能差】，否则替换后还是原样。
Yii2中用compose()加载PHP模板
Yii2不认.html，只认.php模板，且路径和命名受viewPath严格约束。
方法一：确认mailer组件已配置viewPath指向@common/mail（或@app/mail）
方法二：在对应目录下创建common/mail/welcome.php，内容为纯PHP输出：
use yii\helpers\Html;
echo Html::tag('h2', '欢迎 ' . $name);
echo Html::tag('p', '您的注册邮箱是 ' . Html::encode($email));
?>
方法三：控制器中调用：
$mail = Yii::$app->mailer->compose('welcome', ['name' => '李四', 'email' => 'lisi@example.com'])
→ setTo('lisi@example.com')
→ setSubject('欢迎注册')
→ send();
这里【'welcome'必须与文件名welcome.php完全一致，不能写成welcome.html或Welcome.php】，否则报错或静默失败。
Symfony中用Twig渲染模板
Symfony默认集成SwiftMailer + Twig，变量注入自然，语法清爽。
① 在templates/emails/welcome.html.twig中写：
欢迎 {{ user.name }}
您的注册邮箱是 {{ user.email }}
② PHP逻辑层构建消息时传入数组：
$message = (new \Swift_Message('欢迎注册'))
→ setFrom(['noreply@example.com' => '系统'])
→ setTo($to)
→ setBody(
$this->renderView('emails/welcome.html.twig', [
'user' => ['name' => '王五', 'email' => 'wangwu@example.com']
]),
'text/html'
);
③ 发送：
$this->get('mailer')->send($message);
Twig模板里不用操心HTML转义——{{ user.email }}自动防XSS，但{{ user.email|raw }}会跳过转义，慎用。
ThinkPHP中封装全局函数拼接
ThinkPHP没内置邮件抽象层，靠自己封装函数最常见。
在Application/Common/Common/function.php里定义：
function send_welcome_email($to, $data) {
vendor('swiftmailer.swift_required');
$template = file_get_contents(APP_PATH . 'Common/Conf/email_tpl/welcome.html');
$content = str_replace(array_keys($data), array_values($data), $template);
// 后续走SwiftMailer发送逻辑...
}
调用时传关联数组即可：
send_welcome_email('user@domain.com', ['{{name}}' => '赵六', '{{reg_time}}' => date('Y-m-d H:i')]);
注意：APP_PATH常量必须存在，否则file_get_contents会找不到路径。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
