poplib — POP3 协议客户端 ¶

源代码： Lib/poplib.py

---

此模块定义类， POP3 ，封装到 POP3 服务器的连接并实现协议作为定义在 RFC 1939 。 POP3 类支持的最小和可选命令集两者来自 RFC 1939 。 POP3 类还支持 STLS 命令引入在 RFC 2595 在已建立的连接中启用加密通信。

另外，此模块还提供类 POP3_SSL ，提供连接到使用 SSL (安全套接字层) 作为底层协议层的 POP3 服务器的支持。

注意，虽然 POP3 支持广泛，但已过时。POP3 服务器的实现质量差别很大，且很多很差。若邮件服务器支持 IMAP (Internet 消息访问协议)，最好使用 imaplib.IMAP4 类，因为 IMAP 服务器趋向更好实现。

可用性 ：非 WASI。

This module does not work or is not available on WebAssembly. See WebAssembly 平台 了解更多信息。

The poplib 模块提供 2 个类：

class poplib. POP3 ( host , port=POP3_PORT [ , timeout ] ) ¶

此类实现实际 POP3 协议。 连接的创建在初始化实例时。若 port 被省略，使用标准 POP3 端口 110。可选 timeout 参数指定试图连接的超时 (以秒为单位)，若未指定，将使用全局默认超时设置。

引发 审计事件 poplib.connect 采用自变量 self , host , port .

所有命令将引发 审计事件 poplib.putline 采用自变量 self and line ，其中 line 是即将发送给远程主机的字节。

3.9 版改变： 若 timeout 参数被设为 0，它将引发 ValueError 以阻止非阻塞套接字的创建。

class poplib. POP3_SSL ( host , port = POP3_SSL_PORT , * , timeout = None , context = None ) ¶

这是子类化的 POP3 通过 SSL (安全套接字层) 加密套接字连接到服务器。若 port 未指定，使用标准 POP3-over-SSL 端口 995。 timeout 工作如在 POP3 构造函数。 context 是可选 ssl.SSLContext 对象允许捆绑 SSL 配置选项、证书及私钥成单一 (潜在长期存活) 结构。请阅读 安全注意事项 了解最佳实践。

引发 审计事件 poplib.connect 采用自变量 self , host , port .

所有命令将引发 审计事件 poplib.putline 采用自变量 self and line ，其中 line 是即将发送给远程主机的字节。

3.2 版改变： context 参数被添加。

3.4 版改变： 类现在支持主机名校验采用 ssl.SSLContext.check_hostname and SNI (服务器名称指示) (见 ssl.HAS_SNI ).

3.9 版改变： 若 timeout 参数被设为 0，它将引发 ValueError 以阻止非阻塞套接字的创建。

3.12 版改变： The deprecated keyfile and certfile parameters have been removed.