Windows11下PHPSMTP邮件设置教程

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Windows 11配置PHP SMTP邮件发送设置》，聊聊，希望可以帮助到正在努力赚钱的你。

要在Windows 11上让PHP支持SMTP发送邮件，核心在于配置php.ini并使用PHPMailer。1. 编辑php.ini文件，设置SMTP服务器地址、端口和发件人邮箱；2. 重启Web服务器使配置生效；3. 使用PHPMailer库处理SMTP认证和加密，通过Composer安装并编写脚本，配置Host、Username、Password、SMTPSecure和Port等参数；4. 注意使用邮箱服务商提供的授权码而非登录密码。此方法解决了mail()函数无法处理认证和加密的问题，确保邮件能成功发送。

在Windows 11上让PHP支持SMTP发送邮件，核心在于正确配置php.ini文件，告诉PHP你的SMTP服务器在哪里，以及如何连接。但仅仅这样还不够，因为PHP自带的mail()函数本身并不支持SMTP认证，而现代的邮件服务商几乎都要求认证。所以，更实际的做法是结合php.ini的基础配置，并引入一个专业的PHP邮件发送库，比如PHPMailer，来处理复杂的SMTP认证和加密。

解决方案

要让你的Windows 11上的PHP环境能够通过SMTP发送邮件，你需要做几件事：

1. 找到并编辑 php.ini 文件： 通常，这个文件位于你的PHP安装目录下（例如，如果你使用XAMPP，它可能在 C:\xampp\php\）。用文本编辑器打开它。

   

2. 配置 [mail function] 部分： 在这个文件中搜索 [mail function]。你会找到类似下面的配置项。你需要根据你的SMTP服务提供商（比如Gmail, QQ邮箱, 163邮箱等）来修改它们：

   [mail function]
   ; For Win32 only.
   ; http://php.net/smtp
   SMTP = smtp.your-email-provider.com  ; 替换为你的SMTP服务器地址，例如 smtp.qq.com 或 smtp.gmail.com
   ; http://php.net/smtp-port
   smtp_port = 587                      ; 常用端口是587（TLS加密）或465（SSL加密），25（非加密，不推荐）
   ; http://php.net/sendmail-from
   sendmail_from = your_email@example.com ; 替换为你发送邮件的邮箱地址

   这里需要注意的是，php.ini 里的 SMTP 和 smtp_port 只是告诉PHP通过哪个服务器和端口去尝试发送邮件。它不包含用户名和密码。这就是为什么我们稍后要引入PHPMailer的原因。

   

3. 重启你的Web服务器： 如果你使用的是Apache、Nginx或IIS，保存 php.ini 后，务必重启它们，让新的配置生效。

4. 编写一个简单的PHP测试脚本（使用PHPMailer）： 由于 mail() 函数的局限性，我们通常会使用PHPMailer这样的库。首先，你需要通过Composer安装PHPMailer： composer require phpmailer/phpmailer

   然后，你可以这样编写你的邮件发送脚本：

   SMTPDebug = 0;                      // 调试模式，0表示关闭，2表示详细输出
       $mail->isSMTP();                           // 设定邮件使用SMTP
       $mail->Host       = 'smtp.qq.com';         // 你的SMTP服务器地址，例如 smtp.qq.com, smtp.gmail.com
       $mail->SMTPAuth   = true;                  // 启用SMTP认证
       $mail->Username   = 'your_email@qq.com';   // 你的邮箱地址
       $mail->Password   = 'your_authorization_code'; // 邮箱授权码，不是你的登录密码！Gmail是应用专用密码
       $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // 启用SSL/TLS加密，建议使用PHPMailer::ENCRYPTION_SMTPS（对应465端口）或PHPMailer::ENCRYPTION_STARTTLS（对应587端口）
       $mail->Port       = 465;                   // 对应的端口号，如果使用SMTPS是465，STARTTLS是587
   
       // 收件人
       $mail->setFrom('your_email@qq.com', '你的名字'); // 发件人邮箱和名称
       $mail->addAddress('recipient@example.com', '收件人姓名'); // 收件人邮箱和名称
       // $mail->addReplyTo('info@example.com', '信息'); // 回复地址
       // $mail->addCC('cc@example.com'); // 抄送
       // $mail->addBCC('bcc@example.com'); // 密送
   
       // 内容
       $mail->isHTML(true);                       // 设定邮件格式为HTML
       $mail->Subject = '这是一封来自PHP的测试邮件'; // 邮件主题
       $mail->Body    = '你好，这是一封通过PHPMailer发送的HTML测试邮件！'; // 邮件内容（HTML）
       $mail->AltBody = '你好，这是一封通过PHPMailer发送的纯文本测试邮件！'; // 邮件内容（纯文本，当HTML不支持时显示）
   
       $mail->send();
       echo '邮件发送成功！';
   } catch (Exception $e) {
       echo "邮件发送失败。错误信息: {$mail->ErrorInfo}";
   }
   ?>

   请注意，your_authorization_code通常不是你的邮箱登录密码，而是邮箱服务商提供的一个“授权码”或“客户端专用密码”。例如，QQ邮箱和163邮箱需要开启SMTP服务并获取授权码，Gmail则需要生成应用专用密码。

为什么直接使用 mail() 函数在 Windows 上发送邮件常常失败？

