首先检查API配置和参数设置，再通过Composer安装Mailgun SDK，配置密钥与域名后，使用PHP代码发送文本、HTML邮件或添加附件。
如果您尝试通过PHP集成邮件服务发送邮件，但无法成功投递，则可能是由于API配置不当或请求参数错误。以下是使用Mailgun的PHP SDK实现邮件发送的具体步骤：
一、安装Mailgun PHP SDK
在使用Mailgun之前，需要将官方SDK引入项目中。推荐使用Composer进行依赖管理，确保环境已安装Composer工具。
1、打开终端并进入项目根目录。
2、执行以下命令安装Mailgun PHP SDK：composer require mailgun/mailgun-php。
立即学习“PHP免费学习笔记（深入）”；
3、等待依赖下载完成后，确认vendor目录中存在mailgun文件夹。
二、配置API密钥与域名
发送邮件前必须获取有效的API密钥和已验证的域名。这些信息可在Mailgun控制台的安全设置区域找到。
1、登录Mailgun官网，在仪表板中选择您的域名。
2、点击“Settings”选项卡，复制“API Keys”下的私钥（Private API Key）。
3、记录当前使用的发送域名，例如 sandboxXXXXXXXXXXXX.mailgun.org。
4、将密钥和域名存储在环境变量或配置文件中以提高安全性。
三、发送简单文本邮件
使用初始化客户端对象后，可通过简洁的方式构造并发送基础文本邮件。
1、创建一个新的PHP文件，如send_email.php。
2、引入自动加载文件：require 'vendor/autoload.php';。
3、实例化Mailgun客户端并设置域名称：
$mg = Mailgun::create('your-private-key');
$domain = "your-domain-name";
4、调用send方法发送纯文本内容：
$mg->messages()->send($domain, [ 'from' => 'sender@your-domain.com', 'to' => 'recipient@example.com', 'subject' => '测试邮件主题', 'text' => '这是一封通过PHP发送的测试邮件。' ]);
四、发送HTML格式邮件
支持富文本内容可提升用户体验，允许嵌入链接、样式及按钮等元素。
1、准备HTML字符串作为邮件正文，例如包含标题与超链接的内容。
2、修改发送参数，替换text字段为html字段：
$mg->messages()->send($domain, [ 'from' => 'sender@your-domain.com', 'to' => 'recipient@example.com', 'subject' => 'HTML格式邮件示例', 'html' => '
欢迎使用Mailgun服务
点击访问示例网站
' ]);3、确保HTML代码符合标准，避免因标签未闭合导致渲染异常。
五、添加附件发送邮件
当需要传输文件时，可通过attachments参数附加一个或多个文件。
1、确认待上传文件位于服务器可读路径下，例如uploads/report.pdf。
2、在消息参数中加入attachments数组：
$mg->messages()->send($domain, [ 'from' => 'sender@your-domain.com', 'to' => 'recipient@example.com', 'subject' => '带附件的邮件', 'text' => '请查收所附文件。', 'attachment' => [new \Mailgun\Attachment('uploads/report.pdf')] ]);
3、注意单个邮件总大小不得超过25MB限制。
