PHPMailer सुविधाओं का विस्तार

शुभ दोपहर
संभवतः हर कोई जिसे SMTP के माध्यम से PHP कोड से मेल भेजना था, PHPMailer वर्ग से परिचित है।
इस लेख में मैं बात करूंगा कि आप नेटवर्क इंटरफ़ेस के आईपी पते को स्वीकार करने के लिए PHPMailer को कैसे सिखा सकते हैं जिससे हम एक अतिरिक्त पैरामीटर के रूप में भेजना चाहते हैं। स्वाभाविक रूप से, यह सुविधा केवल कई सफेद आईपी पते वाले सर्वर पर उपयोगी होगी। और एक छोटे से जोड़ के रूप में, हम PHPMailer कोड से एक बल्कि अप्रिय बग को पकड़ लेंगे।

PHPMailer वास्तुकला अवलोकन

PHPMailer पैकेज में समान नाम (PHPMailer वर्ग) और कई प्लग-इन वर्ग होते हैं, जो POP3 पूर्व प्रमाणीकरण सहित SMTP के माध्यम से मेल भेजने की क्षमता को लागू करते हैं।

PHPMailer का दृश्य संदेश पैरामीटर (लोकलहोस्ट, रिटर्न-पाथ, AddAdress (), बॉडी, इत्यादि) सेट करने की विधि और प्रमाणीकरण विधि (SMTPSecure, SMTPAuth, IsMail (), IsSendMail (), IsSMTP ( ), आदि), साथ ही भेजें () विधि।

पत्र के मापदंडों को निर्धारित करने और भेजने की विधि को निर्दिष्ट करने के लिए (यह निम्नलिखित में से चुनना संभव है: मेल, सेंडमेल, ईमेल या एसएमएस), आपको PHPMailer Send () वर्ग विधि को कॉल करना होगा, जो बदले में, मेल भेजने के लिए जिम्मेदार आंतरिक विधि को कॉल को एक तरह से या किसी अन्य तरीके से प्रतिनिधियों को सौंपता है। । चूँकि हम SMTP में रुचि रखते हैं, तो हम मुख्य रूप से class.smtp.php फ़ाइल से SMTP प्लगइन पर विचार करेंगे।

PHPMailer :: IsSMTP () विधि का उपयोग करते समय, PHPMailer :: Send () विधि संरक्षित PHPMailer :: SmtpSend ($ शीर्ष लेख, $ शरीर) विधि को कॉल करेगा, इसे उत्पन्न हेडर और संदेश निकाय को पास करना।

PHPMailer :: SmtpSend () विधि प्राप्तकर्ता के दूरस्थ SMTP सर्वर से कनेक्ट करने का प्रयास करेगी (यदि यह PHPMailer ऑब्जेक्ट द्वारा भेजा गया पहला संदेश नहीं है, तो सबसे अधिक संभावना है कि कनेक्शन पहले ही स्थापित हो चुका है और यह चरण छोड़ दिया जाएगा) और इसके साथ एक मानक SMTP सत्र आरंभ करें (HELLO /) ईएचएलओ, मेल टू, आरसीपीटी, डेटा, आदि)।

SMTP सर्वर का कनेक्शन सार्वजनिक विधि PHPMailer :: SmtpConnect () में होता है। चूंकि एक ही समय में एक डोमेन के लिए अलग-अलग प्राथमिकताओं के साथ कई एमएक्स रिकॉर्ड हो सकते हैं, PHPMailer :: SmtpConnect () विधि PHPMailer के अनुक्रम में कॉन्फ़िगरेशन के दौरान निर्दिष्ट प्रत्येक SMTP सर्वर से कनेक्ट करने का प्रयास करेगी।

कोड में बग

अब, PHPMailer :: SmtpConnect () कोड पर करीब से नज़र डालें:

