Devenia IMAP Intake

Kết nối hộp thư IMAP với plugin WordPress

Đọc thư và tệp đính kèm từ hộp thư IMAP hiện có qua giao diện PHP. Plugin của bạn quyết định khi nào đọc và xử lý kết quả ra sao.

Phiên bản 1.0.1 · GPL-2.0-or-later

Minh họa Art Deco về bộ nhận thư với phong bì và tệp đính kèm.

Một hộp thư, phân định rõ trách nhiệm

Plugin của bạn cung cấp máy chủ, cổng, thư mục và thông tin đăng nhập. Devenia IMAP Intake mở thư mục ở chế độ chỉ đọc qua kết nối TLS được xác minh, rồi trả về phần đầu thư, địa chỉ người gửi và byte đã giải mã của tệp đính kèm. Thư gốc vẫn nằm trong thư mục và trạng thái đã đọc được giữ nguyên.

Plugin của bạn quyết định thời điểm kết nối và chịu trách nhiệm kiểm soát truy cập, thử lại, loại bỏ trùng lặp và lưu trữ. Plugin cũng đặt giới hạn kích thước cho toàn bộ thư ở mỗi lần lấy.

Đọc thư. Plugin của bạn xử lý phần còn lại.

Thư vẫn nằm trong hộp thư. Bộ tiếp nhận đọc thư và giải mã tệp đính kèm; plugin của bạn áp dụng quy tắc riêng và quyết định bước tiếp theo.

Hộp thư IMAP chuyển thư qua Devenia IMAP Intake tới plugin WordPress.

Bộ tiếp nhận kết nối hộp thư với mã của bạn; nó không quyết định cách xử lý thư.

Ví dụ: xử lý hộp thư dùng chung

Hãy hình dung một plugin WordPress xử lý thư gửi đến [email protected]. Nhà phát triển kết nối plugin với hộp thư IMAP hiện có và đặt kích thước thư tối đa. Bộ tiếp nhận trả về thư và tệp đính kèm; plugin gọi nó kiểm tra nội dung đã xử lý và quyết định cách lưu hoặc xử lý từng mục.

Đây là ví dụ minh họa. Bộ tiếp nhận là giao diện đọc dành cho nhà phát triển; nó không phải webmail và không gửi thư qua SMTP.

Dùng mã thư đúng ngữ cảnh

UID chỉ xác định thư trong một tài khoản, thư mục và giá trị UIDVALIDITY cụ thể. Hãy so sánh UIDVALIDITY hiện tại với giá trị đã lưu trước khi dùng lại con trỏ.

UIDVALIDITY

Xác định chuỗi UID hiện tại của thư mục đã chọn.

UID

Xác định một thư trong tài khoản, thư mục và chuỗi UID đó.

Yêu cầu và tải xuống

Bạn cần WordPress 6.9 trở lên, PHP 8.1 trở lên có OpenSSL và mbstring, các chứng chỉ CA đáng tin cậy và máy chủ IMAP có chứng chỉ TLS hợp lệ. Kết nối hỗ trợ TLS ngầm định hoặc STARTTLS.

Tải ZIP ở trên và kiểm tra tích hợp trên bản sao thử nghiệm trước khi dùng với hộp thư đang hoạt động.

Trong WordPress, mở Plugin → Cài mới → Tải plugin lên, chọn ZIP, cài đặt và kích hoạt Devenia IMAP Intake. Gọi giao diện từ plugin của bạn sau khi các plugin đang hoạt động đã được tải. Lưu thông tin đăng nhập hộp thư trong cấu hình được bảo vệ của ứng dụng.

Mở thư mục và đọc một thư

Ví dụ này dùng tên miền dành riêng. Cung cấp $password từ cấu hình được bảo vệ và $saved_uid_validity từ ứng dụng của bạn. Trong lần đầu sử dụng, xác định UIDVALIDITY của thư mục trước khi lưu con trỏ. fetch() áp dụng giới hạn byte cho toàn bộ thư trước khi giải mã.

use Devenia\ImapIntake\Mailbox;

$mailbox = Mailbox::open( array(
    'host'       => 'imap.example.com',
    'port'       => 993,
    'username'   => '[email protected]',
    'password'   => $password,
    'folder'     => 'INBOX',
    'encryption' => 'ssl',
    'timeout'    => 15,
) );

if ( is_wp_error( $mailbox ) ) {
    return $mailbox;
}

try {
    $validity = $mailbox->uid_validity();
    $uids = $mailbox->uids();
    if ( is_wp_error( $uids ) ) {
        return $uids;
    }

    if ( $validity !== $saved_uid_validity ) {
        return new WP_Error( 'mailbox_changed', 'Kiểm tra con trỏ đã lưu trước khi tiếp tục.' );
    }

    if ( $uids ) {
        $message = $mailbox->fetch( $uids[0], wp_max_upload_size() );
        if ( is_wp_error( $message ) ) {
            return $message;
        }
    }
} finally {
    $mailbox->close();
}

Giao diện cung cấp Mailbox::open(), uid_validity(), uids(), fetch() và close(). Thư được lấy gồm phần đầu, địa chỉ người gửi và tệp đính kèm cùng các byte đã giải mã.

Trong quy trình thực tế, hãy xử lý lỗi, chọn UID bằng con trỏ của bạn và xác minh người gửi theo chính sách của bạn. Chỉ ghi nhận hoàn tất sau khi các bước xử lý tiếp theo thành công. Mở phiên mới sau khi đọc IMAP thất bại.

Nếu kết nối thất bại, hãy kiểm tra tên máy chủ, cổng, chế độ TLS, thông tin đăng nhập và chuỗi chứng chỉ đáng tin cậy. Nếu thư vượt giới hạn byte, hãy quyết định cách ứng dụng xử lý trước khi thử lại.

Đọc thư bằng plugin WordPress của bạn

Tải plugin, kiểm tra yêu cầu và thử kết nối với ứng dụng của bạn.

Minh họa Art Deco về bộ nhận thư với phong bì và tệp đính kèm.