Devenia IMAP Intake

اربط صندوق بريد IMAP بإضافتك في ووردبريس

اقرأ الرسائل والمرفقات من صندوق IMAP موجود عبر واجهة PHP. تحدد إضافتك موعد القراءة وكيفية استخدام النتيجة.

الإصدار 1.0.1 · GPL-2.0-or-later

رسم بأسلوب آرت ديكو لمستقبِل بريد مع أظرف ومرفق.

صندوق واحد وتسليم واضح

تزوّد إضافتك المستقبِل بالخادم والمنفذ والمجلد وبيانات الدخول. يفتح Devenia IMAP Intake المجلد للقراءة فقط عبر اتصال TLS متحقق منه، ويعيد ترويسات الرسائل وعناوين المرسلين والبايتات المفكوكة للمرفقات. تبقى الرسالة الأصلية في المجلد وتُحفظ حالة قراءتها.

تحدد إضافتك وقت الاتصال، وهي المسؤولة عن التحكم في الوصول وإعادة المحاولة ومنع التكرار والتخزين. كما تحدد الحد الأقصى لحجم الرسالة كاملة عند كل عملية جلب.

اقرأ الرسالة، ودع إضافتك تكمل العمل.

تبقى الرسالة في صندوق البريد. يقرأها المستقبِل ويفك ترميز مرفقاتها؛ وتطبق إضافتك قواعدها وتحدد ما يحدث بعد ذلك.

يرسل صندوق IMAP الرسائل إلى إضافة ووردبريس عبر Devenia IMAP Intake.

يربط المستقبِل صندوق البريد بشيفرتك، لكنه لا يقرر كيفية معالجة الرسالة.

مثال: معالجة صندوق بريد مشترك

تخيّل إضافة ووردبريس تعالج الرسائل المرسلة إلى [email protected]. يربطها المطوّر بصندوق IMAP الموجود ويحدد الحجم الأقصى للرسالة. يعيد المستقبِل الرسائل والمرفقات؛ وتتحقق الإضافة المستدعية مما عولج بالفعل وتقرر طريقة تخزين كل عنصر أو معالجته.

هذا مثال توضيحي. المستقبِل واجهة قراءة للمطورين؛ ليس بريد ويب ولا يرسل البريد عبر SMTP.

استخدم معرّفات الرسائل في سياقها الصحيح

تعرّف قيم UID الرسائل داخل حساب ومجلد وقيمة UIDVALIDITY محددة فقط. قارن قيمة UIDVALIDITY الحالية بالقيمة المحفوظة قبل إعادة استخدام مؤشر المتابعة.

UIDVALIDITY

تحدد سلسلة UID الحالية للمجلد المحدد.

UID

يحدد رسالة داخل الحساب والمجلد وسلسلة UID المعنية.

المتطلبات والتوافر

تحتاج إلى ووردبريس 6.9 أو أحدث، وPHP 8.1 أو أحدث مع OpenSSL وmbstring، وشهادات جهات إصدار موثوقة، وخادم IMAP بشهادة TLS صالحة. يدعم الاتصال TLS الضمني أو STARTTLS.

نزّل ملف ZIP أعلاه واختبر التكامل على نسخة تجريبية قبل استخدامه مع صندوق بريد فعلي.

في ووردبريس افتح الإضافات ← أضف إضافة جديدة ← رفع إضافة، واختر ملف ZIP وثبّت Devenia IMAP Intake وفعّله. استدعِ الواجهة من إضافتك بعد تحميل الإضافات النشطة. احتفظ ببيانات دخول الصندوق في إعدادات تطبيقك المحمية.

افتح مجلدًا واقرأ رسالة

يستخدم هذا المثال نطاقًا محجوزًا. وفّر $password من إعدادات محمية و$saved_uid_validity من تطبيقك. عند الاستخدام الأول، حدد UIDVALIDITY للمجلد قبل حفظ مؤشر المتابعة. تطبق fetch() حد البايتات على الرسالة كاملة قبل فك الترميز.

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', 'تحقق من مؤشر المتابعة المحفوظ قبل المتابعة.' );
    }

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

توفّر الواجهة Mailbox::open() وuid_validity() وuids() وfetch() وclose(). تتضمن الرسالة المجلوبة الترويسات وعناوين المرسلين والمرفقات مع بايتاتها بعد فك الترميز.

في بيئة الإنتاج، عالج الأخطاء واختر UID باستخدام مؤشر المتابعة الخاص بك وتحقق من المرسلين وفق سياستك. سجّل اكتمال المعالجة فقط بعد نجاح الخطوات اللاحقة. افتح جلسة جديدة بعد فشل قراءة IMAP.

إذا فشل الاتصال، فتحقق من اسم الخادم والمنفذ ووضع TLS وبيانات الدخول وسلسلة الشهادات الموثوقة. وإذا تجاوزت رسالة حد البايتات، فحدد كيف يجب أن يعالجها تطبيقك قبل إعادة المحاولة.

اقرأ الرسائل باستخدام إضافة ووردبريس الخاصة بك

نزّل الإضافة، وتحقق من المتطلبات، واختبر الاتصال مع تطبيقك.

رسم بأسلوب آرت ديكو لمستقبِل بريد مع أظرف ومرفق.