Python邮件发送，看这篇就够

时间  2019-11-08
标签 python 邮件 发送 看这 栏目 Python 繁體版
原文   原文链接

本文为译文，原文连接 Sending Emails With Python
本人博客: 编程禅师html

你可能由于想使用Python发送电子邮件而找到了本教程。 也许你但愿写代码来接收邮件提醒，在用户建立账户时向用户发送确认邮件，或向组织成员发送邮件以提醒他们支付会费。 发送邮件是一项耗时且容易出错的任务，可是使用Python能够轻松实现自动化。python

在本教程中,你将了解如何:git

  • 使用 SMTP_SSL() 和 .starttls() 设置安全链接github

  • 使用Python的内置 smtplib 库发送基本电子邮件shell

  • 使用 email 包发送包含HTML内容和附件的电子邮件编程

  • 发送多份包含联系人数据的CSV文件的个性化电子邮件api

  • 使用 Yagmail 包只需几行代码便可经过Gmail账户发送电子邮件安全

你将在本教程结束时找到一些事务性的电子邮件服务，当你想要发送大量电子邮件时，这些服务会颇有用。服务器

准备开始

Python内置了 smtplib 模块，用于使用简单邮件传输协议（SMTP）发送电子邮件。 smtplib 在SMTP中使用 RFC 821协议。 本教程中的示例将使用Gmail SMTP服务器发送电子邮件，但相同的原则适用于其余电子邮件服务。 虽然大多数电子邮件提供商使用与本教程中相同的链接端口，但你可使用Google搜索来快速确认。app

要开始本教程，请先创建用于开发的Gmail账户，或者创建一个SMTP调试服务器，邮件将不会发送而是将其打印到控制台中。 下面列出了这两个选项。 本地SMTP调试服务器可用于修复电子邮件功能的任何问题，并确保在发送任何电子邮件以前你的电子邮件功能没有错误。

选项一: 创建用于开发的Gmail帐户

若是你决定使用Gmail账户发送电子邮件，我强烈建议你为开发代码设置一次性账户。 这是由于你必须调整Gmail账户的安全设置来容许从你的Python代码访问，并且你也可能会意外地泄露你的登陆详细信息。 此外，我发现个人测试账户的收件箱很快就填满了测试电子邮件，这也足以让你设置一个新的Gmail账户进行开发。

Gmail的一个不错的功能是，你可使用 + 号在@符号前面的电子邮件地址中添加任何修饰符。 例如，发送到 my+person1@gmail.com 和 my+person2@gmail.com 的邮件都将发送到 my@gmail.com 。 在测试电子邮件功能时，你可使用此功能模拟全部指向同一收件箱的多个地址。

要建立用于测试代码的Gmail地址，请执行如下操做：

若是你不想下降Gmail账户的安全设置，请查看Google的文档，了解如何使用Python脚本进行OAuth2受权来获取访问凭据。

选项二:创建一个本地SMTP服务器

你可使用Python预先安装的 smptd 模块运行一个本地SMTP调试服务器来测试电子邮件功能。 它不会将电子邮件发送到指定的地址，而是丢弃它们并将其内容打印到控制台。 运行本地调试服务器意味着无需处理消息加密或使用凭据登陆电子邮件服务器。

你能够经过在命令提示符下输入如下内容来启动本地SMTP调试服务器：

python -m smtpd -c DebuggingServer -n localhost:1025
复制代码

在Linux上，在相同的命令以前加上 sudo。

经过此服务器发送的任何电子邮件都将被丢弃，并在终端窗口中每行显示一个 bytes 对象：

---------- MESSAGE FOLLOWS ----------
b'X-Peer: ::1'
b''
b'From: my@address.com'
b'To: your@address.com'
b'Subject: a local test mail'
b''
b'Hello there, here is a test email'
------------ END MESSAGE ------------
复制代码

对于本教程的其他部分，我假设你使用的是Gmail账户，但若是你使用的是本地调试服务器，请确保使用 localhost 做为SMTP服务器地址并使用端口为1025而不是端口465或587。 除此以外，你不须要使用 login() 或使用 SSL / TLS 加密通讯。

发送纯文本邮件

在咱们深刻发送包含HTML内容和附件的电子邮件以前，你将学会使用Python发送纯文本电子邮件。 这些是你能够在简单的文本编辑器中编写的电子邮件。 没有像文本格式或超连接这样的奇特东西。 这些稍后你会了解到。

