ThinkPHP集成PHPMailer实现带图附件邮件发送

闻溪

发布时间：2026-10-13 | 5人浏览过

原创

本文详细介绍在ThinkPHP框架中集成PHPMailer库的方法，包括配置SMTP参数、封装支持HTML正文与附件的发送函数，解决企业级应用中的自动化通知需求。

结果与目标

最终目标是能够在ThinkPHP项目中稳定调用接口发送包含HTML富文本、本地图片（CID方式）及文件附件的电子邮件，满足业务系统通知需求。

准备条件

开发环境：已安装ThinkPHP框架的项目根目录。
依赖库：下载最新版的PHPMailer源文件包。
邮箱服务：开启邮箱SMTP服务的账号及专用授权码（非登录密码）。

操作顺序

第1步：部署PHPMailer核心库

将下载的PHPMailer文件夹重命名或保留原名，放置到ThinkPHP项目的Library/Vendor目录下，以便框架自动加载。

此步骤确保后续可以通过 vendor() 函数正确引入类文件。

第2步：配置SMTP连接参数

在项目的配置文件 config.php 中添加邮件相关的常量或数组配置。建议配置项包含：

MAIL_HOST：SMTP服务器地址（如 smtp.qq.com）。
MAIL_PORT：端口号（通常为465或587）。
MAIL_NAME：发件人邮箱账号。
MAIL_PWD：SMTP授权密码。
MAIL_FROMNAME：显示的发件人名称。

配置完成后，可通过 C('MAIL_CONF') 方便地在全局获取这些参数。

第3步：编写邮件发送函数

在 Common/function.php（或对应的公共函数文件）中定义 mailSend 方法。该方法接收一个包含收件人、主题、内容及附件信息的关联数组。

/**
 * 邮件发送,可以多图片,多附件发送
 * @param $mailInfo $mailInfo = array(   //二维数组
 *    'address' => 'xx@xx.com', //收件人邮箱
 *    'subject' => '这里是邮件主题',
 *    'body' => "<h2>你好</h2>&nbsp;这是一个邮件,
 *      <a href='#'>http://www.test.com</a>
 *      <hr><img alt='这是一张图片' src='cid:test_id1'>",//图片src对应图片标识
 *    'img' => array(
 *    'path' => 'test/1.jpg', //可以使用相对路径
 *    'cid' => 'test_id1', //附件内容标识
 *    'name' => '1.jpg'
 *    ),
 *    'attachment'=> array(
 *    'path' => 'text/text.txt',
 *    'name' => '附件.txt'
 *    ),
 *   );
 * @return bool
 * @throws Exception
 * @throws phpmailerException
 */
function mailSend($mailInfo){
 //date_default_timezone_set('Asia/Shanghai');//设置时区
 vendor('PHPMailer.class#phpmailer');
 $mail = new \PHPMailer();
 $mailConfig = C('MAIL_CONF');//获取mail配置
 
 //配置项
 $mail->isSMTP();
 $mail->Host = $mailConfig['MAIL_HOST'];
 $mail->Port = $mailConfig['MAIL_PORT'];//端口
 $mail->SMTPAuth = $mailConfig['MAIL_SMTPAUTH'];//启用SMTP认证
 $mail->CharSet = $mailConfig['MAIL_CHARSET'];
 $mail->Encoding = $mailConfig['MAIL_ENCODING'];
 $mail->Username = $mailConfig['MAIL_NAME']; //发送邮箱
 $mail->Password = $mailConfig['MAIL_PWD'];
 $mail->FromName = $mailConfig['MAIL_FROMNAME']; //发件人名字
 
 //内容
 $mail->addAddress($mailInfo['address']);//收件人邮箱
 $mail->Subject = $mailInfo['subject']; //邮件主题
 
 //图片以及附件
 $mail->isHTML(true); //支持html格式内容

 //最后一个参数可不写,默认为原文件名
 $mail->addEmbeddedImage($mailInfo['img']['path'],$mailInfo['img']['cid'],$mailInfo['img']['name']);//图片路径,图片cid，图片名称
 $mail->addAttachment($mailInfo['attachment']['path'],$mailInfo['attachment']['name']);//添加附件,并指定名称
 
 //邮件主体
 $mail->Body = $mailInfo['body'];//发送
 return $mail->send()?true:false;
}