技术讲座：在PHP项目中用Mailgun发送电子邮件——轻松搞定邮件功能

各位同学，大家好！今天我们要聊一聊如何在PHP项目中使用Mailgun发送电子邮件。如果你正在开发一个需要发送邮件的Web应用，比如用户注册验证、密码重置或者订单通知，那么你来对地方了！接下来，我会以一种轻松诙谐的方式，手把手教你搞定这一切。

---

为什么选择Mailgun？

在正式开始之前，我们先聊聊为什么选择Mailgun。Mailgun是一个强大的电子邮件服务提供商，它提供了简单易用的API接口，支持高送达率，并且免费版就能满足大多数小型项目的邮件需求。最重要的是，它的文档清晰明了（虽然有点“老外味儿”），非常适合初学者上手。

以下是Mailgun的一些亮点：

• 易于集成：通过简单的API调用即可发送邮件。
• 高送达率：Mailgun优化了邮件投递机制，确保你的邮件不会被误判为垃圾邮件。
• 免费额度：每月有免费的邮件发送额度，足够应对小规模项目。

---

准备工作

在开始编写代码之前，我们需要完成以下准备工作：

1. 注册Mailgun账户

首先，你需要注册一个Mailgun账户（国外技术文档提到过，注册过程非常简单）。注册完成后，你会获得一个默认的域名（例如 sandboxXXXXX.mailgun.org），以及API密钥和SMTP凭据。

2. 安装Guzzle HTTP客户端

Mailgun的API是基于HTTP请求的，因此我们需要一个工具来发送这些请求。推荐使用Guzzle HTTP客户端，它是一个流行的PHP库，专门用于处理HTTP请求。

可以通过Composer安装Guzzle：

composer require guzzlehttp/guzzle

3. 配置环境变量

为了保护你的API密钥，建议将敏感信息存储在环境变量中。你可以使用 .env 文件来管理这些变量。

创建一个 .env 文件，内容如下：

MAILGUN_API_KEY=your_api_key_here
MAILGUN_DOMAIN=sandboxXXXXX.mailgun.org

然后在项目中加载这些变量，可以使用 vlucas/phpdotenv 库：

composer require vlucas/phpdotenv

---

编写代码

现在，让我们进入正题，编写代码实现邮件发送功能。

1. 初始化项目结构

假设我们的项目目录结构如下：

project/
├── vendor/
├── .env
├── index.php
└── send_email.php

2. 加载依赖和环境变量

在 index.php 中，加载必要的依赖和环境变量：

<?php
require 'vendor/autoload.php';

use DotenvDotenv;

$dotenv = Dotenv::createImmutable(__DIR__);
$dotenv->load();

$api_key = $_ENV['MAILGUN_API_KEY'];
$domain = $_ENV['MAILGUN_DOMAIN'];

3. 创建邮件发送函数

接下来，在 send_email.php 中编写邮件发送逻辑。我们将使用Guzzle发送POST请求到Mailgun API。

<?php
require 'vendor/autoload.php';

use GuzzleHttpClient;

function sendEmail($to, $subject, $text) {
    // 获取环境变量
    $apiKey = $_ENV['MAILGUN_API_KEY'];
    $domain = $_ENV['MAILGUN_DOMAIN'];

    // 初始化Guzzle客户端
    $client = new Client();

    // 发送POST请求到Mailgun API
    $response = $client->post("https://api.mailgun.net/v3/$domain/messages", [
        'auth' => ['api', $apiKey],
        'form_params' => [
            'from'    => 'Excited User <mailgun@' . $domain . '>',
            'to'      => $to,
            'subject' => $subject,
            'text'    => $text,
        ],
    ]);

    // 返回响应状态码
    return $response->getStatusCode();
}

// 测试发送邮件
$emailSent = sendEmail('recipient@example.com', 'Hello from Mailgun', 'This is a test email sent via PHP and Mailgun.');
if ($emailSent === 200) {
    echo "Email sent successfully!";
} else {
    echo "Failed to send email.";
}

4. 解释代码

让我们逐行解释这段代码：

• 第6-7行：从环境变量中获取Mailgun的API密钥和域名。
• 第10行：初始化Guzzle HTTP客户端。
• 第15-20行：构造POST请求，传递邮件的相关参数（发件人、收件人、主题和正文）。
• 第24-28行：测试发送邮件，并根据返回的状态码判断是否成功。

---

常见问题及解决方案

在使用Mailgun的过程中，可能会遇到一些常见的问题。下面列出了一些可能的情况及其解决方法：

问题	可能原因	解决方案
邮件发送失败	API密钥错误	检查 .env 文件中的API密钥是否正确
收件人未收到邮件	收件人地址未验证	在Mailgun控制台中验证收件人地址（免费版限制）
请求超时	网络连接问题	检查服务器网络连接，确保可以访问Mailgun API

---

总结

好了，今天的讲座到这里就结束了！通过本文的学习，你应该已经掌握了如何在PHP项目中使用Mailgun发送电子邮件的基本技能。总结一下关键点：

1. 注册Mailgun账户并获取API密钥。
2. 使用Guzzle发送HTTP请求到Mailgun API。
3. 将敏感信息存储在环境变量中，确保安全性。

如果你还有其他问题，欢迎随时提问！下一次讲座，我们将探讨如何使用Mailgun的模板功能发送HTML格式的邮件。期待与你再次相见！