开始一个安全SMTP链接

当你经过Python发送电子邮件时，应确保你的SMTP链接已加密，以便其余人没法轻松访问你的邮件和登陆凭据。 SSL（安全套接字层）和TLS（传输层安全性）是两种可用于加密SMTP链接的协议。 使用本地调试服务器时，没必要使用其中任何一个。

有两种方法能够与你的电子邮件服务器创建安全链接：

  • 使用 SMTP_SSL() 创建安全的SMTP链接
  • 使用不安全的SMTP链接，而后使用 .starttls() 加密

在这两种状况下，Gmail都会使用TLS加密电子邮件，由于这是SSL更安全的后续版本。 根据Python的安全注意事项，强烈建议你使用 ssl 模块中的 create_default_context()。 这将加载系统的可信CA证书，启用主机名检查和证书验证，并尝试选择适合的安全的协议和密码设置。

若是要检查Gmail收件箱中电子邮件的加密信息，请转到更多→显示原始内容来查看“已接收”标题下列出的加密类型。

smtplib 是Python的内置模块，用于使用SMTP或ESMTP监听器守护程序向任何Internet计算机发送电子邮件。

我将首先向你展现如何使用 SMTP_SSL()，由于它从一开始就实例化一个安全的链接，而且比使用 .starttls() 替代方案略微简洁。 请注意，若是使用 SMTP_SSL() ，则Gmail要求你链接到465端口，使用 .starttls() 时，要求链接到589端口。

选项1: 使用 SMPT_SSL()

下面的代码示例使用 smtplib 的 SMTP_SSL() 初始化TLS加密链接，以此来与Gmail的SMTP服务器创建安全链接。 ssl 的默认上下文验证主机名及其证书，并优化链接的安全性。 请务必填写你本身的电子邮件地址而不是 my@gmail.com：

import smtplib, ssl

port = 465  # For SSL
password = input("Type your password and press enter: ")

# Create a secure SSL context
context = ssl.create_default_context()

with smtplib.SMTP_SSL("smtp.gmail.com", port, context=context) as server:
    server.login("my@gmail.com", password)
    # TODO: Send email here
复制代码

使用 with smtplib.SMTP_SSL() as server 确保链接在缩进代码块的末尾自动关闭。 若是port为零或未指定，则 .SMTP_SSL() 将使用标准端口（端口465）。

将电子邮件密码存储在代码中并不安全，特别是若是你打算与他人共享。 相反，使用input() 让用户在运行脚本时输入密码，如上例所示。 若是你在输入时不但愿密码显示在屏幕上，则能够导入 getpass 模块并使用 .getpass() 代替直接输入密码。

选项2: 使用 .starttls()

咱们能够建立一个不安全的SMTP链接并使用 .starttls() 加密它，而不是使用 .SMTP_SSL() 一开始就建立是安全的链接。

为此，建立一个 smtplib.SMTP 实例，该实例封装SMTP链接并容许你访问其方法。 我建议你在脚本开头定义SMTP服务器和端口，以便轻松配置它们。

下面的代码片断使用 server= SMTP() ，而不是使用 with SMTP() as server: 这个咱们在上一个示例中使用了的格式。 为了确保在出现问题时代码不会崩溃，请将主代码放在 try 块中，让 except 块将任何错误消息打印到 stdout ：

import smtplib, ssl

smtp_server = "smtp.gmail.com"
port = 587  # For starttls
sender_email = "my@gmail.com"
password = input("Type your password and press enter: ")

# Create a secure SSL context
context = ssl.create_default_context()

# Try to log in to server and send email
try:
    server = smtplib.SMTP(smtp_server,port)
    server.ehlo() # Can be omitted
    server.starttls(context=context) # Secure the connection
    server.ehlo() # Can be omitted
    server.login(sender_email, password)
    # TODO: Send email here
except Exception as e:
    # Print any error messages to stdout
    print(e)
finally:
    server.quit() 
复制代码

要通知服务器让它知道本身，应在建立 .SMTP() 对象后调用 .helo() （SMTP）或 .ehlo() （ESMTP），并在 .starttls() 后再调用。 此函数由 .starttls() 和 .sendmail() 隐式调用，所以除非你要检查服务器的SMTP服务扩展，不然没必要显式调用 .helo() 或 .ehlo() 。

发送你的纯文本邮件

使用上述任一方法发起一个安全SMTP链接后，你可使用 .sendmail() 发送电子邮件：

