PHPMailer使用封装教程：为自己的PHP项目配置邮件功能

php 开发语言经验分享 2023-09-04 20:09:29 861人浏览安东尼

摘要

PHPMailer使用封装教程：为自己的php项目配置邮件功能若为获取最佳阅读体验，请移步至本文永久链接：https://xenns.com/posts/1df67ba2/ 开源的PHPMailer

PHPMailer使用封装教程：为自己的php项目配置邮件功能

若为获取最佳阅读体验，请移步至本文永久链接：https://xenns.com/posts/1df67ba2/

开源的PHPMailer简洁易用，相对于PHP官方文档提供的mail()需要一个已安装且正在运行的邮件系统，才能使邮件函数可用，选择更强大易用的PHPMailer无疑一个更为明智的选择。

一、引言

最近在对一个停止维护的必应每日壁纸源码进行二次开发，在开发过程期间难免会有报错。为了避免每次报错的时候还需要去翻阅日志，就想到了用邮件把每天的自动抓取结果发送到自己的邮箱里。每次运行的结果都能及时的收到通知。本想PHPMailer的封装教程在网上已经不再罕见，去翻阅的时候却发现大部分的封装教程或多或少都有点过时了。索性我直接去翻阅了官方文档，按照官方的使用建议，去除了不必要的配置内容并进行了封装，也写下了比较符合现在PHPMailer的封装教程以供网友们查阅。

二、PHPMailer下载

PHPMailer的下载有两种方式，直接下载GitHub源代码或通过Composer安装。

这里我以github源码下载方式以及163邮箱配置为例。

2.0 示例版本

今天是2022-09-18，我所使用的版本为PHPMailer 6.6.4

2.1 从 github 上下载

GitHub链接：https://github.com/PHPMailer/PHPMailer/

2.2 通过Composer安装

composer require phpmailer/phpmailer

2.3 下载PHPMailer 6.6.4（可选）

为防止本文配置适用性降低，推荐大家下载与本文版本相同的6.6.4版本。
本文所用源码下载链接在文末给出。

2.4 所需文件

下载完成后的目录结构应为如下所示，我们只需要src目录下的Exception.php、PHPMailer.php、SMTP.php三个文件，并将它放入项目目录中。

PHPMailer│ │  COMMITMENT│  composer.JSON│  darknetf.txt│  get_oauth_token.php│  LICENSE│  README.md│  SECURITY.md│  VERSION│  ├─language│      phpmailer.lang-zh.php│      phpmailer.lang-zh_cn.php│      └─src        Exception.php        OAuth.php        OAuthTokenProvider.php        PHPMailer.php        POP3.php        SMTP.php

三、配置与使用

3.0 环境要求

注意，在使用之前，应检查PHP的openssl扩展与Sockets扩展是否已开启。

3.1 官方示例

//Import PHPMailer classes into the global namespace//These must be at the top of your script, not inside a functionuse PHPMailer\PHPMailer\PHPMailer;use PHPMailer\PHPMailer\SMTP;use PHPMailer\PHPMailer\Exception;//Load Composer's autoloaderrequire 'vendor/autoload.php';//Create an instance; passing `true` enables exceptions$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->Username   = 'user@example.com';                     //SMTP username    $mail->PassWord   = 'secret';   //SMTP password    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;            //Enable implicit TLS encryption    $mail->Port       = 465;        //tcp port to connect to; use 587 if you have set `SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS`    //Recipients    $mail->setFrom('from@example.com', 'Mailer');    $mail->addAddress('joe@example.net', 'Joe User');     //Add a recipient    $mail->addAddress('ellen@example.com');               //Name is optional    $mail->addReplyTo('info@example.com', 'InfORMation');    $mail->addCC('cc@example.com');    $mail->addBCC('bcc@example.com');    //Attachments    $mail->addAttachment('/var/tmp/file.tar.gz');         //Add attachments    $mail->addAttachment('/tmp/image.jpg', 'new.jpg');    //Optional name    //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}";}

3.2 个人使用及封装

以下为我个人的使用及封装建议

mail.php

