7 days of WordPress plugins, themes & templates - for free!* Unlimited asset downloads! Start 7-Day Free Trial
Advertisement
  1. Code
  2. PHP

كيف ترسل الرسائل اﻹلكترونية في Laravel

Scroll to top
Read Time: 8 mins

Arabic (العربية/عربي) translation by Mohammed Taher (you can also view the original English article)

سنتعرّف في هذا المقال على الواجهة البرمجية الخاصة بالرسائل اﻹلكترونية والتي يقدّمها إطار الويب Laravel. يستفيد Laravel من مكتبة SwiftMailer الشهيرة، والتي تمتاز بالسهولة والبساطة إلى جانب دعم العديد من محرّكات الرسائل اﻹلكترونية. سنتطرّق في الجزء اﻷخير من هذا المقال وعلى نحو مفصّل إلى المفاهيم التي سنعرضها في الجزء اﻷول منه.

تهيئة المتطلبات

يستخدم إطار Laravel غلافًا للمكتبة SwiftMailer يُساعد في تسهيل إدارة وضبط واستخدام البريد الإلكتروني. ويمكن الوصول إلى إعدادات البريد اﻻفتراضية في الملف config/mail.php.

يدعم Laravel العديد من محركات إرسال الرسائل اﻹلكترونية، وكما هو واضح فإنّ المحرّك الافتراضي MAIL_DRIVER يأخذ القيمة smtp.

إن كنت ترغب في استخدام محرك smtp ﻹرسال الرسائل اﻹلكترونية فيجب عليك حينئذ أن تضبط بعض اﻹعدادات المرتبطة بهذا المحرك مثل MAIL_HOST و MAIL_PORT و MAIL_ENCRYPTION و MAIL_USERNAME و MAIL_PASSWORD.

من جانب آخر، إن كنت ترغب في استخدام محرّك sendmail فعليك أن تحرص على إدخال القيمة الصحيحة لمسار النظام الخاص بالمحرّك sendmail في ملف config/mail.php.

يمكنك أيضًا أن تعين قيمة عنوان المرسِل from والذي سيُستخدم أثناء عملية إرسال الرسائل اﻹلكترونية تحت المفتاح from. وأخيرًا، إن كنت ترغب في استخدام صيغة مارك داون لكتابة الرسائل اﻹلكترونية، فيمكن ضبط اﻹعدادات في المفتاح markdown.

إضافة إلى كل ما سبق، يمكنك استخدام مزوّد خدمة خارجي مثل Mailgun، و Mandrill و SES و SparkPost. إن كنت ترغب في استخدام إحدى هذه الموّدات فيجب عليك إضافة اﻹعدادات الخاصّة بها ضمن الملف config/services.php.

كانت هذه مقدّمة مختصرة عن الإعدادات الخاصّة بالواجهة البرمجية لإرسال الرسائل اﻹلكترونية في Laravel. سنعرض في القسم التالي من المقال وما بعده مثالًا نبيّن فيه طريقة إرسال الرسائل الإلكترونية.

إنشاء صنف Mailable

سننشئ في هذا الجزء صنف mailable والذي سنستخدمه ﻹرسال الرسائل اﻹلكترونية. هذا الصنف مسؤول عن إرسال الرسائل اﻹلكترونية بواسطة المحرّك المعيّن في الملف config/mail.php. وفي الواقع، يقدّم Laravel أمرًا ضمن الأداة artisan يساعد في إنشاء القالب الأساسي.

يؤدي تنفيذ اﻷمر السابق إلى إنشاء قالب بريد إلكتروني فارغ في المسار app/Mail/DemoEmail.php وكما هو موضّح في الشيفرة التالية:

لنستبدل محتويات هذا الملف بالشيفرة التالية:

هناك تابعان مهمّان جدًّا في هذا الصنف، وهما ‎__construct و build. يستخدم التابع ‎__construct في استبداء initialize الكائنات التي ترغب في استخدامها في قالب البريد اﻹلكتروني.  أما التابع build فيستخدم لاستبداء بعض القيم الخاصّة بالبريد اﻹلكتروني مثل from، view template، attachments وما شابهها.

وفي حالتنا هذه، مرّرنا الكائن ‎$demo كمعامل بانٍ، وأسندناه إلى الخاصّية العامة demo.

وقمنا كذلك باستبداء إحدى الإعدادات الخاصّة بالبريد اﻹلكتروني في التابع build.

  • يُستخدم التابع form لتعيين عنوان بريد اﻹلكتروني الخاص بالمرسِل.
  • يمكن تعيين القالب المستخدم في الرسالة اﻹلكترونية المرسلة بواسطة التابع view، وفي حالتنا هذه استخدمنا القيمة mails.demo وهذا يعني أنّه يجب علينا إنشاء ملف قالب عرض في المسار resources/views/mails/demo.blade.php.
  • يستخدم التابع text لتهيئة النسخة النصية الصرفة من قالب الرسالة اﻹلكترونية.
  • وكما ذكرنا مسبقًا، فإنّ مهمّة التابع ‎__construct هي تهيئة الكائنات التي سنستخدمها في قالب الرسالة اﻹلكترونية، ويمكن الاستفادة من التابع with كذلك لتعيين بيانات العرض ضمن الرسالة اﻹلكترونية.
  • استخدمنا بعد ذلك التابع attach لإرفاق صورة بالرسالة اﻹلكترونية.

