البدء مع PHP-Mail

الطريقة الموصى بها لتثبيت PHP-Mail SDK هي عبر Composer، يرجى استخدام الأمر التالي للتثبيت السهل.

 composer require nette/mail

إرسال رسائل بريد إلكتروني HTML ونص عادي عبر PHP

تسهل مكتبة PHP-Mail مفتوحة المصدر على مطوري البرمجيات إنشاء وإرسال رسائل البريد الإلكتروني بتنسيق HTML وكذلك النص العادي داخل تطبيقات PHP. إنشاء رسائل البريد الإلكتروني أمر سهل مع مكتبة PHP Mail. يمكنك تعيين المرسل، المستلم، الموضوع، ومحتوى البريد الإلكتروني بأقل قدر من الشيفرة. تدعم المكتبة بالكامل محتوى البريد الإلكتروني بنسق HTML والنص العادي، مما يتيح لمطوري البرمجيات إنشاء رسائل جذابة بصريًا مع ضمان التوافق مع العملاء الذين يفضلون النص العادي. يظهر المثال التالي مدى سهولة إرسال مطوري البرمجيات بريد إلكتروني بسيط باستخدام PHP.

use Nette\Mail\Message;
use Nette\Mail\SendmailMailer;

$message = new Message();
$message->setFrom('sender@example.com')
        ->addTo('recipient@example.com')
        ->setSubject('Hello Nette Mail!')
        ->setBody('This is a test email sent using Nette Mail.');

$mailer = new SendmailMailer();
$mailer->send($message);

إضافة مرفقات إلى رسائل البريد عبر API PHP

إرسال الملفات كمرفقات مع رسائل البريد الإلكتروني هو مطلب شائع، وتُسهل مكتبة Nette Mail المفتوحة المصدر ذلك بشكل كبير. توفر المكتبة طريقة مريحة لإرفاق الملفات بالبريد الإلكتروني، مما يعزز قدرات التواصل في تطبيقك. يمكن للمطورين إرفاق الملفات من نظام الملفات المحلي أو تقديم محتوى الملف مباشرة. يجعل تضمين الصور داخل محتوى البريد الإلكتروني أمرًا سهلاً بفضل Nette Mail. يمكنك تحديد الصور المضمنة باستخدام مراجع CID (معرف المحتوى). يوضح المثال التالي كيف يمكن للمطورين إرفاق ملف وكذلك صورة مدمجة في رسائل البريد الإلكتروني داخل تطبيقات PHP.

// Attach a file via PHP


$message->addAttachment('/path/to/file.pdf');
$message->addAttachment('report.docx', file_get_contents('/path/to/report.docx'));

// Attach Inline image

$message->setHtmlBody('
مرحبًا
');
$message->addEmbeddedImage('/path/to/image.jpg', 'image_cid', 'image.jpg');

رؤوس مخصصة ومعالجة أخطاء أفضل

تلعب رؤوس البريد المخصصة دورًا حاسمًا في التواصل عبر البريد الإلكتروني لأنها تسمح للمطورين بإضافة بيانات وصفية إضافية أو التحكم في رسائلهم. يمكن لمطوري البرمجيات إضافة رؤوس مخصصة إلى رسائل البريد الإلكتروني باستخدام مكتبة PHP-Mail المفتوحة المصدر. يمكن للمطورين استخدام طريقة addHeader()، مما يتيح تحكمًا إضافيًا في تسليم البريد الإلكتروني. كما توفر المكتبة آليات معالجة أخطاء محسنة للتعامل مع الاستثناءات التي قد تحدث أثناء عمليات إرسال البريد الإلكتروني. يوضح المثال التالي كيفية إضافة رؤوس مخصصة في رسائل البريد الإلكتروني باستخدام واجهة برمجة التطبيقات PHP.

use Nette\Mail\Message;

$message = new Message();
$message->setFrom('sender@example.com')
        ->addTo('recipient@example.com')
        ->setSubject('Custom Headers Example')
        ->setBody('This is an email with custom headers.');

// Add custom headers
$message->addHeader('X-Custom-Header', 'Value');
$message->addHeader('X-Another-Header', 'Another Value');