البدء مع SimpleMail

الطريقة الموصى بها لتثبيت SimpleMail هي باستخدام GitHub. يرجى استخدام الأمر التالي لتثبيت سلس.

git clone https://github.com/cutelyst/simple-mail.git

إنشاء بريد إلكتروني HTML عبر واجهة برمجة تطبيقات C++

تدعم مكتبة SimpleMail المفتوحة المصدر إرسال رسائل البريد بنص عادي وHTML، مما يتيح تنسيقًا غنيًا. يمكنك تحديد جسم HTML للحصول على رسائل جذابة بصريًا مع توفير بديل نص عادي لعملاء البريد الذين لا يدعمون HTML أو للمستخدمين الذين يفضلون ذلك. تجعل المكتبة من السهل إرسال رسائل منسقة مع صور أو أنماط مخصصة، لأنها تسمح بمحتوى HTML في رسالتك. يوضح المقتطف التالي كيف يمكن للمطورين إرسال بريد HTML مع صور مضمَّنة.

#include 

int main() {
    SimpleMail::Mailer mailer("smtp.gmail.com", 587);
    mailer.setUsername("your-email@gmail.com");
    mailer.setPassword("your-password");

    SimpleMail::Mail mail;
    mail.setSender("your-email@gmail.com");
    mail.addTo("recipient@example.com");
    mail.setSubject("HTML Email with Image");

    // HTML content with an embedded image
    mail.setBody(
        "
Welcome!
"
        "
This is an HTML email with an inline image:
"
        "",
        SimpleMail::Mail::BodyType::Html
    );

    // Attach an image and reference it in HTML using CID
    mail.addAttachment("logo.png", "logo", "image/png");

    if (mailer.sendMail(mail)) {
        std::cout << "HTML email sent successfully!" << std::endl;
    } else {
        std::cerr << "Error: " << mailer.lastError() << std::endl;
    }

    return 0;
}

دعم SMTP مع المصادقة

توفر مكتبة SimpleMail المفتوحة المصدر دعمًا كاملاً لمصادقة SMTP داخل تطبيقات C++. تدعم المكتبة طريقتي المصادقة العادية وlogin. يضمن ذلك التوافق مع معظم خوادم SMTP، بما فيها Gmail، Outlook، والخوادم المخصصة. إليك مقتطفًا مفيدًا يوضح كيف يمكن لمطوري C++ تكوين إعدادات SMTP بسهولة، بما في ذلك STARTTLS عبر المنفذ 587.

SimpleMail::Sender sender;
sender.setHost("smtp.example.com");
sender.setPort(587);
sender.setConnectionType(SimpleMail::Sender::TlsConnection);
sender.setUser("your-email@example.com");
sender.setPassword("your-password");

إرسال رسائل بريد مع مرفقات عبر C++

إضافة مرفقات إلى رسائل البريد أمر شائع، وتتعامل SimpleMail مع ذلك بسلاسة. تجعل المكتبة من السهل إنشاء رسائل جديدة وإرفاق ملفات بهذه الرسائل ببضع أسطر فقط. تتولى المكتبة تشفير المرفق وتحديد نوع MIME المناسب. يمكن للمطورين تحديد مسار الملف وإعطاء اسم مخصص للمرفق إذا رغبوا. يوضح المثال التالي كيف يمكن للمطورين إرسال بريد مع مرفقات ملفات عبر واجهة برمجة تطبيقات C++.

#include 

int main() {
    SimpleMail::Mailer mailer("smtp.example.com", 465);
    mailer.setUsername("user@example.com");
    mailer.setPassword("password");
    mailer.setSsl(true); // Enable SSL for secure connection

    SimpleMail::Mail mail;
    mail.setSender("user@example.com");
    mail.addTo("client@example.com");
    mail.setSubject("Invoice Attached");
    mail.setBody("Please find the attached invoice.");

    // Attach a PDF file
    mail.addAttachment("/path/to/invoice.pdf", "invoice.pdf", "application/pdf");

    if (mailer.sendMail(mail)) {
        std::cout << "Email with attachment sent!" << std::endl;
    } else {
        std::cerr << "Error: " << mailer.lastError() << std::endl;
    }

    return 0;
}

أمان أفضل مع دعم SSL/TLS

الأمان أمر أساسي عند التعامل مع البريد. تدعم مكتبة SimpleMail الاتصالات الآمنة إلى خوادم SMTP باستخدام SSL (Secure Sockets Layer) وTLS (Transport Layer Security). عند تكوين SmtpServer، يمكنك تحديد ConnectionType كـ Ssl أو Tls لضمان تشفير التواصل مع خادم البريد. يحمي ذلك محتوى البريد وبيانات المصادقة من الاعتراض.