server.sendmail(sender_mail, receiver_email, message)
复制代码

我建议在 import 后在脚本顶部定义电子邮件地址和邮件内容，以便你能够方便更改它们：

sender_email = "my@gmail.com"
receiver_email = "your@gmail.com"
message = """\ Subject: Hi there This message is sent from Python."""

# Send email here
复制代码

message 字符串以 “Subject：Hi there” 开头，后跟两个换行符（\ n）。 这样能够确保 Hi there 为电子邮件的主题显示，而且新的一个行后面的文本将被视为邮件正文。

下面的代码示例使用 SMTP_SSL() 发送纯文本电子邮件：

import smtplib, ssl

port = 465  # For SSL
smtp_server = "smtp.gmail.com"
sender_email = "my@gmail.com"  # Enter your address
receiver_email = "your@gmail.com"  # Enter receiver address
password = input("Type your password and press enter: ")
message = """\ Subject: Hi there This message is sent from Python."""

context = ssl.create_default_context()
with smtplib.SMTP_SSL(smtp_server, port, context=context) as server:
    server.login(sender_email, password)
    server.sendmail(sender_email, receiver_email, message)
复制代码

这是经过使用 .starttls() 加密SMTP链接发送纯文本电子邮件的一个代码示例。做为对照， server.ehlo() 行能够省略，由于若是须要，它们将由 .starttls() 和 .sendmail() 隐式调用：

import smtplib, ssl

port = 587  # For starttls
smtp_server = "smtp.gmail.com"
sender_email = "my@gmail.com"
receiver_email = "your@gmail.com"
password = input("Type your password and press enter:")
message = """\ Subject: Hi there This message is sent from Python."""

context = ssl.create_default_context()
with smtplib.SMTP(smtp_server, port) as server:
    server.ehlo()  # Can be omitted
    server.starttls(context=context)
    server.ehlo()  # Can be omitted
    server.login(sender_email, password)
    server.sendmail(sender_email, receiver_email, message)
复制代码

发送花哨的电子邮件