سنحتاج بالطبع إلى قالب رسالة إلكترونية لغرض لاستخدامه في إرسال الرسالة. لذا أنشئ الملف resources/views/mails/demo.blade.php كما هو موضّح في الشيفرة التالية.

لننشئ كذلك النسخة النصية الصرفة وذلك بإنشاء الملف resources/views/mails/demo_plain.blade.php.

هكذا نكون قد أنهينا تهيئة صنف mailable ولكنّنا لم ننتهِ بعد، إذ نحتاج إلى استخدام الواجهة Mail لإرسال الرسائل اﻹلكترونية. سنتعرّف في القسم التالي على واجهة Mail وسنتعرّف على طريق إرسال الرسائل اﻹلكترونية باستخدام صنف mailable الذي يحمل الاسم DemoEmail والذي أنشأناه في هذه القسم.

جمع اﻷجزاء بعضها ببعض

سننشئ في هذا القسم مثالًا نوضّح من خلاله كيفية استخدام الصنف Mailable الذي أنشأناه في القسم السابق.

لننشئ في البداية ملف المتحكّم app/Http/Controllers/MailController.php والذي يتضمّن المحتوى التالي.

من الضروري الانتباه إلى أنّنا ضممنا الواجهة Illuminate\Support\Facades\Mail إلى هذا الملف وهي الواجهة التي سنستخدمها ﻹرسال الرسالة اﻹلكترونية. العبارة التالية في التابع send هي المسؤولة عن إرسال الرسالة الإلكترونية عن طريق استبداء الصنف App\Mail\DemoEmail أوّلًا.

يعيد التابع to في الواجهة Illuminate\Support\Facades\Mail نسخة من الصنف Illuminate\Mail\PendingMail والتي تتضمّن محرّك إرسال الرسائل المناسب والذي جرى إعداده ضمن الملف config/mail.php.

وفي النهاية استخدمنا التابع send في الصنف Illuminate\Mail\PendingMail لإرسال الرسالة اﻹلكترونية.

ولاختبار شيفرتنا، سنضيف مسارًا إلى ملف routes/web.php.

يمكنك الآن التوجّه إلى العنوان http://your-laravel-site.com/mail/send للتأكد من أن كل شيء يعمل بصورة جيدة.

إن كنت ترغب في اختبار قوالب البريد اﻹلكتروني الخاصة بك بصورة سريعة، دون إرسال رسائل إلكترونية حقيقية، فإنّ Laravel يقدّم طريقة تسمح بتسجيل جميع الرسائل المرسلة.

وللقيام بذلك سنحتاج إلى ضبط قيمة Mail_DRIVER إلى log ضمن ملف config/mail.php. ويمكنك بعد ذلك التوجّه إلى الرابط السابق ثم تفحّص السجلات للتأكد من أنّه قد تمّ بالفعل تسجيل قالب الرسالة اﻹلكترونية.

إن جرى كل شيء على ما يرام، سترى رسالة إلكترونية مسجّلة في ملف السجل storage/logs/laravel.log.

وهكذا نكون قد تطرّقنا إلى كل ما يهمّنا بخصوص إرسال الرسائل اﻹلكترونية في Laravel، وبهذا نكون قد أنهينا المقال أيضًا.

ختامًا

تعرّفنا في هذا المقال على الواجهة البرمجية الداخلية الخاصّة بإرسال الرسائل اﻹلكترونية في إطار الويب Laravel والذي يدعم مجموعة واسعة من محرّكات اﻹرسال أيضًا.

تعرّفنا في البداية إلى بعض المفاهيم الأساسية، ثم استخدمنا صنف mailable والذي يعدّ العنصر اﻷساسي في الواجهة البرمجية الخاصة بإرسال الرسائل اﻹلكترونية في Laravel. وفي النهاية، أجرينا اختبارًا لصنف mailable وذلك بإنشاء متحكّم خاص يساعدنا على مشاهدة طريقة عمل هذا الصنف.

إن كنت تخطو خطواتك اﻷولى في Laravel أو كنت ترغب في زيادة معلوماتك، أو تحسين تطبيقك أو موقعك اﻹلكتروني، فهناك الكثير من المواد والملحقات التي يمكنك الاستفادة منها في سوق Envato.

يسعدني الاطلاع على آرائكم واﻹجابة عن أسئلتكم في التعليقات.

Advertisement
Did you find this post useful?
Want a weekly email summary?
Subscribe below and we’ll send you a weekly email summary of all new Code tutorials. Never miss out on learning about the next big thing.
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.