شروع کار با PHP-Mail

روش پیشنهادی برای نصب SDK PHP‑Mail استفاده از 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 (Content-ID) مشخص کنید. مثال زیر نشان می‌دهد که چگونه توسعه‌دهندگان نرم‌افزار می‌توانند یک فایل و همچنین یک تصویر درون‌خطی را به پیام‌های ایمیل در برنامه‌های 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() استفاده کنند که امکان کنترل بیشتر بر تحویل ایمیل را فراهم می‌آورد. این کتابخانه همچنین مکانیزم‌های بهبود یافتهٔ مدیریت خطا را برای مقابله با استثناهایی که ممکن است در طول عملیات ارسال ایمیل رخ دهند، ارائه می‌دهد. مثال زیر نشان می‌دهد چگونه می‌توان با استفاده از API 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');