Python的内置 email 包容许你构建更多花哨的电子邮件，而后可使用 smptlib 进行传输。 下面，你将了解如何使用 email` 包发送包含HTML内容和附件的电子邮件。

包含HTML内容

若是你要格式化电子邮件中的文本（粗体，斜体等），或者若是要添加任何图像，超连接或响应式的内容，则使用HTML很是方便。 今天最多见的电子邮件类型是MIME（多用途因特网邮件扩展）多部分的电子邮件，它结合了HTML和纯文本。 MIME消息由Python的 email.mime 模块处理。 有关详细说明，请查看文档 。

因为并不是全部电子邮件客户端都默认显示HTML内容，而且出于安全缘由，有些人仅选择接收纯文本电子邮件，所以为HTML消息添加纯文本的替代很是重要。 因为电子邮件客户端将首先渲染最后一部分的附件，所以请确保在纯文本版本以后添加HTML消息。

在下面的示例中，咱们的 MIMEText() 对象将包含消息的HTML和纯文本版本，MIMEMultipart（"alternative"） 实例将这些组合成一个带有两个备用渲染选项的消息：

import smtplib, ssl
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart

sender_email = "my@gmail.com"
receiver_email = "your@gmail.com"
password = input("Type your password and press enter:")

message = MIMEMultipart("alternative")
message["Subject"] = "multipart test"
message["From"] = sender_email
message["To"] = receiver_email

# Create the plain-text and HTML version of your message
text = """\ Hi, How are you? Real Python has many great tutorials: www.realpython.com"""
html = """\ <html> <body> <p>Hi,<br> How are you?<br> <a href="http://www.realpython.com">Real Python</a> has many great tutorials. </p> </body> </html> """

# Turn these into plain/html MIMEText objects
part1 = MIMEText(text, "plain")
part2 = MIMEText(html, "html")

# Add HTML/plain-text parts to MIMEMultipart message
# The email client will try to render the last part first
message.attach(part1)
message.attach(part2)

# Create secure connection with server and send email
context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
    server.login(sender_email, password)
    server.sendmail(
        sender_email, receiver_email, message.as_string()
    )
复制代码

在此示例中，首先将纯文本和HTML消息定义为字符串文字，而后将它们存储为 plain / html MIMEText 对象。 而后能够按顺序将这些添加到 MIMEMultipart（"alternative"） 消息中，并经过与电子邮件服务器的安全链接发送。 请记住在替代的纯文本后添加HTML消息，由于电子邮件客户端将尝试首先渲染最后一个子部分。

使用 email 添加附件

为了将二进制文件发送到设计用于处理文本数据的电子邮件服务器，须要在传输以前对其进行编码。 这一般使用base64完成，它将二进制数据编码为可打印的ASCII字符。

下面的代码示例展现了如何在发送电子邮件时将PDF文件做为附件：

import email, smtplib, ssl

from email import encoders
from email.mime.base import MIMEBase
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText

subject = "An email with attachment from Python"
body = "This is an email with attachment sent from Python"
sender_email = "my@gmail.com"
receiver_email = "your@gmail.com"
password = input("Type your password and press enter:")

# Create a multipart message and set headers
message = MIMEMultipart()
message["From"] = sender_email
message["To"] = receiver_email
message["Subject"] = subject
message["Bcc"] = receiver_email  # Recommended for mass emails

# Add body to email
message.attach(MIMEText(body, "plain"))

filename = "document.pdf"  # In same directory as script

# Open PDF file in binary mode
with open(filename, "rb") as attachment:
    # Add file as application/octet-stream
    # Email client can usually download this automatically as attachment
    part = MIMEBase("application", "octet-stream")
    part.set_payload(attachment.read())

# Encode file in ASCII characters to send by email 
encoders.encode_base64(part)

# Add header as key/value pair to attachment part
part.add_header(
    "Content-Disposition",
    f"attachment; filename= {filename}",
)

# Add attachment to message and convert message to string
message.attach(part)
text = message.as_string()

# Log in to server using secure context and send email
context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
    server.login(sender_email, password)
    server.sendmail(sender_email, receiver_email, text)
复制代码

MIMEultipart() 接受RFC5233样式的键/值对形式的参数，这些参数存储在字典中并传递给 Message 基类的 .add_header方法。

查看Python的 email.mime 模块的文档，了解有关使用MIME类的更多信息。

发送多封个性化电子邮件

想象一下，你但愿向你组织的成员发送电子邮件，以提醒他们支付他们的捐款费用。 或者，你可能但愿向班级中的学生发送个性化电子邮件，其中包含最近做业的成绩。 这些任务在Python中垂手可得。

使用相关我的信息制做CSV文件

发送多封个性化电子邮件的简单开始是建立包含全部必需我的信息的CSV（逗号分隔值）文件。 （确保在未经他们赞成的状况下不共享其余人的私人信息。）CSV文件能够被视为一个简单的表，其中第一行一般包含列标题。

如下是 contacts_file.csv 文件的内容，我将其保存在与Python代码相同的文件夹中。 它包含一组虚构人物的名称，地址和成绩。 我使用 my+modifier@gmail.com 构造来确保全部电子邮件最终都在我本身的收件箱中，在此示例中为 my@gmail.com ：

name,email,grade
Ron Obvious,my+ovious@gmail.com,B+
Killer Rabbit of Caerbannog,my+rabbit@gmail.com,A
Brian Cohen,my+brian@gmail.com,C
复制代码

建立CSV文件时，请确保使用逗号分隔你的值，而不包含任何的空格。

遍历行发送多个邮件

下面的代码示例显示了如何打开CSV文件并循环其内容行（跳过标题行）。 为了确保代码在你向全部联系人发送电子邮件以前正常运行。我已经为每一个联系人打印了 Sending email to ...，咱们稍后能够用实际发送电子邮件的功能替换它们：

import csv

with open("contacts_file.csv") as file:
    reader = csv.reader(file)
    next(reader)  # Skip header row
    for name, email, grade in reader:
        print(f"Sending email to {name}")
        # Send email here
复制代码

在上面的示例中，使用 open(filename) as file: 确保你的文件在代码块的末尾关闭。 csv.reader() 能够逐行读取CSV文件并提取其值。 next(reader) 会跳过标题行，接下的一行 for name, email, grade in reader：使用Python中的解包操做，并将结果值存储在当前联系人的名称，电子邮件和成绩中。

若是CSV文件中的值包含任一侧或两侧的空格，则可使用 .strip() 方法删除它们。

个性化的的内容

你可使用 str.format() 填充大括号占位符，将个性化内容放入消息中。 例如，"hi {name}, you {result} your assignment".format(name="John", result="passed") 会给你 "hi John, you passed your assignment" 。

从Python 3.6开始，使用f-string能够更优雅地完成字符串格式化，但这些须要在f-string自己以前定义占位符。 为了在脚本开头定义电子邮件消息，并在循环CSV文件时填写每一个联系人的占位符，使用较旧的 .format() 方法。

考虑到这一点，你能够设置一个通用消息体，其中能够为我的定制占位符。

代码案例

如下代码示例容许你向多个联系人发送个性化电子邮件。 它会循环CSV文件显示每一个联系人的姓名，电子邮件，成绩的，如上例所示。

常规消息在脚本开头定义，对于CSV文件中的每一个联系人，其 {name} 和 {grade} 占位符都已填入，而且经过与Gmail服务器的安全链接发送个性化电子邮件，正如你以前看过的：

import csv, smtplib, ssl

message = """Subject: Your grade Hi {name}, your grade is {grade}"""
from_address = "my@gmail.com"
password = input("Type your password and press enter: ")

context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
    server.login(from_address, password)
    with open("contacts_file.csv") as file:
        reader = csv.reader(file)
        next(reader)  # Skip header row
        for name, email, grade in reader:
            server.sendmail(
                from_address,
                email,
                message.format(name=name,grade=grade),
            )
复制代码

Yagmail

有多个库可让您更轻松地发送电子邮件，例如 Envelopes，Flanker 和 Yagmail。 Yagmail旨在专门用于Gmail，它经过友好的API大大简化了发送电子邮件的过程，以下面的代码示例所示：

import yagmail

receiver = "your@gmail.com"
body = "Hello there from Yagmail"
filename = "document.pdf"

yag = yagmail.SMTP("my@gmail.com")
yag.send(
    to=receiver,
    subject="Yagmail test with attachment",
    contents=body, 
    attachments=filename,
)
复制代码

此代码示例发送带有PDF附件的电子邮件，比咱们使用 email 和 smtplib 发送邮件的例子代码量大大减小 。

设置Yagmail时，你能够将Gmail验证添加到操做系统的密钥环中，如文档中所述。 若是你不这样作，Yagmail会在须要时提示你输入密码并自动将其存储在密钥环中。

事务性邮件服务

若是你计划发送大量电子邮件，想要查看电子邮件统计信息，并但愿确保可靠的投放，则可能须要查看事务性电子邮件服务。 虽然如下全部服务都发送大量电子邮件的付费套餐，但他们还提供免费套餐，以便你能够试用它们。 其中一些免费计划无限期有效，可能足以知足你的电子邮件需求。

如下是一些主要事务性电子邮件服务的免费计划概述。 单击提供商名称将转到其网站的订价部分。

供应商 免费套餐
Sendgrid 起初30天内40000封免费，接下来100封/天
Sendinblue 200 封/天
Mailgun 开始的10000封免费
Mailjet 200 封/天
Amazon SES 62,000 封/月

你能够运行Google搜索以查看最符合你需求的提供商，或者只是尝试一些免费计划，以查看你最喜欢哪一种API。

Sendgrid代码示例

这是一个使用Sendgrid发送电子邮件的代码示例，为你提供如何使用Python的事务性电子邮件服务的方法：

import os
import sendgrid
from sendgrid.helpers.mail import Content, Email, Mail

sg = sendgrid.SendGridAPIClient(
    apikey=os.environ.get("SENDGRID_API_KEY")
)
from_email = Email("my@gmail.com")
to_email = Email("your@gmail.com")
subject = "A test email from Sendgrid"
content = Content(
    "text/plain", "Here's a test email sent through Python"
)
mail = Mail(from_email, subject, to_email, content)
response = sg.client.mail.send.post(request_body=mail.get())

# The statements below can be included for debugging purposes
print(response.status_code)
print(response.body)
print(response.headers)
复制代码

要运行此代码，你必须先：

有关如何在Mac和Windows设置Sendgrid，能够在Github上的存储库README中找到更多信息。

总结

你如今能够启动安全的SMTP链接，并向联系人列表中的人员发送多个个性化电子邮件！

你已经学会了如何使用纯文本替代方式发送HTML电子邮件，并将文件附加到你的电子邮件中。 当你使用Gmail账户时，Yagmail软件包可简化全部这些任务。 若是你计划发送大量电子邮件，则值得研究事务性电子邮件服务。

享受用Python发送电子邮件，但记住：请不要垃圾邮件！

代码与艺术

关注公众号 <代码与艺术>，学习更多国外精品技术文章。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程