(PHP 4、PHP 5、PHP 7、PHP 8)
imap_getsubscribed — 列出所有已订阅的邮箱
imap
一个 IMAP\Connection 实例。
reference
reference
通常应该只是服务器规范,如 imap_open() 中所述。
将不可信数据传递给此参数是不安全的,除非禁用了 imap.enable_insecure_rsh。
pattern
指定在邮箱层次结构中的哪个位置开始搜索。
您可以作为 pattern
的一部分传递两个特殊字符:'*
' 和 '%
'。'*
' 表示返回所有邮箱。如果您将 pattern
作为 '*
' 传递,您将获得整个邮箱层次结构的列表。'%
' 表示仅返回当前级别。'%
' 作为 pattern
参数将仅返回顶级邮箱;'~/mail/%
' 在 UW_IMAPD
上将返回 ~/mail 目录中的每个邮箱,但不会返回该目录的子文件夹中的任何邮箱。
返回一个包含邮箱信息的数组。每个对象都具有属性 name
,指定邮箱的完整名称;delimiter
,它是此邮箱所在的层次结构部分的层次结构分隔符;以及 attributes
。 Attributes
是一个位掩码,可以与之进行测试
LATT_NOINFERIORS
- 此邮箱没有“子项”(此邮箱下方没有邮箱)。
LATT_NOSELECT
- 这只是一个容器,而不是邮箱 - 您无法打开它。
LATT_MARKED
- 此邮箱已标记。仅用于 UW-IMAPD。
LATT_UNMARKED
- 此邮箱未标记。仅用于 UW-IMAPD。
LATT_REFERRAL
- 此容器对远程邮箱有引用。
LATT_HASCHILDREN
- 此邮箱具有可选择的子项。
LATT_HASNOCHILDREN
- 此邮箱没有可选择的子项。
false
。
版本 | 描述 |
---|---|
8.1.0 | imap 参数现在期望一个 IMAP\Connection 实例;以前,期望一个有效的 imap 资源。 |