使用PHP mail()函数发件失败，报错无法连接本地邮件服务器

这个报错我之前也碰到过，本质是PHP的mail()函数默认依赖本地运行的SMTP服务器（localhost:25），但你的环境里要么没安装邮件服务，要么配置不正确。下面给你几个可行的解决方向：

1. 调整php.ini的SMTP配置 #

首先找到你的php.ini文件（可以通过phpinfo()查看具体路径），搜索并修改以下配置项：

# 替换为可用的SMTP服务器，比如Gmail的SMTP
SMTP=smtp.gmail.com
smtp_port=587
# 填写发件人邮箱
sendmail_from=sender123@gmail.com

修改后重启你的Web服务器（比如Apache/Nginx）让配置生效。

如果不想修改全局配置，也可以在代码里用ini_set()临时设置：

<?php
// 临时设置SMTP参数
ini_set("SMTP", "smtp.gmail.com");
ini_set("smtp_port", "587");
ini_set("sendmail_from", "sender123@gmail.com");

$sender = 'sender123@gmail.com';
$recipient = 'resever123@gmail.com';
$subject = "php mail test";
$message = "php test message";
$headers = 'From:' . $sender;

if (mail($recipient, $subject, $message, $headers)) {
    echo "Message accepted";
} else {
    echo "Error: Message not accepted";
}
?>

⚠️ 注意：mail()函数本身不支持SSL/TLS加密，所以如果用Gmail这类需要加密的邮箱，可能还是会失败，这时候更推荐用下面的第三方库方案。

2. 安装本地SMTP服务器 #

如果想继续使用localhost:25作为邮件服务器，需要在你的机器上安装并启动邮件服务：

• Windows：可以安装hMailServer、Mercury（XAMPP自带），安装完成后确保服务启动，并且25端口没有被防火墙拦截。
• Linux：安装Postfix或Sendmail，执行以下命令（以Ubuntu为例）：

  sudo apt-get install postfix
  sudo systemctl start postfix
  

  安装后测试25端口是否监听：netstat -tuln | grep 25，确保有输出。

3. 使用第三方邮件库（推荐） #

mail()函数功能有限且对现代邮箱的加密支持不好，更稳定的方案是用PHPMailer或SwiftMailer这类专业邮件库。以PHPMailer为例，步骤如下：

1. 下载PHPMailer（可以通过Composer安装：composer require phpmailer/phpmailer）
2. 使用以下示例代码：

<?php
require 'vendor/autoload.php'; // Composer安装的话用这个，否则引入对应文件

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

$mail = new PHPMailer(true);

try {
    // SMTP配置
    $mail->isSMTP();
    $mail->Host = 'smtp.gmail.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'sender123@gmail.com';
    $mail->Password = '你的应用密码'; // Gmail需开启2FA后生成应用密码
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port = 587;

    // 收件人信息
    $mail->setFrom('sender123@gmail.com', 'Test Sender');
    $mail->addAddress('resever123@gmail.com', 'Test Recipient');

    // 邮件内容
    $mail->Subject = 'php mail test';
    $mail->Body = 'php test message';

    $mail->send();
    echo "Message accepted";
} catch (Exception $e) {
    echo "Error: Message not accepted. Mailer Error: {$mail->ErrorInfo}";
}
?>

这个方案支持SSL/TLS加密，适配绝大多数邮箱服务商，出错时还能给出具体错误信息，排查问题更方便。

额外检查项 #

• 确保你的防火墙没有阻止25、587等SMTP端口的出站连接。
• 如果你用第三方邮箱（如Gmail、Outlook），需要在邮箱设置里开启SMTP服务，部分邮箱需要生成专用的应用密码（而非登录密码）。

内容的提问来源于stack exchange，提问作者Jadav Ramesh