20.12. `smtplib` — SMTP (简单邮件传输协议) 客户端 ¶

源代码： Lib/smtplib.py

The smtplib 模块定义 SMTP 客户端会话对象，可以用于将邮件发送给采用 SMTP 或 ESMTP 监听器守护程序的任何 Internet 机器。对于 SMTP 和 ESMTP 操作的细节，请翻阅 RFC 821 (简单邮件传输协议) 和 RFC 1869 (SMTP 服务扩展)。

class smtplib. SMTP ( [ host [ , port [ , local_hostname [ , timeout ] ] ] ] ) ¶

class smtplib. SMTP_SSL ( [ host [ , port [ , local_hostname [ , keyfile [ , certfile [ , timeout ] ] ] ] ] ] ) ¶

class smtplib. LMTP ( [ host [ , port [ , local_hostname ] ] ] ) ¶

还定义了一些不错异常：

exception smtplib. SMTPException ¶

exception smtplib. SMTPServerDisconnected ¶

exception smtplib. SMTPResponseException ¶

exception smtplib. SMTPSenderRefused ¶

exception smtplib. SMTPRecipientsRefused ¶

exception smtplib. SMTPDataError ¶

exception smtplib. SMTPConnectError ¶

exception smtplib. SMTPHeloError ¶

exception smtplib. SMTPAuthenticationError ¶

另请参阅

RFC 821 - SMTP (简单邮件传输协议)
RFC 1869 - ESMTP (SMTP 服务扩展): SMTP 的 ESMTP 扩展定义。这描述采用新的命令扩展 SMTP 框架，支持动态探索由服务器提供的命令，和定义一些额外命令。

20.12.1. SMTP 对象 ¶

An SMTP 实例具有下列方法：

SMTP. set_debuglevel ( level ) ¶

SMTP. docmd ( cmd [ , argstring ] ) ¶

SMTP. connect ( [ host [ , port ] ] ) ¶

SMTP. helo ( [ hostname ] ) ¶

SMTP. ehlo ( [ hostname ] ) ¶

SMTP. ehlo_or_helo_if_needed ( ) ¶

SMTPHeloError

2.6 版新增。

SMTP. has_extn ( 名称 ) ¶: 返回 True if name 在由服务器返回的一组 SMTP 服务扩展中， False 否则。大小写被忽略。

SMTP. verify ( address ) ¶

校验此服务器地址的有效性使用 SMTP VRFY 。返回的元组包含代码 250 和完整 RFC 822 地址 (包括人类姓名) 若用户地址有效。否则返回 400 或更大的 SMTP 错误代码和错误字符串。

注意

很多站点禁用 SMTP VRFY 为挫败垃圾邮件发送者。

SMTP. login ( user , password ) ¶

登录要求身份验证的 SMTP 服务器。参数是要进行身份验证的用户名和口令。若先前没有 EHLO or HELO 命令此会话，此方法将尝试 ESMTP EHLO 首先。此方法将正常返回若身份验证成功，或可能引发下列异常：

SMTPHeloError

SMTPAuthenticationError

服务器不接受用户名/口令组合。

SMTPException

模块未找到合适的身份验证方法。

SMTP. starttls ( [ keyfile [ , certfile ] ] ) ¶

SMTPHeloError
SMTPException: 服务器不支持 STARTTLS 扩展。

Changed in version 2.6.

RuntimeError

SMTP. sendmail ( from_addr , to_addrs , msg [ , mail_options , rcpt_options ] ) ¶

发送邮件。要求自变量为 RFC 822 from_addr 字符串，列表的 RFC 822 to_addr 字符串 (裸字符串将被视为具有 1 地址的列表) 和消息字符串。调用者可以传递 ESMTP 选项列表 (譬如 8bitmime ) 以用于 MAIL FROM 命令作为 mail_options 。ESMTP 选项 (譬如 DSN 命令) 应该用于所有 RCPT 命令可以传递作为 rcpt_options 。(若需要对不同收件人使用不同 ESMTP 选项，就必须使用低级方法，譬如 mail() , rcpt() and data() 以发送消息。)

注意

The from_addr and to_addrs parameters are used to construct the message envelope used by the transport agents. The SMTP 不会以任何方式修改消息 Header 头。

若先前没有 EHLO or HELO 命令此会话，此方法将尝试 ESMTP EHLO 首先。若服务器执行 ESMTP，将把消息大小和每个指定选项传递给它 (若选项在服务器公布的特征集中)。若 EHLO 失败， HELO 将尝试并抑制 ESMTP 选项。

此方法将正常返回若至少一收件人接受邮件。否则会引发异常。也就是说，若此方法不引发异常，那么有人应该收到邮件。若此方法未引发异常，返回对于每个被拒绝的收件人是一条目的字典。每一条目包含元组 (SMTP 错误码，由服务器发送伴随的错误消息)。

此方法可能引发下列异常：

SMTPRecipientsRefused

SMTPHeloError

服务器没有正确回复 HELO 问候。

SMTPSenderRefused

服务器不接受 from_addr .

SMTPDataError

服务器回复的意外错误代码 (除收件人拒绝外)。

除非另有说明，连接会被打开即使引发异常。

SMTP. quit ( ) ¶

终止 SMTP 会话并关闭连接。返回的结果源于 SMTP QUIT 命令。

2.6 版改变： Return a value.

低级方法对应标准 SMTP/ESMTP 命令 HELP , RSET , NOOP , MAIL , RCPT ，和 DATA 也支持。通常不需要直接调用这些，所以这里未文档化它们。有关细节，请翻阅模块代码。

20.12.2. SMTP 范例 ¶

此范例提示用户输入消息信封所需的地址(To 和 From 地址) 和要交付的消息。注意，要包括在消息中的 Header 头还必须包括在键入消息中；此范例不做任何处理对于 RFC 822 头。尤其，To 和 From 地址必须明确包括在消息头中。

import smtplib
def prompt(prompt):
    return raw_input(prompt).strip()
fromaddr = prompt("From: ")
toaddrs  = prompt("To: ").split()
print "Enter message, end with ^D (Unix) or ^Z (Windows):"
# Add the From: and To: headers at the start!
msg = ("From: %s\r\nTo: %s\r\n\r\n"
       % (fromaddr, ", ".join(toaddrs)))
while 1:
    try:
        line = raw_input()
    except EOFError:
        break
    if not line:
        break
    msg = msg + line
print "Message length is " + repr(len(msg))
server = smtplib.SMTP('localhost')
server.set_debuglevel(1)
server.sendmail(fromaddr, toaddrs, msg)
server.quit()

注意

一般而言，想要使用 email package’s features to construct an email message, which you can then convert to a string and send via sendmail() ；见 Email：范例 .

20.12. smtplib — SMTP (简单邮件传输协议) 客户端 ¶

20.12.1. SMTP 对象 ¶

20.12.2. SMTP 范例 ¶

内容表

上一话题

下一话题

本页

快速搜索

20.12. `smtplib` — SMTP (简单邮件传输协议) 客户端 ¶