/** * Initiates a connection to an SMTP server. * Returns false if the operation failed. * @uses SMTP * @access public * @return bool */ public function SmtpConnect() { if(is_null($this->smtp)) { $this->smtp = new SMTP(); } $this->smtp->do_debug = $this->SMTPDebug; $hosts = explode(';', $this->Host); $index = 0; $connection = $this->smtp->Connected(); // Retry while there is no connection try { while($index < count($hosts) && !$connection) { $hostinfo = array(); if (preg_match('/^(.+):([0-9]+)$/', $hosts[$index], $hostinfo)) { $host = $hostinfo[1]; $port = $hostinfo[2]; } else { $host = $hosts[$index]; $port = $this->Port; } $tls = ($this->SMTPSecure == 'tls'); $ssl = ($this->SMTPSecure == 'ssl'); if ($this->smtp->Connect(($ssl ? 'ssl://':'').$host, $port, $this->Timeout)) { $hello = ($this->Helo != '' ? $this->Helo : $this->ServerHostname()); $this->smtp->Hello($hello); if ($tls) { if (!$this->smtp->StartTLS()) { throw new phpmailerException($this->Lang('tls')); } //We must resend HELO after tls negotiation $this->smtp->Hello($hello); } $connection = true; if ($this->SMTPAuth) { if (!$this->smtp->Authenticate($this->Username, $this->Password)) { throw new phpmailerException($this->Lang('authenticate')); } } } $index++; if (!$connection) { throw new phpmailerException($this->Lang('connect_host')); } } } catch (phpmailerException $e) { $this->smtp->Reset(); if ($this->exceptions) { throw $e; } } return true; } 

कोड $ में यह-> smtp SMTP प्लगइन क्लास का एक ऑब्जेक्ट है।

हम यह पता लगाने की कोशिश करेंगे कि लेखकों के दिमाग में क्या था। सबसे पहले, हम जाँचते हैं कि क्या कोई आंतरिक वस्तु बनाई गई है जो SMTP के साथ काम कर सकती है और इसे बना सकती है यदि यह PHPMailer वर्ग के ऑब्जेक्ट की SmtpConnect () विधि की पहली कॉल है (वास्तव में, PHPMailer :: Close) (विधि) $ को चालू कर सकती है-> smtp में नल)।

तब PHPMailer :: होस्ट फ़ील्ड को सीमांकक द्वारा विभाजित किया जाता है ';' और परिणाम प्राप्तकर्ता डोमेन के लिए MX रिकॉर्ड की एक सरणी है। यदि होस्ट में केवल एक प्रविष्टि थी (उदाहरण के लिए, 'smtp.yandex.ru'), तो सरणी में केवल एक ही तत्व होगा।

अगला, यह देखने के लिए एक चेक बनाया गया है कि क्या हम पहले से ही प्राप्तकर्ता सर्वर से जुड़े हैं। यदि यह SmtpConnect () के लिए पहली कॉल है, तो यह स्पष्ट है कि $ कनेक्शन गलत होगा।

तो हम सबसे दिलचस्प हो गए। प्रत्येक एमएक्स रिकॉर्ड पर एक चक्र शुरू होता है, जिसमें प्रत्येक पुनरावृत्ति में अगले एमएक्स से कनेक्ट करने का प्रयास किया जाता है। लेकिन क्या होगा यदि हम अपने सिर में इस चक्र के एल्गोरिथ्म को निष्पादित करते हैं, यह कल्पना करते हुए कि पहले एमएक्स रिकॉर्ड के लिए अगर ($ यह-> smtp-> कनेक्ट (($ ssl? 'Ssl: //': '') $ Host, $ पोर्ट, $ यह-> टाइमआउट)) गलत लौटा? यह पता चला है कि चक्र एक अपवाद को फेंक देगा जो चक्र के बाद पहले से ही पकड़ा जाएगा। यानी उपलब्धता के लिए अन्य सभी एमएक्स रिकॉर्ड की जांच नहीं की जाएगी और हम अपवाद को पकड़ लेंगे।

लेकिन यह सबसे अप्रिय नहीं है। PHPMailer दो मोड में काम कर सकता है - अपवाद फेंकना, या ErrorInfo क्षेत्र में एक त्रुटि संदेश लिखने के साथ चुपचाप मर जाना। इसलिए साइलेंट मोड का उपयोग करने के मामले में ($ यह-> अपवाद == गलत है, और यह डिफ़ॉल्ट मोड है) SmtpConnect () सही लौटेगा!

सामान्य तौर पर, इस बग ने मुझे कुछ समय लिया, डेवलपर्स को इसके बारे में सूचित किया जाता है। मैंने इसे 5.2.1 संस्करण में देखा था, लेकिन पुराने संस्करण उसी तरह व्यवहार करते हैं।

