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

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

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

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

  
 return [
  
     /*
     |--------------------------------------------------------------------------
     | Mail Driver
     |--------------------------------------------------------------------------
     |
     | Laravel supports both SMTP and PHP's "mail" function as drivers for the
     | sending of e-mail. You may specify which one you're using throughout
     | your application here. By default, Laravel is setup for SMTP mail.
     |
     | Supported: "smtp", "sendmail", "mailgun", "mandrill", "ses",
     |            "sparkpost", "log", "array"
     |
     */
  
     'driver' => env('MAIL_DRIVER', 'sendmail'),
  
     /*
     |--------------------------------------------------------------------------
     | SMTP Host Address
     |--------------------------------------------------------------------------
     |
     | Here you may provide the host address of the SMTP server used by your
     | applications. A default option is provided that is compatible with
     | the Mailgun mail service which will provide reliable deliveries.
     |
     */
  
     'host' => env('MAIL_HOST', 'smtp.mailgun.org'),
  
     /*
     |--------------------------------------------------------------------------
     | SMTP Host Port
     |--------------------------------------------------------------------------
     |
     | This is the SMTP port used by your application to deliver e-mails to
     | users of the application. Like the host we have set this value to
     | stay compatible with the Mailgun e-mail application by default.
     |
     */
  
     'port' => env('MAIL_PORT', 587),
  
     /*
     |--------------------------------------------------------------------------
     | Global "From" Address
     |--------------------------------------------------------------------------
     |
     | You may wish for all e-mails sent by your application to be sent from
     | the same address. Here, you may specify a name and address that is
     | used globally for all e-mails that are sent by your application.
     |
     */
  
     'from' => [
         'address' => env('MAIL_FROM_ADDRESS', 'hello@example.com'),
         'name' => env('MAIL_FROM_NAME', 'Example'),
     ],
  
     /*
     |--------------------------------------------------------------------------
     | E-Mail Encryption Protocol
     |--------------------------------------------------------------------------
     |
     | Here you may specify the encryption protocol that should be used when
     | the application send e-mail messages. A sensible default using the
     | transport layer security protocol should provide great security.
     |
     */
  
     'encryption' => env('MAIL_ENCRYPTION', 'tls'),
  
     /*
     |--------------------------------------------------------------------------
     | SMTP Server Username
     |--------------------------------------------------------------------------
     |
     | If your SMTP server requires a username for authentication, you should
     | set it here. This will get used to authenticate with your server on
     | connection. You may also set the "password" value below this one.
     |
     */
  
     'username' => env('MAIL_USERNAME'),
  
     'password' => env('MAIL_PASSWORD'),
  
     /*
     |--------------------------------------------------------------------------
     | Sendmail System Path
     |--------------------------------------------------------------------------
     |
     | When using the "sendmail" driver to send e-mails, we will need to know
     | the path to where Sendmail lives on this server. A default path has
     | been provided here, which will work well on most of your systems.
     |
     */
  
     'sendmail' => '/usr/sbin/sendmail -bs',
  
     /*
     |--------------------------------------------------------------------------
     | Markdown Mail Settings
     |--------------------------------------------------------------------------
     |
     | If you are using Markdown based email rendering, you may configure your
     | theme and component paths here, allowing you to customize the design
     | of the emails. Or, you may simply stick with the Laravel defaults!
     |
     */
  
     'markdown' => [
         'theme' => 'default',
  
         'paths' => [
             resource_path('views/vendor/mail'),
         ],
     ],
  
 ];

يدعم 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 يساعد في إنشاء القالب الأساسي.

php artisan make:mail DemoEmail

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

  
 namespace App\Mail;
  
 use Illuminate\Bus\Queueable;
 use Illuminate\Mail\Mailable;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Contracts\Queue\ShouldQueue;
  
 class DemoEmail extends Mailable
 {
     use Queueable, SerializesModels;
  
     /**
      * Create a new message instance.
      *
      * @return void
      */
     public function __construct()
     {
         //
     }
  
     /**
      * Build the message.
      *
      * @return $this
      */
     public function build()
     {
         return $this->view('view.name');
     }
 }

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

  
 namespace App\Mail;
  
 use Illuminate\Bus\Queueable;
 use Illuminate\Mail\Mailable;
 use Illuminate\Queue\SerializesModels;
 use Illuminate\Contracts\Queue\ShouldQueue;
  
 class DemoEmail extends Mailable
 {
     use Queueable, SerializesModels;
      
     /**
      * The demo object instance.
      *
      * @var Demo
      */
     public $demo;
  
     /**
      * Create a new message instance.
      *
      * @return void
      */
     public function __construct($demo)
     {
         $this->demo = $demo;
     }
  
     /**
      * Build the message.
      *
      * @return $this
      */
     public function build()
     {
         return $this->from('sender@example.com')
                     ->view('mails.demo')
                     ->text('mails.demo_plain')
                     ->with(
                       [
                             'testVarOne' => '1',
                             'testVarTwo' => '2',
                       ])
                       ->attach(public_path('/images').'/demo.jpg', [
                               'as' => 'demo.jpg',
                               'mime' => 'image/jpeg',
                       ]);
     }
 }

هناك تابعان مهمّان جدًّا في هذا الصنف، وهما ‎__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 كما هو موضّح في الشيفرة التالية.

Hello {{ $demo->receiver }},
 This is a demo email for testing purposes! Also, it's the HTML version.
  
 Demo object values:
  
 Demo One: {{ $demo->demo_one }}
 Demo Two: {{ $demo->demo_two }}
 
 Values passed by With method:
  
 testVarOne: {{ $testVarOne }}
 testVarTwo: {{ $testVarTwo }}
 
 Thank You,
 
 {{ $demo->sender }}

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

Hello {{ $demo->receiver }},
 This is a demo email for testing purposes! Also, it's the HTML version.
  
 Demo object values:
  
 Demo One: {{ $demo->demo_one }}
 Demo Two: {{ $demo->demo_two }}
  
 Values passed by With method:
  
 testVarOne: {{ $testVarOne }}
 testVarOne: {{ $testVarOne }}
  
 Thank You,
 {{ $demo->sender }}

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

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

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

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

 namespace App\Http\Controllers;
  
 use App\Http\Controllers\Controller;
 use App\Mail\DemoEmail;
 use Illuminate\Support\Facades\Mail;
  
 class MailController extends Controller
 {
     public function send()
     {
         $objDemo = new \stdClass();
         $objDemo->demo_one = 'Demo One Value';
         $objDemo->demo_two = 'Demo Two Value';
         $objDemo->sender = 'SenderUserName';
         $objDemo->receiver = 'ReceiverUserName';
  
         Mail::to("receiver@example.com")->send(new DemoEmail($objDemo));
     }
 }

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

Mail::to("receiver@example.com")->send(new DemoEmail($objDemo));

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

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

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

// Email related routes
 Route::get('mail/send', 'MailController@send');

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

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

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

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

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

ختامًا

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

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

البريد الالكترونى

رقم الجوال

عنوان المكتب

طرق الدفع لدينا

التواصل الاجتماعى