// Import PHPMailer classes into the global namespace// These must be at the top of your script, not inside a functionuse PHPMailer\PHPMailer\PHPMailer;use PHPMailer\PHPMailer\Exception;use PHPMailer\PHPMailer\SMTP;function send_email($to="",$subject='',$content='Hello World
'){    // 引入PHPMailer的核心文件    require_once(dirname(__FILE__)."/phpmailer/PHPMailer.php"); //这里的三个文件应填入你的PHPMailer放置目录    require_once(dirname(__FILE__)."/phpmailer/Exception.php");    require_once(dirname(__FILE__)."/phpmailer/SMTP.php");        $config = include 'config.php';    //初始化邮箱配置信息---在Config.php文件中进行配置    $mailUsername = $config['mailUsername']; //这里应    $mailPassword = $config['mailPassword'];    $mailFromName = $config['mailFromName'];    $mailHost = $config['mailHost'];    $mailPort = $config['mailPort'];        // 实例化PHPMailer核心类    $mail = new PHPMailer(true);    try {           // 是否启用smtp的debug进行调试 开发环境建议开启 生产环境注释掉即可 默认关闭debug调试模式           // 开启debug调试模式在报错时会给出更多错误信息，数值越高信息越详细          //Enable SMTP debugging          // 0 = off (for production use)          // 1 = client messages          // 2 = client and server messages          //$mail->SMTPDebug = 2;          //调试输出格式          //$mail->DebuGoutput = 'html';          //客户端配置---Server settings          $mail->isSMTP(); // 使用smtp鉴权方式发送邮件          $mail->SMTPAuth = true; // smtp需要鉴权 这个必须是true          $mail->Host = $mailHost; // 链接邮箱的服务器地址          $mail->Username = $mailUsername; // smtp登录的账号，163邮箱与QQ邮箱均可          $mail->Password = $mailPassword; // smtp登录的密码，此处应邮箱账号开启SMTP服务生成的授权码          $mail->SMTPSecure = 'ssl'; // 设置使用ssl加密方式登录鉴权          $mail->Port = $mailPort; // 设置ssl连接smtp服务器的远程服务器端口号          $mail->CharSet = 'UTF-8'; // 设置发送的邮件的编码          //邮件账户设置---Recipients          $mail->setFrom($mailUsername, $mailFromName); // 设置发件人邮箱地址与昵称          $mail->addReplyTo($mailUsername, ['Information']); // 设置回复时的用户与昵称，应与发件人相同                     // 设置收件人邮箱地址          // $mail->addAddress('joe@example.net', ['Joe User']); // 收件人配置示例，昵称配置可选          // 有多个收件人时添加多个收件人，效果等同于多个$mail->addAddress()          if(is_array($to))          {              foreach($to as $v)              {                  $mail->addAddress($v);              }          }else{              $mail->addAddress($to);          }          //邮件内容---Content          $mail->isHTML(true); // 邮件正文是否为html编码          $mail->Subject = $subject; // 所要发送邮件的主题          // 添加邮件正文          // 这里我需要挨个发送多条消息，发送很多条邮件又很麻烦，索性就搞了一个数组          // 每条消息添加到数组中，最后以
换行符合成一个字符串          // 如果不是数组也无需改动          if(is_array($content))          {              $allcontent = implode('
', $content);  // 将一维数组以
分隔组合成一个字符串              $mail->Body = $allcontent;          }else{              $mail->Body = $content;          }                    //附加信息，可以省略          //$mail->AltBody = "This is the body in plain text for non-HTML mail clients";                    //附件          //$mail->addAttachment('./example.pdf');  // 若需要发送附件就取消此条注释，将路径改为需要发送文件的路径。                    // 发送邮件 返回状态          $mail->send();          echo '
邮件发送成功！';        } catch (Exception $e) {          echo "
Message could not be sent. Mailer Error: {$mail->ErrorInfo}";    }}?>

Config.php

// 邮箱配置信息// **********发件人配置************$config['mailUsername']  = '********'; //邮箱发件人账号$config['mailPassword']  = '********'; //邮箱发件人SMTP密码$config['mailFromName']  = '********'; //邮箱发件人昵称$config['mailHost']      = '********'; //邮箱服务器$config['mailPort']      = '********'; //邮箱端口号，以163为例，若不使用SSL加密方式则端口号为25，否则为465// ***********发件内容及收件人配置******$config['mailReceiver']  = '********'; //收件人配置，可设置单个收件人，若需多个收件人则以数组['***', '***']形式。$config['mailSubject']   = '********'; //所发邮件主题$config['mailContent']   = '********'; //所发邮件内容return $config;?>

3.3 使用方法

将PHPMailer的三个src文件放入项目目录，并在mail.php当中修改引入路径。

在config.php中填入所需相关配置。

将mail.php引入自己项目PHP文件中，使用sent_email()函数即可。

示例：

<?php//引入配置文件$config = include 'config.php';// 引入邮箱类include 'mail.php';//初始化邮件发送信息及收件人$mailReceiver = $config['mailReceiver'];$mailSubject = $config['mailSubject'];$mailContent = $config['mailContent'];send_email($to=$mailReceiver, $subject=$mailSubject, $content=$mailContent);?>