قد يرسل متجر WordPress رسالة تأكيد الطلب مرتين عندما تعمل إضافتان على الحالة نفسها، أو عندما تعيد مهمة مجدولة المحاولة بعد انتهاء مهلة الاتصال. التكرار يربك العميل ويجعل الرسائل اللاحقة أقل موثوقية. الحل يبدأ بتسجيل «نية إرسال» واحدة لكل طلب وقالب، ثم حفظ النتيجة بدل استدعاء البريد مباشرة من كل خطاف.
توضح وثائق WordPress للدالة wp_mail أن القيمة true تعني أن طريقة الإرسال عالجت الطلب بلا خطأ، ولا تثبت أن المستلم تلقى الرسالة. وتشرح وثائق Shopify لمبدأ idempotency أن إعادة الطلب بالمفتاح نفسه تمنع تكرار التنفيذ في الواجهات التي تدعم ذلك. لا يضيف هذا المصدر ميزة إلى WordPress تلقائيًا؛ بل يوضح المبدأ الذي يمكن تطبيقه في سجل رسائل المتجر.
لماذا تتكرر رسائل الطلب في WordPress؟
قد يرتبط أكثر من مكوّن بحدث «تم إنشاء الطلب»: القالب، إضافة المتجر، إضافة SMTP، وتكامل خارجي. وقد ينتقل الطلب بين حالتين ثم يعود، فتعمل القاعدة مرة أخرى. وفي المهام الخلفية قد ينتهي الاتصال بعد تسليم الرسالة إلى خادم البريد، لكن قبل تسجيل النجاح، فتُعاد المهمة وترسل نسخة ثانية.
التكرار الحقيقي يختلف عن إرسال رسالتين بوظيفتين مختلفتين. تأكيد الطلب وإشعار الشحن رسالتان مستقلتان، أما نسختان من تأكيد الطلب لنفس القالب والحالة فهما واقعة واحدة يجب أن تحمل مفتاحًا واحدًا.
كيف تصمم مفتاحًا يمنع رسائل الطلب المكررة؟
كوّن مفتاحًا من العناصر التي تحدد القصد: رقم الطلب، نوع الرسالة، حالة الطلب، وإصدار القالب. مثال داخلي: order:481:confirmation:v2. لا تضع البريد أو الهاتف داخل المفتاح. خزّن المفتاح في جدول مستقل أو بيانات الطلب مع حالة مثل queued أو sending أو accepted أو failed أو uncertain.
قبل إنشاء مهمة، حاول حجز المفتاح بقيد فريد في قاعدة البيانات. إذا كان موجودًا في حالة نهائية، لا تنشئ مهمة جديدة. إذا كان sending أو uncertain، راجع سجل المزود قبل القرار. أما إذا كانت الرسالة الجديدة مقصودة، مثل قالب شحن، فاستخدم نوعًا أو إصدارًا مختلفًا.
خطوات تنفيذ طابور إرسال آمن
- التقط حدث الطلب مرة واحدة وحوّله إلى سجل رسالة، بدل استدعاء
wp_mailداخل كل خطاف. - أنشئ مفتاح الرسالة واحجزه بمعاملة أو قيد فريد يمنع عاملين من إنشاء السجل نفسه.
- احفظ المستلم والقالب واللغة ومعرف الطلب في حقول منفصلة، مع تجنب تخزين محتوى حساس في السجلات العامة.
- غيّر الحالة من
queuedإلىsendingبقفل قصير، ثم نفذ الإرسال مرة واحدة. - إذا أعادت
wp_mailخطأ، احفظ الخطأ الفعلي. وإذا أعادت نجاحًا، اعتبره قبولًا للمعالجة لا إثبات تسليم. - عند انقطاع الاتصال أو غياب رد المزود، احفظ
uncertainولا تعاود فورًا؛ افحص سجل SMTP أو معرف الرسالة أولًا. - اسمح بإعادة يدوية مدروسة تحت المفتاح نفسه، وسجل من بدأها وسببها.
لتهيئة عنوان مرسل ودومين مناسبين يمكن الرجوع إلى خدمة إعداد البريد الإلكتروني الرسمي. وللتأكد من المصادقة ومراقبة المصادر، اقرأ المقال المكمل كيف تقرأ تقارير DMARC التجميعية RUA؟.
مثال افتراضي
مثال افتراضي: ينتقل طلب رقم 481 إلى حالة «قيد المعالجة»، فتلتقط إضافتان الحدث. تحاول كل منهما إنشاء السجل order:481:confirmation:v2. ينجح الإدخال الأول ويرفض القيد الفريد الثاني، لذلك توجد مهمة واحدة فقط. يرسل العامل الرسالة ويعيد wp_mail قيمة ناجحة، فيحفظ النظام الحالة accepted مع الوقت.
في حالة أخرى ينتهي اتصال SMTP بعد تسليم الرسالة ولا يصل الرد للتطبيق. يحفظ العامل uncertain. لا يولّد سجلًا جديدًا، بل يراجع سجل مزود البريد أو معرف الرسالة. إذا ثبت القبول يغلق المهمة، وإذا ثبت الفشل يعيد المحاولة تحت السجل نفسه.
ما الذي لا تثبته wp_mail؟
نجاح wp_mail لا يثبت وصول الرسالة إلى صندوق الوارد، ولا يثبت أنها لم تُصنف كرسالة مزعجة. هو يؤكد أن طبقة الإرسال لم تبلغ عن خطأ أثناء معالجة الطلب. تحتاج متابعة التسليم إلى مزود SMTP يعيد إيصالات أو أحداث تسليم وارتداد، مع حفظها وربطها بالرسالة.
استخدم خطاف wp_mail_failed لتسجيل أخطاء PHPMailer، ويمكن استخدام أحداث النجاح للتشخيص، لكن لا تعرض بيانات المستلمين أو ترويسات حساسة في سجلات عامة. ضع مدة احتفاظ محددة بالسجلات واسمح بالوصول للمخولين فقط.
كيف تفرّق بين إعادة صحيحة ورسالة جديدة؟
إذا تغيّر الغرض، فهذه رسالة جديدة: إشعار شحن بعد التأكيد، أو إعادة فاتورة بطلب صريح من العميل. أما تحديث صفحة الإدارة أو إعادة تشغيل المهمة بسبب مهلة فلا ينشئ قصدًا جديدًا. اجعل واجهة المسؤول تعرض آخر حالة الرسالة وزر إعادة واضحًا، بدل تشغيل خطاف الطلب من جديد.
عند تعديل القالب، لا تجعل إصدار القالب وحده يعيد إرسال جميع الرسائل القديمة. استخدم الإصدار في المفتاح فقط عندما تكون الرسالة الجديدة مطلوبة لسبب تشغيلي موثق.
قائمة مراجعة طابور البريد
- هل لكل طلب ونوع رسالة مفتاح فريد؟
- هل يمنع قيد قاعدة البيانات إنشاء مهمتين متوازيتين؟
- هل تفصل بين
failedوuncertain؟ - هل تعتبر نجاح
wp_mailقبولًا لا تسليمًا؟ - هل تحفظ إيصال SMTP الحقيقي عند توفره؟
- هل إعادة المحاولة تستخدم السجل نفسه؟
- هل الرسائل المختلفة تملك أنواعًا واضحة؟
- هل السجلات محمية ولا تكشف بيانات العملاء؟
- هل توجد إعادة يدوية بسبب مسجل؟
منع التكرار ليس فلترًا بعد الإرسال؛ هو قرار قبل إنشاء المهمة. عندما يثبت النظام أن لكل واقعة بريدية سجلًا واحدًا وحالة قابلة للتتبع، يمكن معالجة الانقطاع من دون إغراق العميل بنسخ متطابقة.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك