Ubuntu PHP如何配置SMTP邮件

首页

编程语言

热心网友

转载

2026-05-05

在Ubuntu上配置PHP以使用SMTP发送邮件

想让Ubuntu系统上的PHP应用通过SMTP协议发送邮件？其实没那么复杂，跟着下面这几个清晰的步骤走，通常都能顺利搞定。整个过程的核心，无非是选对工具、做好配置、然后完成测试。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

Ubuntu PHP如何配置SMTP邮件

安装PHP Mailer库

首先，需要一个可靠的邮件发送库。PHPMailer是个广受欢迎的选择，功能全面且稳定。推荐使用Composer来管理依赖，这是现代PHP项目的标准做法。

如果你的系统还没安装Composer，可以通过下面这两条命令快速安装：
```
sudo apt update
sudo apt install composer
```
安装好Composer之后，进入你的项目目录，执行下面的命令，PHPMailer就会被自动下载并配置好：
```
composer require phpmailer/phpmailer
```

配置SMTP设置

库准备好之后，下一步就是在PHP脚本中进行配置了。关键在于正确填写SMTP服务器的连接和认证信息。下面这段示例代码几乎涵盖了所有必需的设置项，你可以把它作为一个坚实的起点：

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try {
    // Server settings
    $mail->SMTPDebug = SMTP::DEBUG_SERVER; // Enable verbose debug output
    $mail->isSMTP(); // Send using SMTP
    $mail->Host = 'smtp.example.com'; // Set the SMTP server to send through
    $mail->SMTPAuth = true; // Enable SMTP authentication
    $mail->AuthType = SMTP::AUTH_LOGIN; // Authentication type (if not set, default is LOGIN)
    $mail->Port = 587; // TCP port to connect to; use 587 if you ha ve set `SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS`
    $mail->SMTPSecure = SMTP::ENCRYPTION_STARTTLS; // Enable implicit TLS encryption
    $mail->Username = 'your_email@example.com'; // SMTP username
    $mail->Password = 'your_password'; // SMTP password
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // Enable explicit TLS encryption

    // Recipients
    $mail->setFrom('from@example.com', 'Mailer');
    $mail->addAddress('recipient@example.com', 'Joe User'); // Add a recipient

    // Content
    $mail->isHTML(true); // Set email format to HTML
    $mail->Subject = 'Here is the subject';
    $mail->Body = 'This is the HTML message body in bold!';
    $mail->AltBody = 'This is the body in plain text for non-HTML mail clients';

    $mail->send();
    echo 'Message has been sent';
} catch (Exception $e) {
    echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}

请注意，你需要将代码中的占位符（如 smtp.example.com、your_email@example.com 和密码）替换成你自己邮件服务商提供的真实信息。

测试邮件发送

配置写完后，最重要的一步来了：运行你的PHP脚本进行测试。如果一切顺利，你会看到成功的提示。如果遇到了错误，别慌，绝大多数问题都出在SMTP服务器地址、端口、用户名或密码这几项配置上。仔细核对一遍，往往就能解决问题。
配置PHPMailer的调试模式

在开发阶段，如果邮件发送失败，打开调试模式是定位问题最快的方法。它会输出与SMTP服务器通信的详细对话过程。只需设置下面这一行：
```
$mail->SMTPDebug = SMTP::DEBUG_SERVER; // Enable verbose debug output
```
当然，记得在生产环境中将其关闭，以避免泄露敏感信息。