आगे बढ़ने से पहले, मैं अपना त्वरित सुधार प्रस्तुत करूँगा। डेवलपर्स से आधिकारिक रिलीज तक मैं उसके साथ रहता हूं। एक महीने के लिए अब उड़ान सामान्य है।

 public function SmtpConnect() { if(is_null($this->smtp)) { $this->smtp = new SMTP(); } $this->smtp->do_debug = $this->SMTPDebug; $hosts = explode(';', $this->Host); $index = 0; $connection = $this->smtp->Connected(); // Retry while there is no connection try { while($index < count($hosts) && !$connection) { $hostinfo = array(); if (preg_match('/^(.+):([0-9]+)$/', $hosts[$index], $hostinfo)) { $host = $hostinfo[1]; $port = $hostinfo[2]; } else { $host = $hosts[$index]; $port = $this->Port; } $tls = ($this->SMTPSecure == 'tls'); $ssl = ($this->SMTPSecure == 'ssl'); $bRetVal = $this->smtp->Connect(($ssl ? 'ssl://':'').$host, $port, $this->Timeout); if ($bRetVal) { $hello = ($this->Helo != '' ? $this->Helo : $this->ServerHostname()); $this->smtp->Hello($hello); if ($tls) { if (!$this->smtp->StartTLS()) { throw new phpmailerException($this->Lang('tls')); } //We must resend HELO after tls negotiation $this->smtp->Hello($hello); } if ($this->SMTPAuth) { if (!$this->smtp->Authenticate($this->Username, $this->Password)) { throw new phpmailerException($this->Lang('authenticate')); } } $connection = true; break; } $index++; } if (!$connection) { throw new phpmailerException($this->Lang('connect_host')); } } catch (phpmailerException $e) { $this->SetError($e->getMessage()); if ($this->smtp->Connected()) $this->smtp->Reset(); if ($this->exceptions) { throw $e; } return false; } return true; } 

कई नेटवर्क इंटरफेस के साथ काम करने के लिए PHPMailer का विस्तार करें

PHPMailer का SMTP प्लगइन नेटवर्क के साथ fsockopen, fputs और fgets के माध्यम से काम करता है। अगर हमारी मशीन पर कई नेटवर्क इंटरफेस हैं जो इंटरनेट को देखते हैं, तो फॉक्सकॉपेन किसी भी मामले में पहले कनेक्शन पर सॉकेट बनाएगा। हमें किसी भी पर बनाने में सक्षम होना चाहिए।

मन में आया पहला विचार क्लासिक सॉकेट्स सॉकेट_क्रिएट, सॉकेट_बिन, सॉकेट_कनेक्ट के मानक गुच्छा का उपयोग करना था, जो सॉकेट_बिंड में आपको अपने आईपी पते के साथ सॉकेट को जोड़ने के लिए कौन सा नेटवर्क इंटरफ़ेस निर्दिष्ट करने की अनुमति देता है। जैसा कि यह निकला, विचार पूरी तरह से सफल नहीं है। नतीजतन, मुझे लगभग पूरे PHPMailer SMTP प्लगइन को फिर से लिखना पड़ा, इसमें सॉकेट_ड्रेड और सॉकेट_राइट के साथ फ़्यूज़ और फ़ेट्स की जगह ले ली, क्योंकि सॉकेट_क्रिएट से निर्मित संसाधन के साथ फ़्यूज़ और फ़्यूज़ काम नहीं कर सकते। अर्जित किया, लेकिन आत्मा तलछट बनी रही।

निम्नलिखित सोच अधिक सफल रही। एक stream_socket_client फ़ंक्शन है जो एक स्ट्रीम सॉकेट बनाता है जिसे फ़िज़ेट्स द्वारा सुरक्षित रूप से पढ़ा जा सकता है! परिणामस्वरूप, SMTP प्लगइन में सिर्फ एक विधि की जगह, आप नेटवर्क इंटरफ़ेस के एक स्पष्ट संकेत के साथ मेल भेजने के लिए PHPMailer सिखा सकते हैं, और साथ ही व्यावहारिक रूप से डेवलपर्स कोड को स्पर्श न करें।

हमारा प्लगइन निम्नानुसार है:

 require_once 'class.smtp.php'; class SMTPX extends SMTP { public function __construct() { parent::__construct(); } public function Connect($host, $port = 0, $tval = 30, $local_ip) { // set the error val to null so there is no confusion $this->error = null; // make sure we are __not__ connected if($this->connected()) { // already connected, generate error $this->error = array("error" => "Already connected to a server"); return false; } if(empty($port)) { $port = $this->SMTP_PORT; } $opts = array( 'socket' => array( 'bindto' => "$local_ip:0", ), ); // create the context... $context = stream_context_create($opts); // connect to the smtp server $this->smtp_conn = @stream_socket_client($host.':'.$port, $errno, $errstr, $tval, // give up after ? secs STREAM_CLIENT_CONNECT, $context); // verify we connected properly if(empty($this->smtp_conn)) { $this->error = array("error" => "Failed to connect to server", "errno" => $errno, "errstr" => $errstr); if($this->do_debug >= 1) { echo "SMTP -> ERROR: " . $this->error["error"] . ": $errstr ($errno)" . $this->CRLF . '<br />'; } return false; } // SMTP server can take longer to respond, give longer timeout for first read // Windows does not have support for this timeout function if(substr(PHP_OS, 0, 3) != "WIN") socket_set_timeout($this->smtp_conn, $tval, 0); // get any announcement $announce = $this->get_lines(); if($this->do_debug >= 2) { echo "SMTP -> FROM SERVER:" . $announce . $this->CRLF . '<br />'; } return true; } } 

वास्तव में, कनेक्ट () विधि का कार्यान्वयन भी न्यूनतम रूप से बदल गया है। केवल तार जो सीधे सॉकेट बनाते हैं, उन्हें बदल दिया जाता है, और एक अन्य पैरामीटर हस्ताक्षर में जोड़ा जाता है - नेटवर्क इंटरफ़ेस का आईपी पता।

इस प्लगइन का उपयोग करने के लिए, आपको निम्नानुसार PHPMailer वर्ग का विस्तार करने की आवश्यकता है:

 require_once 'class.phpmailer.php'; class MultipleInterfaceMailer extends PHPMailer { /** * IP   ,    *    SMTP-. *      SMTPX. * @var string */ public $Ip = ''; public function __construct($exceptions = false) { parent::__construct($exceptions); } /** *      SMTPX. * @param string $ip IP       . */ public function IsSMTPX($ip = '') { if ('' !== $ip) $this->Ip = $ip; $this->Mailer = 'smtpx'; } protected function PostSend() { if ('smtpx' == $this->Mailer) { $this->SmtpSend($this->MIMEHeader, $this->MIMEBody); return; } parent::PostSend(); } /** *  ,       * IP    . * @param string $header The message headers * @param string $body The message body * @uses SMTP * @access protected * @return bool */ protected function SmtpSend($header, $body) { require_once $this->PluginDir . 'class.smtpx.php'; $bad_rcpt = array(); if(!$this->SmtpConnect()) { throw new phpmailerException($this->Lang('connect_host'), self::STOP_CRITICAL); } $smtp_from = ($this->Sender == '') ? $this->From : $this->Sender; if(!$this->smtp->Mail($smtp_from)) { throw new phpmailerException($this->Lang('from_failed') . $smtp_from, self::STOP_CRITICAL); } // Attempt to send attach all recipients foreach($this->to as $to) { if (!$this->smtp->Recipient($to[0])) { $bad_rcpt[] = $to[0]; // implement call back function if it exists $isSent = 0; $this->doCallback($isSent, $to[0], '', '', $this->Subject, $body); } else { // implement call back function if it exists $isSent = 1; $this->doCallback($isSent, $to[0], '', '', $this->Subject, $body); } } foreach($this->cc as $cc) { if (!$this->smtp->Recipient($cc[0])) { $bad_rcpt[] = $cc[0]; // implement call back function if it exists $isSent = 0; $this->doCallback($isSent, '', $cc[0], '', $this->Subject, $body); } else { // implement call back function if it exists $isSent = 1; $this->doCallback($isSent, '', $cc[0], '', $this->Subject, $body); } } foreach($this->bcc as $bcc) { if (!$this->smtp->Recipient($bcc[0])) { $bad_rcpt[] = $bcc[0]; // implement call back function if it exists $isSent = 0; $this->doCallback($isSent, '', '', $bcc[0], $this->Subject, $body); } else { // implement call back function if it exists $isSent = 1; $this->doCallback($isSent, '', '', $bcc[0], $this->Subject, $body); } } if (count($bad_rcpt) > 0 ) { //Create error message for any bad addresses $badaddresses = implode(', ', $bad_rcpt); throw new phpmailerException($this->Lang('recipients_failed') . $badaddresses); } if(!$this->smtp->Data($header . $body)) { throw new phpmailerException($this->Lang('data_not_accepted'), self::STOP_CRITICAL); } if($this->SMTPKeepAlive == true) { $this->smtp->Reset(); } return true; } /** *  ,   PHPMailer  *    SMTPX. * @uses SMTP * @access public * @return bool */ public function SmtpConnect() { if(is_null($this->smtp) || !($this->smtp instanceof SMTPX)) { $this->smtp = new SMTPX(); } $this->smtp->do_debug = $this->SMTPDebug; $hosts = explode(';', $this->Host); $index = 0; $connection = $this->smtp->Connected(); // Retry while there is no connection try { while($index < count($hosts) && !$connection) { $hostinfo = array(); if (preg_match('/^(.+):([0-9]+)$/', $hosts[$index], $hostinfo)) { $host = $hostinfo[1]; $port = $hostinfo[2]; } else { $host = $hosts[$index]; $port = $this->Port; } $tls = ($this->SMTPSecure == 'tls'); $ssl = ($this->SMTPSecure == 'ssl'); $bRetVal = $this->smtp->Connect(($ssl ? 'ssl://':'').$host, $port, $this->Timeout, $this->Ip); if ($bRetVal) { $hello = ($this->Helo != '' ? $this->Helo : $this->ServerHostname()); $this->smtp->Hello($hello); if ($tls) { if (!$this->smtp->StartTLS()) { throw new phpmailerException($this->Lang('tls')); } //We must resend HELO after tls negotiation $this->smtp->Hello($hello); } if ($this->SMTPAuth) { if (!$this->smtp->Authenticate($this->Username, $this->Password)) { throw new phpmailerException($this->Lang('authenticate')); } } $connection = true; break; } $index++; } if (!$connection) { throw new phpmailerException($this->Lang('connect_host')); } } catch (phpmailerException $e) { $this->SetError($e->getMessage()); if ($this->smtp->Connected()) $this->smtp->Reset(); if ($this->exceptions) { throw $e; } return false; } return true; } } 

एक नया सार्वजनिक आईपी फ़ील्ड मल्टीपल इन्टरफेसमेलर क्लास में जोड़ा गया है, जिसे नेटवर्क इंटरफ़ेस के आईपी पते के एक स्ट्रिंग प्रतिनिधित्व द्वारा सेट किया जाना चाहिए, जिसमें से हम मेल भेजना चाहते हैं। इसके अलावा, IsSMTPX () पद्धति को जोड़ा गया है, यह दर्शाता है कि नए प्लगइन का उपयोग करके पत्र भेजे जाने चाहिए। SMTPX प्लगइन का उपयोग करने के लिए PostSend (), SmtpSend (), और SmtpConnect () विधियों को भी फिर से तैयार किया गया है। इसी समय, मल्टीपलइन्टरफेसर क्लास की वस्तुओं को मौजूदा क्लाइंट कोड के साथ सुरक्षित रूप से उपयोग किया जा सकता है, जो उदाहरण के लिए, सेंडमेल या मूल एसएमटीपी प्लगइन के माध्यम से मेल भेजता है, क्योंकि न तो उपयोग प्रक्रिया और न ही क्लास इंटरफ़ेस बदल गया है।

निम्नलिखित नए वर्ग का उपयोग करने का एक छोटा सा उदाहरण है:

 function getSmtpHostsByDomain($sRcptDomain) { if (getmxrr($sRcptDomain, $aMxRecords, $aMxWeights)) { if (count($aMxRecords) > 0) { for ($i = 0; $i < count($aMxRecords); ++$i) { $mxs[$aMxRecords[$i]] = $aMxWeights[$i]; } asort($mxs); $aSortedMxRecords = array_keys($mxs); $sResult = ''; foreach ($aSortedMxRecords as $r) { $sResult .= $r . ';'; } return $sResult; } } // getmxrr    ,   DNS, //,  RFC 2821,      , //   $sRcptDomain      // 0. return $sRcptDomain; } require 'MultipleInterfaceMailer.php'; $mailer = new MultipleInterfaceMailer(true); $mailer->IsSMTPX('192.168.1.1'); //   IP    //$mailer->IsSMTP();      $mailer->Host = getSmtpHostsByDomain('email.net'); $mailer->Body = 'blah-blah'; $mailer->From ='no-replay@yourdomain.net'; $mailer->AddAddress('sucreface@email.net'); $mailer->Send(); 

निष्कर्ष

संक्षेप में:

1. PHPMailer में एक बग फिक्स्ड, जिसके कारण SmtpConnect () SMTP सर्वर से कनेक्ट करने के असफल प्रयास के मामले में भी हमेशा सही लौटा।
2. SmtpConnect () ने पहले सफल प्रयास से पहले सभी एमएक्स रिकॉर्ड को ईमानदारी से जांचना शुरू कर दिया।
3. एक नया प्लगइन लिखा गया है, जिसके साथ आप एसएमटीपी के माध्यम से मेल भेज सकते हैं जो स्पष्ट रूप से यह दर्शाता है कि उपयोग करने के लिए भेजने वाले सर्वर का कौन सा नेटवर्क इंटरफ़ेस।
4. नए SMTPX प्लगइन का उपयोग करने के लिए पुराने क्लाइंट कोड के लिए PHPMailer दर्द रहित रूप से विस्तारित है।

अपने प्रयासों में शुभकामनाएँ, दोस्तों!