在PHP项目中结合SendGrid发送邮件时，通过字符串替换实现动态数据注入是一种轻量高效的方案，不需要引入复杂的模板引擎，适合简单的动态邮件场景，比如发送验证码、订单通知、用户欢迎邮件等。
前期准备工作
首先确保完成以下基础配置：
- 拥有可用的SendGrid账号，并且已经创建好API Key，需要开启邮件发送权限
- PHP环境版本不低于7.2，并且已经安装Guzzle HTTP客户端，用于调用SendGrid的API
- 提前设计好邮件模板，在需要插入动态数据的位置设置明确的占位符，比如用
{{user_name}}、{{order_id}}这类格式，避免和模板原有内容冲突
核心实现步骤
1. 设计带占位符的邮件模板
先准备纯文本的邮件模板内容，把动态数据位置用自定义占位符标记，示例如下：
<?php
// 邮件模板内容，占位符用{{key}}格式
$emailTemplate = <<<TEMPLATE
尊敬的{{user_name}}，您好：
您的订单{{order_id}}已经发货，物流单号为{{logistics_no}}，预计3-5个工作日送达。
如有疑问可以联系我们的客服邮箱：support@ipipp.com
TEMPLATE;
?>2. 定义动态数据映射数组
把需要替换的动态数据整理成键值对数组，键名和模板中的占位符对应：
<?php
// 动态数据数组，键名对应模板占位符（去掉{{}}后的部分）
$dynamicData = [
'user_name' => '张三',
'order_id' => 'ORD202405001',
'logistics_no' => 'SF1234567890'
];
?>3. 执行字符串替换逻辑
使用PHP内置的str_replace函数，批量替换模板中的占位符为实际数据：
<?php
// 分离占位符和替换值
$placeholders = [];
$replaceValues = [];
foreach ($dynamicData as $key => $value) {
$placeholders[] = '{{' . $key . '}}';
$replaceValues[] = $value;
}
// 执行替换，得到最终邮件内容
$finalEmailContent = str_replace($placeholders, $replaceValues, $emailTemplate);
echo $finalEmailContent;
?>4. 调用SendGrid API发送邮件
替换完成后的内容可以直接通过SendGrid的API发送，以下是完整的发送示例：
<?php
require 'vendor/autoload.php';
use SendGrid\Mail\Mail;
// 初始化SendGrid实例，填入你的API Key
$sendgrid = new \SendGrid('你的SendGrid_API_Key');
$email = new Mail();
$email->setFrom("noreply@ipipp.com", "示例商城");
$email->setSubject("订单发货通知");
$email->addTo("user@ipipp.com", "张三");
// 设置邮件内容为替换后的HTML或文本
$email->addContent("text/plain", $finalEmailContent);
// 如果需要HTML格式，可以准备HTML模板做同样的替换操作
// $email->addContent("text/html", $finalHtmlContent);
try {
$response = $sendgrid->send($email);
print_r($response->statusCode());
print_r($response->headers());
} catch (Exception $e) {
echo '邮件发送失败：' . $e->getMessage();
}
?>注意事项
- 占位符格式尽量统一，避免使用特殊字符，防止和模板原有内容冲突，比如不要使用<、>这类HTML特殊字符作为占位符一部分
- 如果模板是HTML格式，替换前需要确保动态数据中的特殊字符已经做好转义，避免破坏HTML结构或者引发XSS风险
- 批量发送邮件时，可以循环处理不同的动态数据数组，重复执行替换逻辑即可，不需要重复定义模板
- 如果动态数据较多，也可以考虑使用
strtr函数，替换效率比多次str_replace更高
常见问题排查
如果替换后还有占位符残留，首先检查动态数据数组的键名是否和占位符完全匹配，包括大小写和下划线；如果SendGrid返回发送失败，先检查API Key是否有效，发件人地址是否已经通过SendGrid的验证。