原文来自: http://yushine.iteye.com/blog/1167734
简介 :
虽然python提供了smtplib库,来完成email的发送功能,但是django对其进行了封装,使得发送邮件的接口变得更简单,更方便,django的封装位于django.core.mail
例子:
from
django.core.mail
import
send_mail
send_mail
(
'Subject here'
,
'Here is the message.'
,
'from@example.com'
,
[
'to@example.com'
],
fail_silently
=
False
)
邮件的发送通过django的setting文件中设置的 EMAIL_HOST
、 EMAIL_PORT
、 EMAIL_HOST_USER
、
EMAIL_HOST_PASSWORD
来认证SMTP服务器、 EMAIL_USE_TLS
用来说明发送的时候是否使用一个安全的连接
来进行, DEFAULT_CHARSET
用来指定发送邮件的字符集。
定义:
(1)
send_mail
(subject
, message
, from_email
, recipient_list
,
fail_silently=False
, auth_user=None
,auth_password=None
)
作用:发送一个邮件
subject:邮件的标题
message:邮件的内容
from_email:发送邮件者
recipient_list
:接受邮件者列表
fail_silently:可选参数,默认是False,如果是False,则发送失败时候,会抛出
smtplib.SMTPException异常
,具体详细的异常,
请参考 smtplib docs
,这些异常都是SMTPException的子类。
auth_user
:可选的参数,如果有,那么认证SMTP Server时,使用该用户,否则使用EMAIL_HOST_USER
设置
auth_password:可选参数,如果有,那么认证SMTP
Server时,使用该密码,否则使用EMAIL_HOST_PASSWORD
设置
(2)
send_mass_mail(datatuple
, fail_silently=False
, auth_user=None
, auth_password=None
)
datatuple
:是一个元组,其格式如下:
(
subject
,
message
,
from_email
,
recipient_list
)
作用:发送一组邮件
fail_silently
, auth_user
and auth_password三个参数的意义同send_mail。
send_mass_mail和send_mail的区别
send_mail每次发送邮件都打开一个新的连接来发送。
send_mass_mail每次发送邮件时仅仅打开一个连接,将这次元组中的所有邮件发送出去。
所以send_mass_mail更有效率。
两个给管理员发送邮件的快捷方式
mail_admins (subject , message , fail_silently=False )
和
mail_managers (subject , message , fail_silently=False )
这两个方法在发送邮件时注意以下两点:
(1)邮件的标题前面django会自动加上 EMAIL_SUBJECT_PREFIX 中设置的前缀,缺省是"[Django] " 。
(2)邮件的发送者将是由SERVER_EMAIL 来设置
(3)邮件的接受者将是 MANAGERS 和 ADMINS 来设置
EmailMessage 和 SMTPConnection
上面提供的email函数,仅仅能够提供最基本的发送邮件的功能,其他的诸如:文件附件和多媒体email都需要EmailMessage类来提供。
EmailMessage构造函数的所有参数如下所示,所有参数都是可选的
subject: 邮件的标题
body:邮件的正文, 这个字段应该是纯文本文件
from_email:发送者的邮件地址,fred@example.com 和 Fred <fred@example.com>,这两种格式都是合法的,
如果该字段没有设置的话,将使用setting中的 DEFAULT_FROM_EMAIL
to:所有接收人组成的一个元组
bcc:所有秘密抄送人组成的一个元组
connection: 发送邮件是使用的SMTPConnection 连接,如果不适用该字段,那么每次发送邮件时都会新建
一个SMTPConnection 对象
attachments:附件列表, 能是email.MIMEBase.MIMEBase实例,或者 (filename, content, mimetype)元组
headers:邮件头字段, 如果要增加额外的邮件头,请用该字段,关键字是key,值是value。
例如:
email
=
EmailMessage
(
'Hello'
,
'Body goes here'
,
'from@example.com'
,
[
'to1@example.com'
,
'to2@example.com'
],
[
'bcc@example.com'
],
headers
=
{
'Reply-To'
:
'another@example.com'
})
该类有下列方法可用:
(1)send(fail_silently=False) 发送邮件,如果fail_silently=False时,出错将抛掷异常
(2)
message() 返回一个
django.core.mail.SafeMIMEText类型的对象或者
django.core.mail.SafeMIMEMultipart类型的对象。
(3)
recipients()
获取发送人列表,包括to和bcc的所有发送人
(4)attach() 向邮件中增加附件,其参数可以是
email.MIMEBase.MIMEBase的实例,或者是
filename
, content
and mimetype,
其中filename是附件中呈现的文件名,content是附件的数据,
mimetype
是附件的MIME类型
例如:message
.
attach
(
'design.png'
,
img_data
,
'image/png'
)
(5)attach_file()
直接从文件系统中向邮件添加附件,如果mime类型没有填写,那么django会根据文件名推测出来。
例如:message
.
attach_file
(
'/images/weather_map.png'
)
EmailMultiAlternatives
使用EmailMessage中发送邮件的内容,只能是一种类型的"text/html"或者
"text/plain"。但是实际应用中,
我们可能会一封邮件中既有text/html
的内容,又有text/plain的内容,这个时候可以使用EmailMultiAlternatives
类,他是EmailMessage
的子类,他有一个方法attach_alternative()
,可以让邮件中包括多种形式的内容
例如:
from
django.core.mail
import
EmailMultiAlternatives
subject
,
from_email
,
to
=
'hello'
,
'from@example.com'
,
'to@example.com'
text_content
=
'This is an important message.'
html_content
=
'<p>This is an <strong>important</strong> message.</p>'
msg
=
EmailMultiAlternatives
(
subject
,
text_content
,
from_email
,
[
to
])
msg
.
attach_alternative
(
html_content
,
"text/html"
)
msg
.
send
()
EmailMessage
的类型修改
EmailMessage
的类型默认情况下是"text/plain",可以通过修改subtype属性,使得类型变成"text/html"
例如:
msg
=
EmailMessage
(
subject
,
html_content
,
from_email
,
[
to
])
msg
.
content_subtype
=
"html"
# Main content is now text/html
msg
.
send
()
SMTPConnection 对象
SMTPConnection 初始化需要四个参数:连接SMTP服务器所需要的host, port, username and password,如果某个缺省了,那么就从setting文件中读取默认值,另外send_messages用来发送一个邮件列表
例如:
connection
=
SMTPConnection
()
# Use default settings for connection
messages
=
get_notification_email
() #get_notification_email假设是用户定义的一个函数,用来获取所有想发出去的邮件
connection
.
send_messages
(
messages
)
分享到:
相关推荐
主要介绍了django 邮件发送模块smtp使用详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
django+celery异步发送邮件
在发邮件时使用Python自带的发送邮件,出现只能发送一封邮件,第二次发送,提示发送成功但是无法收到,只好使用这个去发邮件了。是从Django代码中提取出来的,使用和Django一样,多了一个Header的参数,用于显示发件...
主要介绍了Django实现发送邮件功能,本文图文并茂给大家介绍的非常详细,具有一定的参考借鉴价值 ,需要的朋友可以参考下
Mandrill可以免费发送邮件,每月1万2000封的邮件数量足够普通使用。使用Django配合Mandrill发送邮件,配置相关DNS记录可以使邮件发送到收件箱而不会进入垃圾箱。可以访问forum.beavermagic.com灌水呀~
django-email-from-template:发送完全由Django模板生成的电子邮件
django邮件系统 Django发送邮件官方中文文档 总结如下: 1、首先这份文档看三两遍是不行的,很多东西再看一遍就通顺了。 2、send_mail()、send_mass_mail()都是对EmailMessage类使用方式的一个轻度封装,所以要关注...
在Django中,发送邮件非常的方便,一直没有时间,今天来做一个小小的总结吧。 我们常用的当然是通过send_mail发送邮件: 复制代码 代码如下:send_mail(subject,message,from_email,recipient_list,fail_silently=...
今天小编就为大家分享一篇Django集成celery发送异步邮件实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
django-celery-email:使用celery任务发送电子邮件的Django电子邮件后端
django-mail-templated:使用Django模板系统发送电子邮件
在各大网站上,一定都遇到过找回密码的问题,通常采用的方式是通过发送带有验证码的邮件进行身份验证,本文将介绍通过Django实现邮件找回密码功能,需要的朋友可以参考下
里面的邮件密码和账号都打了星号,需要自己添加
主要介绍了django中SMTP发送邮件配置,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
概述:Django中内置了邮件发送功能,发送邮件需要使用SMTP服务,常用的免费服务器有:163、126、QQ 注册并登陆163邮箱 打开POP3/SMTP服务与IMAP/SMTP服务 重置授权密码 配置 #邮件发送 EMAIL_BACKEND='django....
Django-Email-Sender:根据业务需求自动执行带有某些自定义功能的电子邮件发送过程
Django 2 By Example 电商网站项目–网站建立、购物车、订单、异步发送邮件 Django 2 By Example 电商网站项目–集成支付功能与发票生成 Django 2 By Example 电商网站项目–-优惠码、国际化与本地化、商品推荐系统 ...
Django Post Office是一个简单的应用程序,用于在Django中发送和管理您的电子邮件。 一些很棒的功能是: 允许您异步发送电子邮件 多后端支持 支持HTML电子邮件 支持HTML电子邮件中的内联图像 支持基于数据库的电子...