这其实是个老生常谈的问题了，很多人初学PHP时都会遇到。mail() 函数在设计之初，主要是为了与类Unix系统上的本地邮件传输代理（MTA），比如Sendmail或Postfix，进行交互。它本身并没有实现完整的SMTP客户端功能，比如连接SMTP服务器、发送认证信息（用户名和密码）、处理加密连接（SSL/TLS）等等。

在Windows环境下，默认情况下并没有一个像Sendmail这样的MTA服务运行。虽然你可以在 php.ini 中配置 SMTP 和 smtp_port 来指定一个远程SMTP服务器，但mail()函数在尝试连接这个服务器时，并不能处理现代SMTP服务器普遍要求的认证和加密步骤。它就像一个只会喊话的传声筒，但要传递的信息（邮件）需要加密，而且收件人（SMTP服务器）需要你先亮明身份（认证），它就傻眼了。

此外，很多互联网服务提供商（ISP）出于反垃圾邮件的考虑，会默认阻止住宅用户通过25端口（SMTP的默认非加密端口）直接发送邮件。即使你的mail()函数能连上，也可能因为端口被封锁而失败。所以，mail()函数在Windows上的“失败”，更多是其设计局限性和现代邮件服务安全要求的矛盾体现。

配置 php.ini 时，SMTP 服务器和端口的选择有哪些考量？

选择正确的SMTP服务器和端口是邮件能成功发送的关键一步。这就像你要寄信，首先得知道邮局在哪里，以及它开放的窗口是哪个。

首先是 SMTP服务器地址 (SMTP = ...)。这个地址通常由你的邮件服务提供商提供。比如：

• Gmail: smtp.gmail.com
• Outlook/Hotmail: smtp.office365.com 或 smtp-mail.outlook.com
• QQ邮箱: smtp.qq.com
• 163邮箱: smtp.163.com 选择你正在使用的邮箱对应的SMTP服务器地址就行。

然后是 SMTP端口 (smtp_port = ...)。端口的选择与加密方式息息相关：

• 端口 25： 这是传统的SMTP端口，通常用于非加密连接。但现在非常不推荐使用，因为大多数ISP会屏蔽这个端口以防止垃圾邮件，而且数据传输不加密，安全性很低。
• 端口 587： 这是目前推荐的SMTP端口，用于STARTTLS加密。这意味着连接开始时是明文，然后通过STARTTLS命令升级为加密连接。它在安全性、兼容性上都有不错的表现。
• 端口 465： 这个端口用于SMTPS（SMTP over SSL/TLS），即连接一开始就使用SSL/TLS加密。虽然在RFC中，587端口是更推荐的，但很多邮件服务商仍然支持并推荐465端口用于SSL加密连接。

在实际配置时，你需要根据你的邮件服务商的要求来选择。如果你的服务商明确推荐某个端口和加密方式（例如，Gmail推荐587+STARTTLS或465+SSL），那就按他们说的来。如果你不确定，可以先尝试587，如果不行再试试465。记住，端口和加密方式是配套的，选错了端口，即使服务器地址对，也可能连不上或者连接失败。

如何解决 PHP mail() 函数无法直接支持 SMTP 认证的问题？

正如前面提到的，PHP内置的mail()函数本身并不具备处理SMTP认证的能力，这在现代邮件发送中是一个巨大的障碍，因为几乎所有邮件服务商都要求通过用户名和密码进行身份验证才能发送邮件。要解决这个问题，最主流、最稳妥的方法就是使用一个成熟的PHP邮件发送库。

这些库封装了复杂的SMTP协议细节，包括：

• SMTP认证： 它们能处理用户名和密码的提交，与SMTP服务器进行身份验证。
• 加密连接： 支持SSL/TLS加密，确保邮件内容在传输过程中的安全。
• 更强大的功能： 比如发送HTML邮件、添加附件、处理抄送/密送、设置发件人名称、处理邮件编码、错误报告等等。

在众多PHP邮件发送库中，PHPMailer 无疑是最流行、功能最全面且易于使用的选择。

使用PHPMailer的优势和方法：

1. 易于安装： 通过Composer可以轻松安装到你的项目中，这是PHP项目管理依赖的推荐方式。 composer require phpmailer/phpmailer

2. 配置直观： PHPMailer提供了一套清晰的API，让你能够像配置对象属性一样设置SMTP服务器、端口、用户名、密码、加密方式等。

3. 强大的功能集：

   • 你可以轻松发送带图片的HTML邮件，而不仅仅是纯文本。
   • 添加附件变得非常简单。
   • 支持多种编码，避免乱码问题。
   • 详细的错误报告，帮助你调试发送失败的原因。
   • 支持自定义邮件头，甚至可以模拟不同的发件人。

4. 处理授权码/应用密码： 现代邮箱服务商为了安全，通常会要求你使用一个“授权码”或“应用专用密码”来代替你的邮箱登录密码进行SMTP认证。PHPMailer能够很好地处理这种情况，你只需要将这个授权码作为$mail->Password的值即可。这大大提高了安全性，因为即使授权码泄露，也无法直接登录你的邮箱。

通过引入PHPMailer，你不仅解决了mail()函数无法认证的问题，还让你的邮件发送功能变得更加健壮、灵活和安全。这在开发任何需要邮件通知功能的Web应用时，都是一个几乎必不可少的选择。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。