函式名:imap_create()
適用版本:PHP 4, PHP 5, PHP 7
函式說明:imap_create() 函式用於在指定的郵箱中建立一個新的郵件資料夾。
語法:bool imap_create ( resource $imap_stream , string $mailbox )
引數:
- $imap_stream:必需。一個有效的 IMAP 流。
- $mailbox:必需。要建立的郵件資料夾的名稱。
返回值:如果成功建立郵件資料夾,則返回 true,否則返回 false。
示例:
<?php
// 連線到 IMAP 伺服器
$imap_stream = imap_open("{imap.example.com:993/imap/ssl}", "username", "password");
// 建立一個名為 "新郵件夾" 的資料夾
if (imap_create($imap_stream, "新郵件夾")) {
echo "郵件資料夾建立成功!";
} else {
echo "郵件資料夾建立失敗!";
}
// 關閉 IMAP 連線
imap_close($imap_stream);
?>
注意事項:
- 在呼叫 imap_create() 函式之前,必須先透過 imap_open() 函式連線到 IMAP 伺服器。
- 郵件資料夾的名稱不應包含特殊字元或空格。
- 只有 IMAP 伺服器上的管理員或具有合適許可權的使用者才能建立郵件資料夾。