如何在 ServBay 中使用 PHP 的 IMAP 模組

作為專為開發者打造的本地 Web 開發環境，ServBay 提供豐富功能與預先配置的軟體套件。其中，PHP 的 IMAP（Internet Message Access Protocol）模組已經預先安裝並預設啟用，讓開發者能輕鬆在 PHP 應用中進行電子郵件的收取與管理。本文將帶你瞭解如何在 ServBay 中運用 PHP 的 IMAP 模組。

IMAP 模組簡介

IMAP（Internet Message Access Protocol）是一種用於從郵件伺服器存取與管理電子郵件的標準協議。與 POP3 不同，IMAP 最大的優勢在於能讓用戶直接在伺服器上操作郵件，不需將郵件完整下載回本地裝置。這使得多裝置間同步郵件狀態（如已讀、未讀、刪除）變得十分便利。

主要特色

即時存取：IMAP 允許用戶即時連線伺服器，直接檢視郵件內容，無須完全下載所有郵件。
多裝置同步：郵件狀態與資料夾架構都儲存在伺服器上，確保多個裝置間郵件介面一致。
伺服器端管理：可直接在伺服器上組織與管理郵件，包括移動、複製、刪除郵件及資料夾。
高效搜尋：支援於伺服器端執行搜尋，快速定位所需郵件。
按需下載：可選擇只下載郵件標頭資訊或特定部分，幫助節省頻寬並提升載入速度。

ServBay 中的 IMAP 模組：預設啟用

ServBay 支援多種 PHP 版本，且對每個支援的 PHP 版本，其對應的 IMAP 模組均已預先安裝，並在 ServBay 啟動時預設為啟用。這意味著你無需額外設定即可直接使用該模組。

如何驗證 IMAP 模組是否已啟用

雖然 IMAP 模組於 ServBay 中預設啟用，但你仍可能希望檢查其狀態。以下為檢查方式：

透過 phpinfo() 函式：建立一個簡單的 PHP 檔案（如 info.php），內容如下：
php
```
<?php
phpinfo();
?>
```
1
2
3
將檔案放到網站根目錄（如 /Applications/ServBay/www/your-project/info.php），並用瀏覽器開啟（例如 http://your-project.servbay.demo/info.php）。在輸出頁面中搜尋 "imap"。若已啟用，將能看到名為 "imap" 的區塊，包含相關參數與資訊。
透過指令列：開啟終端機，切換至 ServBay 所用 PHP 執行檔路徑（通常 ServBay 會將目前 PHP 路徑加入 PATH），然後執行：
bash
```
php -m | grep imap
```
1
如果有顯示 imap ，就代表模組於指令列環境下已啟用。

在 PHP 程式中使用 IMAP

確認 IMAP 模組啟用後，你即可於 PHP 應用中直接使用 PHP 的 IMAP 函式庫來連線郵件伺服器並執行各種郵件操作。PHP 官方文件提供完整的 IMAP 函式列表與說明。建議參考 PHP Manual on IMAP 以取得更詳細資訊。

範例程式碼

以下為連線至 IMAP 伺服器並讀取郵件數量的基本範例。請將範例中的伺服器、帳號、密碼等資訊替換為你實際的郵件伺服器資訊。

php

<?php
// 連線 IMAP 伺服器
// 請將 imap.example.com 替換為實際郵件伺服器位址
// 請將 993 改為正確的連接埠（一般 SSL 為 993、非 SSL 為 143）
// 請根據需求調整 imap/ssl 等連接標記（如 {mail.yourserver.com:993/imap/ssl/novalidate-cert}INBOX）
// INBOX 是收件匣名稱，可能會依伺服器有所不同
$mailbox = '{imap.example.com:993/imap/ssl}INBOX';
// 請填入你的信箱使用者名稱
$username = 'demo@servbay.test'; // 範例帳號，請自行更換
// 請填入你的信箱密碼
$password = 'your_password'; // 範例密碼，請自行更換

// 嘗試連線 IMAP 伺服器
// imap_open 最後一個參數通常提供連線選項，如 OP_HALFOPEN、OP_READONLY 等
$imap = imap_open($mailbox, $username, $password);

if (!$imap) {
    // 連線失敗，輸出錯誤資訊
    die("IMAP 連線失敗: " . imap_last_error());
}

echo "IMAP 連線成功。\n";

// 取得郵件數量
$numMessages = imap_num_msg($imap);
echo "INBOX 郵件總數: $numMessages\n";

// 讀取最新一封郵件（若存在）
if ($numMessages > 0) {
    $emailNumber = $numMessages; // 最新郵件通常編號最大

    // 取得郵件標頭
    $header = imap_headerinfo($imap, $emailNumber);
    // 取得郵件內容
    // imap_body 取得純文字內容，imap_fetchbody 可取得指定部份（如 HTML 或附件）
    $body = imap_body($imap, $emailNumber);

    echo "\n--- 最新郵件詳情 ---\n";
    echo "主旨: " . ($header->subject ?? '無主旨') . "\n"; // 使用 ?? 處理可能不存在的主旨
    echo "寄件者: " . ($header->fromaddress ?? '未知寄件者') . "\n";
    echo "日期: " . ($header->date ?? '未知日期') . "\n";
    echo "內容（前 200 字）：\n" . substr($body, 0, 200) . "...\n"; // 僅顯示部份內容
} else {
    echo "收件匣目前無郵件。\n";
}

// 關閉 IMAP 連線
imap_close($imap);
echo "IMAP 連線已關閉。\n";

?>

重要提醒:

執行本範例需能存取外部 IMAP 伺服器，請確認 ServBay（或執行 PHP 的主機）能連上目標伺服器，且未受防火牆拒絕。
連線參數（伺服器位址、連接埠、協定標記）須完全符合你的郵件服務商規範。
實際處理郵件內容（尤其是本文及附件）情況可能更為複雜，視郵件 MIME 類型與結構而定。請參閱 PHP 官方手冊內 imap_fetchstructure、imap_fetchbody 等相關函式說明。

小結

ServBay 經由預裝並預設啟用 PHP IMAP 模組，大幅簡化了開發者在本地構建含郵件功能應用時的安裝與設定流程。無需繁瑣設定，只需確認模組啟用，即可運用 PHP 功能強大的 IMAP 函式庫與外部郵件伺服器互動，實現郵件收發、管理與進階運用功能。這也使 ServBay 成為開發具郵件處理需求 Web 應用的理想本地開發環境。

如何在 ServBay 中使用 PHP 的 IMAP 模組 ​

IMAP 模組簡介 ​

主要特色 ​

ServBay 中的 IMAP 模組：預設啟用 ​

如何驗證 IMAP 模組是否已啟用 ​

在 PHP 程式中使用 IMAP ​

範例程式碼 ​

小結 ​