Symfony/Mailer PHP: ईमेल भेजने की पूरी गाइड

1. यह क्या है और क्यों ज़रूरी है

Symfony/Mailer एक शक्तिशाली और लचीला कंपोनेंट है जो Symfony इकोसिस्टम का हिस्सा है। इसका उपयोग PHP एप्लिकेशन से ईमेल भेजने के लिए किया जाता है। PHP के बिल्ट-इन mail() फंक्शन के विपरीत, जिसमें हेडर और MIME टाइप्स को मैन्युअली सेट करना पड़ता है, Symfony/Mailer एक ऑब्जेक्ट-ओरिएंटेड API प्रदान करता है। इससे आप विभिन्न ट्रांसपोर्ट (SMTP, Sendmail, थर्ड-पार्टी API) के ज़रिए मैसेज बना सकते हैं, फॉर्मेट कर सकते हैं और भेज सकते हैं।

इस लाइब्रेरी का मुख्य उद्देश्य ईमेल भेजने की प्रक्रिया को सरल बनाना है, ताकि डेवलपर लो-लेवल प्रोटोकॉल की बजाय ईमेल की सामग्री पर ध्यान केंद्रित कर सके। Symfony/Mailer HTML टेम्पलेट्स, अटैचमेंट्स, इमेज एम्बेडिंग, DKIM सिग्नेचर और लोकप्रिय ईमेल सेवाओं के साथ Mailer DSN (Data Source Name) के ज़रिए इंटीग्रेशन को सपोर्ट करता है।

यह लाइब्रेरी उन प्रोजेक्ट्स के लिए ज़रूरी है जहाँ ट्रांजेक्शनल ईमेल (रजिस्ट्रेशन कन्फर्मेशन, पासवर्ड रीसेट, नोटिफिकेशन), मार्केटिंग ईमेल या कोई अन्य ईमेल नोटिफिकेशन भेजने की ज़रूरत होती है। अपनी मॉड्यूलर आर्किटेक्चर की वजह से Symfony/Mailer को आसानी से टेस्ट किया जा सकता है (MockTransport के ज़रिए) और स्केल किया जा सकता है।

2. इंस्टॉलेशन

इंस्टॉलेशन Composer के ज़रिए किया जाता है, जो PHP का स्टैंडर्ड पैकेज मैनेजर है। अपने प्रोजेक्ट की रूट डायरेक्टरी में टर्मिनल में यह कमांड चलाएँ:

composer require symfony/mailer

अगर आप Symfony Flex (अनुशंसित) का उपयोग कर रहे हैं, तो इंस्टॉलेशन के बाद अपने आप config/packages/mailer.yaml कॉन्फिगरेशन फ़ाइल बन जाएगी। लोकप्रिय ईमेल सेवाओं (SendGrid, Mailgun, Amazon SES आदि) के साथ काम करने के लिए संबंधित एडॉप्टर इंस्टॉल करें, उदाहरण के लिए:

composer require symfony/sendgrid-mailer
composer require symfony/mailgun-mailer
composer require symfony/amazon-mailer

API ट्रांसपोर्ट के साथ काम करने के लिए symfony/http-client कंपोनेंट की भी ज़रूरत होगी:

composer require symfony/http-client

3. त्वरित शुरुआत — न्यूनतम कार्यशील उदाहरण

लाइब्रेरी इंस्टॉल करने के बाद आप कुछ ही लाइनों में पहला ईमेल भेज सकते हैं। send_email.php फ़ाइल बनाएँ:

<?php
// send_email.php
require_once 'vendor/autoload.php';

use Symfony\Component\Mailer\Mailer;
use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
use Symfony\Component\Mime\Email;

// 1. ट्रांसपोर्ट बनाएँ (Gmail SMTP सर्वर)
$transport = new EsmtpTransport('smtp.gmail.com', 587, true);
$transport->setUsername('your-email@gmail.com');
$transport->setPassword('your-app-password'); // ऐप पासवर्ड का उपयोग करें

// 2. Mailer बनाएँ
$mailer = new Mailer($transport);

// 3. ईमेल बनाएँ
$email = (new Email())
    ->from('your-email@gmail.com')
    ->to('recipient@example.com')
    ->subject('Symfony Mailer से नमस्ते!')
    ->text('यह Symfony/Mailer के साथ भेजा गया एक टेस्ट ईमेल है।')
    ->html('
नमस्ते!
यह ईमेल का HTML वर्जन है।
');

// 4. भेजें
try {
    $mailer->send($email);
    echo "ईमेल सफलतापूर्वक भेजा गया!\n";
} catch (\Exception $e) {
    echo "त्रुटि: " . $e->getMessage() . "\n";
}

स्क्रिप्ट चलाएँ:

php send_email.php

अगर सब कुछ सही से कॉन्फ़िगर किया गया है, तो आपको दिए गए पते पर ईमेल प्राप्त होगा।

4. मुख्य तरीके/क्लासेस

4.1. Email::class — ईमेल बनाने के लिए क्लास

सिग्नेचर: new Email() (बिना पैरामीटर का कंस्ट्रक्टर)

यह क्या करता है: ईमेल का ऑब्जेक्ट बनाता है जिसमें सभी एट्रीब्यूट्स (भेजने वाला, प्राप्तकर्ता, विषय, ईमेल का बॉडी, अटैचमेंट आदि) सेट करने के लिए सेटर मेथड्स होते हैं।

उदाहरण:

use Symfony\Component\Mime\Email;

$email = (new Email())
    ->from('sender@example.com')
    ->to('receiver@example.com')
    ->cc('cc@example.com')
    ->bcc('bcc@example.com')
    ->subject('यह एक टेस्ट ईमेल है')
    ->text('यह सादा टेक्स्ट है')
    ->html('
यह HTML कंटेंट है
');