دوشنبه ۲۴ مرداد ۱۴۰۱

Monday, August 15, 2022 GMT +4:30

ارسال ایمیل با PHP و کلاس PHPMailer

php-mail-class

ارسال ایمیل از طریق زبان های برنامه نویسی سمت سرور از جمله PHP یکی از رایج ترین مباحث کاربردی است که دیر یا زود برنامه نویسان زبان PHP یا علاقمندان استفاده از این زبان را در روند توسعه یا استفاده از امکانات مبتنی بر وب درگیر خود می کند، اگرچه مفسر PHP به طور پیش فرض توابعی برای مدیریت فرایند ارسال ایمیل در خود گنجانده است اما گستره استفاده از مبحث ارسال نامه های الکترونیکی، پیچیدگی های فنی و نیازهای کاربران به حدی است که نمی توان تنها به صرف این توابع متکی بود، از طرفی گاهی بحث ارسال ایمیل با توجه به محدودیت ها و قابلیت های سرورهای مختلف پتانسیل تبدیل شدن به مشکلات کم و بیش پیچیده را دارد و این چیزی است که بعضا فکر و ذهن بسیاری از مدیران وب را مشغول خود می کند و تبدیل به یک دغدغه می شود، به همین جهت در این آموزش قصد داریم در حد امکان به نحوه ارسال ایمیل با PHP و همچنین کلاس PHPMailer بپردازیم، PHPMailer یکی از قویترین کلاس های رایگان و متن بازی است که در خصوص ارسال ایمیل در دسترس و قابل استفاده است.

ارسال ایمیل در PHP با تابع mail


ساده ترین روش ارسال ایمیل در PHP استفاده از تابع درونی و از پیش تعریف شده mail و پروتکل SMTP (مخفف Simple Mail Transfer Protocol) بدون بررسی نام کاربری و رمز عبور (Authentication) است، در این روش کافی است تابع mail را با چند آرگیومنت فراخوانی کنیم تا ایمیل ارسال شود، به طور مثال:
<?php
//دریافت کننده ایمیل
$to = 'username <useraccount@example.com>';

//موضوع ایمیل
$subject = 'ایمیل ساده';

//متن پیام
$body = 'سلام، این ایمیل جهت تست ارسال شده است!';

//سربرگ ها
$headers = 'From: yourname <youraccount@example.com>' . "\r\n" .
    'Reply-To: yourname <youraccount@example.com>' . "\r\n" .
    'X-Mailer: PHP/' . phpversion();

//فراخوانی تابع و ارسال ایمیل
if(mail($to, $subject, $body, $headers)) {
    echo 'ایمیل شما با موفقیت ارسال شد';
} else {
    echo 'خطا در ارسال ایمیل! تنظیمات سرور شما از این امکان پشتیبانی نمی کند';
}
?>
توضیح:
- تابع mail به صورت از پیش تعریف شده در مفسر PHP وجود دارد و تنها کافی است آن را با تکمیل پارامترها فراخوانی کنیم.
- کارکرد صحیح این تابع تا حدود زیادی بستگی به تنظیمات سرور و فایل php.ini دارد، معمولا در سرورهای اشتراکی دسترسی به فایل اصلی php.ini امکان پذیر نیست بنابراین اگر نتوانیم با تابع mail ایمیل ارسال کنیم به احتمال زیاد تنظیمات این فایل به درستی انجام نشده است یا مسئول فنی هاست قابلیت ارسال ایمیل بدون اعتبارسنجی (Authentication) را محدود کرده است که در صورت نیاز باید با پشتیبانی هاست در این مورد تماس بگیریم (البته در اغلب موارد امکان ارسال ایمیل با ایجاد حساب کاربری و SMTP که در ادامه توضیح خواهیم داد وجود دارد).
- برای ارسال ایمیل با تابع mail سه پارامتر اصلی و چند پارامتر فرعی باید در نظر گرفته شود، پارامترهای اصلی آن آدرس ایمیل دریافت کننده (To)، موضوع (Subject) و متن پیام (Body) است، پارامترهای اضافی به شکل سربرگ ها قابل استفاده هستند (آدرس ایمیل ارسال کننده (From) اغلب اجباری است) که به طور مثال می توانند به صورت های زیر باشند:
<?php
$headers  = 'MIME-Version: 1.0' . "\r\n";
$headers .= 'X-Mailer: PHP' . "\r\n";
$headers .= 'From: yourname <youraccount@example.com>' . "\r\n";
$headers .= 'Reply-To: yourname <youraccount@example.com>' . "\r\n";
$headers .= 'Content-type: text/html; charset=utf-8' . "\r\n";
$headers .= 'Cc: admin@example.com' . "\r\n";
$headers .= 'Bcc: other@example.com' . "\r\n";
?>
سربرگ ها را می توانیم به شکل آرایه نیز در کد ارسال ایمیل داشته باشیم:
$headers = array(
    'From' => 'yourname <youraccount@example.com',
    'Reply-To' => 'yourname <youraccount@example.com',
    'X-Mailer' => 'PHP/' . phpversion()
);
- علامت r\n\ در کدهای بالا برای ایجاد یک خط جدید استفاده می شود، برای حفظ اثر این کدها باید در بین علامت های "" (Double Quotation) باشند نه '' (Single Quotation).
نکته 1: سربرگ From در اغلب پلتفرم های ایمیل اجباری است و در صورتی که این سربرگ تنظیم نشده باشد ممکن است خطای زیر را در PHP دریافت کنیم:
Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing.
نکته 2: عبارت MIME (مخفف Multipurpose Internet Mail Extensions) استاندارد اینترنتی برای ارسال و دریافت اطلاعات با فرمت های مختلف در بستر ایمیل است.

ارسال ایمیل به صورت HTML با تابع mail


تابع mail علاوه بر ارسال ایمیل به صورت متن ساده یا Plain Text برای ارسال محتوای فرمت بندی شده به صورت کدهای HTML نیز قابل استفاده است، بدین منظور دو کار را باید در هنگام ارسال ایمیل انجام دهیم:
1- متن پیام ما باید به صورت کدهای HTML باشد مشابه تگ های صفحات وب که به صورت HTML کدنویسی می کنیم.
2- در قسمت سربرگ ها که در بالا عنوان شد، سربرگ زیر را برای پشتیبانی از زبان فارسی (یا سایر زبان های UTF-8) به کد خود اضافه کنیم:
<?php
//دریافت کننده ایمیل
$to = 'username <useraccount@example.com>';

//موضوع ایمیل
$subject = 'ایمیل ساده';

//متن پیام
$body = '<html><body>سلام، این ایمیل جهت <b>تست</b> ارسال شده است!</html></body>';

//سربرگ ها
$headers = 'Content-type: text/html; charset=utf-8' . "\r\n";
$headers .= 'From: yourname <youraccount@example.com>' . "\r\n" .
    'Reply-To: yourname <youraccount@example.com>' . "\r\n" .
    'X-Mailer: PHP/' . phpversion();

//فراخوانی تابع و ارسال ایمیل
if(mail($to, $subject, $body, $headers)) {
    echo 'ایمیل شما با موفقیت ارسال شد';
} else {
    echo 'خطا در ارسال ایمیل! تنظیمات سرور شما از این امکان پشتیبانی نمی کند';
}
?>
البته ارسال سربرگ های اضافی همیشه هم ضروری نیست، برخی از سرویس های ایمیل به طور پیش فرض از یونیکد UTF-8 پشتیبانی می کنند، اما برای اطمینان از اینکه ایمیل ارسالی در همه پلتفرم ها خوانا و قابل استفاده باشد بهتر است سربرگ Content-type را همراه ایمیل خود ارسال کنیم.

ارسال فایل ضمیمه با تابع mail در PHP


ارسال ایمیل بدون فایل های ضمیمه (Attachment) با تابع mail در PHP کار چندان سختی نیست اما اگر بخواهیم به همین صورت فایل ها را نیز به همراه نامه الکترونیک خود ضمیمه کنیم باید چند کار دیگر انجام دهیم که در ادامه خواهیم گفت، ابتدا کد زیر را در نظر بگیریم این کد با استفاده از تابع mail در PHP علاوه بر ارسال متن ساده و متن به صورت HTML قابلیت ارسال فایل ضمیمه (Attachment) را نیز دارد:
<?php
//دریافت کننده ایمیل
$to = 'username <useraccount@example.com>';

//ارسال کننده ایمیل
$from = 'yourname <youraccount@example.com>';

//ارسال پاسخ به
$reply = 'yourname <youraccount@example.com>';

//موضوع
$subject = 'ارسال ایمیل به همراه ضمیمه';

//کد اتفاقی Boundary
$boundary = md5(time());

//خط جدید
$line = "\r\n"; //یا PHP_EOL

//فایل ضمیمه
$filename = 'phpbook.zip';

//تجزیه و آماده سازی فایل برای ارسال
$attachment = chunk_split(base64_encode($filename));

//سربرگ ها
$headers = 'From: ' . $from . $line;
$headers .= 'Reply-To: ' . $reply . $line;
$headers .= 'MIME-Version: 1.0' . $line;
$headers .= 'Content-Type: multipart/mixed; boundary="' . $boundary . '"' . $line;

//متن پیام به صورت ساده
$body = '--' . $boundary . $line;
$body .= 'Content-Type: text/plain; charset="utf-8"' . $line;
$body .= 'Content-Transfer-Encoding: 8bit' . $line . $line;
$body .= 'این یک ایمیل به همراه ضمیمه است' . $line;

//متن پیام به صورت HTML
$body .= '--' . $boundary . $line;
$body .= 'Content-Type: text/html; charset="utf-8"' . $line;
$body .= 'Content-Transfer-Encoding: 8bit' . $line . $line;
$body .= 'این یک ایمیل به همراه <b>ضمیمه</b> است' . $line;

//تنظیمات فایل ضمیمه
$body .= '--' . $boundary . $line;
$body .= 'Content-Type: application/zip; name="' . $filename . '"' . $line;
$body .= 'Content-Transfer-Encoding: base64' . $line;
$body .= 'Content-Disposition: attachment' . $line;
$body .= 'Content-Transfer-Encoding: 7bit' . $line . $line;
$body .= $attachment . $line;
$body .= '--' . $boundary . '--';

//فراخوانی تابع و ارسال ایمیل
if(mail($to, $subject, $body, $headers)) {
    echo 'ایمیل شما با موفقیت ارسال شد';
} else {
    echo 'خطا در ارسال ایمیل! تنظیمات سرور شما از این امکان پشتیبانی نمی کند';
}
?>
توضیح:
- در هنگام ارسال ایمیل به همراه فایل ضمیمه (Attachment) به سربرگی تحت عنوان Boundary (سرحد، کرانه) احتیاج داریم، در صورتی که ایمیل ارسالی چند بخشی شامل متن ساده، متن به صورت HTML و فایل ضمیمه باشد در استاندارد MIME برای تفکیک قسمت های مختلف آن از هم از عبارتی تحت عنوان Boundary استفاده می شود، نکته مهم اینکه این عبارت نباید جایی در متن ایمیل تکرار شده باشد لذا با تابع MD5 و در نظر گرفتن زمان سرور به صورت Unix یک عبارت رمزی شده (Hash) ایجاد می کنیم، شیوه ایجاد عبارت رمزی شده مهم نیست مهم این است یک رشته متنی غیرتکراری بر اساس استاندارد RFC 1341 کنسرسیوم جهانی وب (W3C) در ایمیل داشته باشیم که قسمت های مختلف را از هم جدا کند.
- نکته مهم دیگر استفاده از تابع chunk_split و base64_encode است، به این صورت فایل ما برای انتقال به قطعات کوچکتری تقسیم شده و در چارچوب استاندارد RFC 2045 سازمان استانداردسازی وب (IETF) قابل انتقال است.
- متغیر line برای ایجاد خط جدید با کاراکترهای rn در محتوای سربرگ های ایمیل ارسالی است، طبق بررسی ما در هنگام ارسال ایمیل به همراه فایل ضمیمه بهتر است تعداد خط ها دقیقا مشابه با نمونه کد بالا باشد.
- در سربرگ های اولیه مقادیر multipart/mixed را برای Content-Type در نظر گرفته ایم که این کار به دلیل ضمیمه بودن فایل به همراه ایمیل است.
- در قسمت میانی کد دو نوع محتوای مشابه به صورت plain/text و text/html تنظیم کرده ایم که جهت سازگاری با سیستم های دریافت ایمیلی است که از HTML پشتیبانی نمی کنند، در صورتی که سیستم دریافت ایمیل از HTML پشتیبانی کند حالت متن ساده نادیده گرفته می شود (در حال حاضر اغلب برنامه ها از ایمیل های HTML پشتیبانی می کنند و حالت Plain Text ضرورت چندانی ندارد).
- در قسمت مربوط به فایل ضمیمه از مقادیر application/zip برای Content-Type استفاده کرده ایم که نوع فایل phpbook.zip را در استاندارد MIME مشخص می کند، برای بدست آوردن مقادیر Content-Type فایل های مختلف کافی است آدرس دایرکتوری، نام فایل به همراه فرمت آن را در سرور یا در لوکال هاست در تابع زیر به جای متغیر فرضی file جایگزین کرده و کد را اجرا کنیم، خروجی دستورات مقادیر مناسب قسمت Content-Type متناظر با فایل تنظیم شده را نمایش می دهد:
<?php
//تابع نمایش نوع فایل
function getMIMEType($file_name){
    //لیست فرمت های پرکاربرد
    $mime_types = array(
        //files
        'txt' => 'text/plain',
        'htm' => 'text/html',
        'html' => 'text/html',
        'php' => 'text/html',
        'css' => 'text/css',
        'js' => 'application/javascript',
        'json' => 'application/json',
        'xml' => 'application/xml',
        'swf' => 'application/x-shockwave-flash',
        'flv' => 'video/x-flv',
        //images
        'png' => 'image/png',
        'jpe' => 'image/jpeg',
        'jpeg' => 'image/jpeg',
        'jpg' => 'image/jpeg',
        'gif' => 'image/gif',
        'bmp' => 'image/bmp',
        'ico' => 'image/vnd.microsoft.icon',
        'tiff' => 'image/tiff',
        'tif' => 'image/tiff',
        'svg' => 'image/svg+xml',
        'svgz' => 'image/svg+xml',
        //archives
        'zip' => 'application/zip',
        'rar' => 'application/x-rar-compressed',
        'exe' => 'application/x-msdownload',
        'msi' => 'application/x-msdownload',
        'cab' => 'application/vnd.ms-cab-compressed',
        //audio/video
        'mp3' => 'audio/mpeg',
        'qt' => 'video/quicktime',
        'mov' => 'video/quicktime',
        'mpeg' => 'video/mpeg',
        'mpe' => 'video/mpeg',
        'mpg' => 'video/mpeg',
        'wav' => 'audio/wav',
        'aiff' => 'audio/aiff',
        'aif' => 'audio/aiff',
        'avi' => 'video/msvideo',
        'wmv' => 'video/x-ms-wmv',
        //adobe
        'pdf' => 'application/pdf',
        'psd' => 'image/vnd.adobe.photoshop',
        'ai' => 'application/postscript',
        'eps' => 'application/postscript',
        'ps' => 'application/postscript',
        //ms office
        'doc' => 'application/msword',
        'docx' => 'application/msword',
        'rtf' => 'application/rtf',
        'xls' => 'application/vnd.ms-excel',
        'ppt' => 'application/vnd.ms-powerpoint',
        //open office
        'odt' => 'application/vnd.oasis.opendocument.text',
        'ods' => 'application/vnd.oasis.opendocument.spreadsheet',
        );
        
        //بررسی پسوند فایل
        $ext = strtolower(array_pop(explode('.', $file_name)));
        
        //برگردان نتیجه
        if (array_key_exists($ext, $mime_types)) {
            return $mime_types[$ext];
        }
        else {
            return 'application/octet-stream';
        }
}

//آدرس فایل شما
$file_name = 'file/phpbook.zip';

//خروجی
echo getMIMEType($file_name);
?>
این تابع اغلب فرمت های رایج را پوشش می دهد.

ارسال ایمیل با استفاده از کلاس PHPMailer


اگرچه کاربرد تابع mail در PHP بسیار ساده و آسان است اما این تابع تنها موارد اولیه را پوشش می دهد، به فرض امکان استفاده از پروتکل SMTP به صورت Authentication (بررسی اعتبار نام کاربری و کلمه عبور) وجود ندارد یا نمی توانیم سرور ارسال ایمیل را تغییر دهیم و محدودیت های دیگری از این دست، به همین دلایل برنامه نویسان و توسعه دهندگان PHP بسته ها و کلاس های دیگری برای مدیریت فرآیندهای مربوط به ارسال ایمیل نوشته اند که یکی از معروف ترین آنها کلاس PHPMailer است، علاوه بر کلاس PHPMailer بسته ایمیل PEAR نیز برای PHP وجود دارد که البته به دلیل قدرت و انعطاف پذیری کلاس PHPMailer کمتر مورد استفاده قرار می گیرد.
PHPMailer
برای شروع آموزش ارسال ایمیل با استفاده از کلاس PHPMailer ابتدا باید پکیج فایل های مرتبط با این کلاس را از لینک زیر دریافت کنیم:
https://github.com/PHPMailer/PHPMailer
در صورت مسدود بودن خدمات GitHub برای IP های ایران می توانید آخرین نسخه فعلی آن را از لینک زیر نیز دریافت کنید:
دانلود پکیج کلاس PHPMailer نسخه Stable 5.2 - حجم 211 کیلوبایت (آخرین به روزرسانی لینک در وبگو: 99/12/1)
این پکیج حاوی فایل ها و فولدرهای مختلفی است که شاید در نگاه اول کمی گیج کننده باشد، خوشبختانه برای ارسال ایمیل های متداول وجود چند فایل به شرح زیر برای اغلب موارد کفایت می کند و باقی سورس ها جنبه توسعه، سفارشی سازی، مثال یا موارد خاص دارند:
- PHPMailerAutoload.php
جهت مدیریت خودکار و افزودن فایل کلاس های مورد نیاز در هنگام ارسال ایمیل، در نسخه های جدید PHPMailer تنها include این فایل در کدهای برنامه و وجود دو فایل class.phpmailer.php و class.smtp.php در دایرکتوری پکیج اغلب نیازها را پوشش می دهد، وجود فایل PHPMailerAutoload.php در دایرکتوری پکیج الزامی نیست و می توانیم مستقیما فایل class.phpmailer.php را include کنیم.
- class.phpmailer.php
فایل اصلی کلاس PHPMailer که عمده وظایف فرایند ارسال ایمیل را بر عهده دارد، وجود این فایل در دایرکتوری پکیج الزامی است.
- class.smtp.php
کلاس تکمیلی برای فراهم سازی امکان استفاده از پروتکل SMTP جهت ارسال ایمیل، وجود این فایل در دایرکتوری پکیج برای کار با پروتکل SMTP الزامی است.
با این تفاسیر استفاده از کلاس PHPMailer ساده و آسان است، کافی است سه فایل بالا را در دایرکتوری داشته باشیم و مطابق الگوی زیر موارد مورد نیاز را با توجه به حساب ایمیلمان در سرور تنظیم کرده و کدها را اجرا کنیم:
<!DOCTYPE html>
<html lang="fa">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>وبگو | ارسال ایمیل با کلاس PHPMailer</title>
<!-- Webgoo.ir -->
</head>
<body>
<?php
//فایل بارگذاری خودکار
require_once('PHPMailerAutoload.php');

//فراخوانی کلاس
$mail = new PHPMailer(true);

//استفاده از SMTP
$mail->IsSMTP();

try {
    //آدرس سرور ایمیل
    $mail->Host = "mail.example.com";
    
    //استفاده از پروتکل های رمزنگاری
    $mail->SMTPSecure   = 'ssl';
    
    //پورت ارسال ایمیل
    $mail->Port = 465;
    
    //استفاده از SMTP Authentication
    $mail->SMTPAuth = true;
    
    //نام کاربری و کلمه عبور حساب ایمیل
    $mail->Username   = "youraccount@example.com";
    $mail->Password   = "yourpassword";
    
    //افزودن قسمت پاسخ به ایمیل
    $mail->AddReplyTo('replyaccount@example.com', 'Reply Name');
    
    //تنظیم اطلاعات گیرنده ایمیل
    $mail->AddAddress('receiveraccount@example.com', 'Receiver Name');
    
    //تنظیم اطلاعات ارسال کننده ایمیل
    $mail->SetFrom('senderaccount@example.com', 'Sender Name');
    
    //موضوع ایمیل ارسالی
    $mail->Subject = 'PHPMailer Test';
    
    //متن برای کاربرانی که به دلایل فنی نمی توانند ایمیل را به درستی مشاهده کنند
    $mail->AltBody = 'برنامه شما از این ایمیل پشتیبانی نمی کند، برای مشاهده آن لطفا از برنامه دیگری استفاده نمائید';
    
    //یونیکد برای پشتیبانی از زبان فارسی
    $mail->CharSet = 'UTF-8';
    
    //امکان استفاده از تگ های HTML
    $mail->ContentType = 'text/html';
    
    //متن پیام به صورت HTML
    $mail->MsgHTML('<html><body>این یک <font color="#CC0000">تست</font> است!</body></html>');
    
    // ضمیمه کردن فایل به ایمیل
    //$mail->AddAttachment('path/to/file/phpbook.zip');
    
    //ارسال ایمیل
    $mail->Send();
    
    //چاپ نتیجه موفقیت آمیز
    echo "پیام با موفقیت ارسال شد\n";
} catch(phpmailerException $e) {
    //پیام خطا از PHPMailer
    echo $e->errorMessage();
} catch(Exception $e) {
    //سایر خطاها
    echo $e->getMessage();
}
?>
</body>
</html>
توضیح:
- همانطور که گفتیم ارسال ایمیل با PHPMailer خیلی سخت نیست، کافی است ابتدا فایل مدیریت خودکار کلاس های مورد نیاز برنامه یعنی PHPMailerAutoload.php را (با استفاده از require یا include) در صفحه وارد کنیم، سپس موارد مورد نیاز را مطابق با اطلاعات سرور و حساب ایمیلمان تنظیم نمائیم.
- در قسمت new PHPMailer کلاس اصلی برنامه را فراخوانی می کنیم تا در ادامه به متدهای آن دسترسی داشته و نهایتا ایمیل را ارسال کنیم.
- در قسمت IsSMTP مشخص می کنیم که می خواهیم از SMTP (یا از Sendmail) برای ارسال ایمیل استفاده کنیم و برای استفاده از این امکان باید آدرس میل سرور (Host)، نام کاربری (Username) و کلمه عبور (Password) را مطابق الگو تکمیل نمائیم، این اطلاعات و امکان ایجاد حساب کاربری جدید در قسمت ایمیل برنامه های مدیریت هاست مانند cPanel یا DirectAdmin وجود دارد و اغلب توسط شرکت های ارائه دهنده خدمات میزبانی وب نیز در بدو خرید پلن ها ارسال می شود.
- در صورت استفاده از پروتکل های امن مانند SSL یا TLS برای ارسال ایمیل در متد SMTPSecure مقادیر متناظر را تنظیم می کنیم همچنین پورت ارسال ایمیل در متد Port تنظیم  می شود که در حالت معمول یکی از مقادیر 25، 465 یا 587 است (این اطلاعات در قسمت مدیریت حساب های ایمیل برنامه کنترل پنل هاست موجود است).
نکته: اگر برای دامنه سایت گواهی های SSL رایگان نظیر Let's Encrypt فعال باشد باید از نسخه های به روز PHP (نسخه 5.6 به بعد) استفاده کنیم چون این گواهی در به روزرسانی های اخیر جهت پردازش نیاز به OpenSSL 1.1.0 دارد، در غیر اینصورت ممکن است خطای عدم اتصال به سرور ایمیل دریافت کنیم، به طور مثال:
smtp error: failed to connect to server: (0) smtp connect() failed
یا
smtp error: could not connect to smtp host
نتیجه اینکه ایمیل ها از PHPMailer ارسال نمی شوند.
- قسمت AltBody برای کاربرانی است که برنامه دریافت ایمیل آنها تنها از متن ساده پشتیبانی می کند و امکان مشاهده ایمیل های HTML را ندارند، با توجه به اینکه اغلب برنامه ها از ایمیل های HTML پشتیبانی می کنند تنظیم این قسمت اختیاری است.
- متدهای AddReplyTo، AddAddress، SetFrom برای تعیین آدرس دریافت کننده پاسخ به ایمیل، دریافت کننده ایمیل و ارسال کندده ایمیل است.
- متدهای CharSet و ContentType یونیکد و نوع محتوای ارسالی را مشخص می کنند که برای سازگاری با زبان فارسی از استاندارد UTF-8 و برای پشتیبانی از تگ های HTML از نوع محتوای text/html استفاده می کنیم.
- قسمت MsgHTML متن پیام به صورت HTML را در خود جای می دهد، این متن هم می تواند با فراخوانی یک فایل جانبی (با تابع file_get_contents) تکمیل شود یا اینکه به صورت مستقیم اطلاعات را وارد کنیم، به فرض در هنگام کار با فرم های وب می توانیم متن دریافتی از فیلدهای فرم را به متغیر نسبت داده و متغیر را به عنوان محتوای ایمیل ارسالی تنظیم کنیم.
- اگر نیاز به ضمیمه کردن فایل یا فایل هایی در ایمیل باشد می توانیم با متد AddAttachment (که در مثال بالا غیر فعال شده است)  این کار را انجام دهیم، ذکر این نکته ضروری است که فایل باید از قبل بر روی سرور قرار گرفته باشد و سپس آدرس آن به صورت داینامیک در این قسمت جایگزین شود که خود نیاز به کمی مهارت در برنامه نویسی PHP دارد.
- در نهایت نیز ایمیل با متد Send ارسال شده و با توجه به استفاده از try و catch در صورتی که خطایی رخ دهد در قسمت phpmailerException (اگر خطا از سمت کلاس PHPMailer باشد) یا در قسمت Exception (سایر خطاها) مدیریت می شود، استفاده از try و catch اختیاری است (مثال هایی در دایرکتوری examples پکیج PHPMailer وجود دارد که با و بدون استفاده از try و catch چگونگی ارسال ایمیل را نمایش می دهند).

استفاده از حساب گوگل برای ارسال ایمیل با کلاس PHPMailer


با استفاده از کلاس PHPMailer می توانیم از سایر سرورهای SMTP که در آنها حساب کاربری داریم نیز برای ارسال ایمیل استفاده کنیم، البته در عمل سرویس های ایمیل معمولا پس از مدتی برخی از پورت های عمومی خود را محدود کرده یا تغییر می دهند با این وجود یکی از پرکاربردترین این نوع خدمات سرویس ایمیل سایت گوگل است که محدودیت های کمتری نسبت به سایر موارد مشابه دارد، البته در لحظه ای که آین آموزش نوشته می شود ظاهرا پورت 465 SSL آن برای برنامه های جانبی مسدود شده است و خطای Timeout می دهد اما پورت 587 TLS مشکلی ندارد و قابل استفاده است، در کنار این دو پورت امن پورت 25 نیز وجود دارد که نیازی به رمزنگاری ندارد و البته در حال حاضر پشتیبانی نمی شود، برای اینکه کد ارسال ایمیل از طریق گوگل در سرور به درستی کار کند بهتر است همه حالت های مختلف را تست و بررسی کنیم، ارسال ایمیل از این طریق محاسن و در عین حال معایبی دارد، بهترین مزیت آن این است که محدودیت برخی از هاست های اشتراکی را ندارد چون در بیشتر هاست ها برای ارسال ایمیل محدودیت هایی به صورت روزانه یا ساعتی قائل می شوند، ظاهرا و به گفته تیم پشتیبانی گوگل در سرویس پست الکترونیک این شرکت روزانه بالغ بر 2000 ایمیل از یک اکانت تجاری قابل ارسال است که این عدد برای حساب های غیرتجاری یا آزمایشی (Trial) به 500 ایمیل در روز کاهش پیدا می کند، اما معایب این سرویس این است که ممکن است از طرف گوگل پورت های آن مسدود شود یا بدون اطلاع قبلی تغییر پیدا کند و یا به IPهای برخی کشورها سرویس ارائه نکند و مواردی از این دست که این استقلال برنامه ما را تحت تاثیر قرار می دهد، به هر صورت تصمیم به استفاده یا عدم استفاده از این امکان را به عهده شما می گذاریم.
برای استفاده از SMTP گوگل برای ارسال ایمیل در PHP نمونه کد بالا را که مبتنی بر کلاس PHPMailer است به صورت زیر ویرایش می کنیم:
<!DOCTYPE html>
<html lang="fa">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>وبگو | ارسال ایمیل با SMTP گوگل و کلاس PHPMailer</title>
<!-- Webgoo.ir -->
</head>
<body>
<?php
//فایل بارگذاری خودکار
require_once('PHPMailerAutoload.php');

//فراخوانی کلاس
$mail = new PHPMailer(true);

//استفاده از SMTP
$mail->IsSMTP();

try {
    //آدرس سرور ایمیل
    $mail->Host = "smtp.gmail.com";
    
    //استفاده از پروتکل های رمزنگاری
    $mail->SMTPSecure   = 'tls';
    
    //پورت ارسال ایمیل
    $mail->Port = 587;
    
    //استفاده از SMTP Authentication
    $mail->SMTPAuth = true;
    
    //نام کاربری و کلمه عبور حساب گوگل
    $mail->Username   = "youraccount@gmail.com";
    $mail->Password   = "yourpassword";
    
    //افزودن قسمت پاسخ به ایمیل
    $mail->AddReplyTo('replyaccount@example.com', 'Reply Name');
    
    //تنظیم اطلاعات گیرنده ایمیل
    $mail->AddAddress('receiveraccount@example.com', 'Receiver Name');
    
    //تنظیم اطلاعات ارسال کننده ایمیل
    $mail->SetFrom('senderaccount@example.com', 'Sender Name');
    
    //موضوع ایمیل ارسالی
    $mail->Subject = 'PHPMailer Test';
    
    //متن برای کاربرانی که به دلایل فنی نمی توانند ایمیل را به درستی مشاهده کنند
    $mail->AltBody = 'برنامه شما از این ایمیل پشتیبانی نمی کند، برای مشاهده آن لطفا از برنامه دیگری استفاده نمائید';
    
    //یونیکد برای پشتیبانی از زبان فارسی
    $mail->CharSet = 'UTF-8';
    
    //امکان استفاده از تگ های HTML
    $mail->ContentType = 'text/html';
    
    //متن پیام به صورت HTML
    $mail->MsgHTML('<html><body>این یک <font color="#CC0000">تست</font> است!</body></html>');
    
    // ضمیمه کردن فایل به ایمیل
    //$mail->AddAttachment('path/to/file/phpbook.zip');
    
    //ارسال ایمیل
    $mail->Send();
    
    //چاپ نتیجه موفقیت آمیز
    echo "پیام با موفقیت ارسال شد\n";
} catch(phpmailerException $e) {
    //پیام خطا از PHPMailer
    echo $e->errorMessage();
} catch(Exception $e) {
    //سایر خطاها
    echo $e->getMessage();
}
?>
</body>
</html>
ممکن است پس از اجرای کد برای اولین بار سرویس گوگل دسترسی برنامه را تا زمان دریافت مجوزهای لازم از صاحب حساب کاربری مسدود کند، بدین جهت اگر با خطای Authentication مواجه شدیم لازم است که به ایمیل خود مراجعه کرده و با پیروی از دستورالعمل پیام ارسالی از طرف گوگل مبنی بر تلاش برای استفاده از حساب کاربری ما در یک برنامه جانبی اجازه استفاده از حساب کاربریمان را به برنامه خود بدهیم و از نو آن را اجرا کنیم، توجه کنیم نباید به اشتباه بر روی لینک ها کلیک کنیم، در غیر این صورت ممکن است دسترسی برنامه به حساب گوگل مسدود شده و برای ارسال ایمیل از این طریق با مشکل مواجه شویم.

ارسال ایمیل در لوکال هاست و WampServer


برای ارسال ایمیل از طریق لوکال هاست و برنامه سرور محلی WampServer با استفاده از SMTP سرویس ایمیل گوگل GMail، ابتدا لازم است که آخرین نسخه WampServer را روی سیستم خود نصب کنیم، این برنامه از لینک زیر قابل دریافت است:
www.wampserver.com
پس از نصب برنامه به دلیل استفاده گوگل از پروتکل های امن و عدم پشتیبانی WampServer (به طور پیش فرض) از این امکان باید تغییراتی در فایل اصلی php.ini اعمال کنیم تا ایمیل ما از این طریق قابل ارسال باشد، لذا به دایرکتوری که برنامه را در آن نصب کرده ایم رفته و آدرس زیر را ادامه می دهیم تا به فایل php.ini برسیم:
\bin\apache\apache*.*.**\bin
در این فایل با استفاده از نت پد (Notepad) یا هر ویرایشگر متنی دیگری و با کمک قابلیت کلمه یاب یا Find به دنبال عبارت openssl می گردیم تا به خط مربوط به extension=php_openssl.dll برسیم، اگر در ابتدای این خط علامت ; بود آن را حذف، فایل خود را ذخیره کرده و برنامه WampServer را (اگر در حال اجرا بود) بسته و مجددا اجرا می کنیم یا می توانیم از امکان شروع مجدد آن استفاده کنیم، اکنون اگر تابع phpinfo را در یک فایل php خروجی بگیریم:
<?php
phpinfo();
?>
در قسمت Phar امکان OpenSSL Support باید فعال یا Enabled باشد در غیر این صورت در هنگام ارسال ایمیل از طریق PHPMailer و WampServer پیام زیر را دریافت خواهیم کرد:
Warning: stream_socket_enable_crypto() [streams.crypto]: this stream does not support SSL/crypto
در صورت فعال بودن OpenSSL و عدم دریافت خطا همه چیز آماده است تا از کلاس PHPMailer و SMTP گوگل استفاده کنیم.
در پایان مجددا یادآور می شویم که ممکن است برای اولین بار گوگل کد ما را مسدود کند تا زمانی که مجوز اجازه و دسترسی برنامه را از صاحب حساب دریافت کند، لذا اگر با این خطا در اکانت GMail خود مواجه شدیم باید از دستورالعمل های آن پیروی کرده و مجوز دسترسی به حسابمان را برای برنامه ارسال ایمیل فراهم کنیم.
دسته بندی: آموزش کاربردی » PHP
related مطالب بیشتر:
محدود کردن لینک دانلود مستقیم فایل ها با PHP و htaccess
نمایش آمار بازدیدها با PHP بدون استفاده از دیتابیس
نحوه نمایش متن و تصاویر اتفاقی در PHP و MySQL
ساخت منوی هوشمند با PHP و CSS
تبدیل تاریخ میلادی، شمسی با مبدل JDF در PHP
دیدگاه
more ۱۴۴ دیدگاه برای این مطلب ارسال شده است.
more دیدگاه جدید بر اساس تاریخ ارسال در انتهای دیدگاه های موجود نمایش داده می شود.
نویسنده: روستازاده
۱۲:۴۱ ۱۴۰۱/۰۱/۱۸
با سلام و خسته نباشید
ببخشید چند هفته پیش این تابع رو بهم دادید
واسه اش ازتون ممنون و سپاسگزارم
برای نمایش پرچم کشورها
function getCountry($ip='')
{
$ip = trim($ip);
$xml = simplexml_load_file("http://www.geoplugin.net/xml.gp?ip=$ip");
$res = strtolower($xml->geoplugin_countryCode);
if(empty($res) or $res == 'xx' or strlen($res)>3)
{
$res = 'eu';
}
return $res;
}
وقتی دستی آی پی رو وارد می کنم و سایتش رو باز می کنم
می نویسه IR ولی وقتی از تابع استفاده می کنم همه ی آی پی هارو می نویسه eu res خالی نیست
res مساوی xx هم نیست
طول رشته res هم بزرگتر از 3 نیست
پس چرا همش باید eu رو برگردونه!
با تشکر
پاسخ: 
ابتدا باید ببینیم آرگیومنت درستی به تابع می دهیم یا خیر، چون اگر IP به درستی تنظیم نشود قاعدتا خطا خواهیم داشت، برای اطمینان قبل از فراخوانی تابع از متغیر ip خروجی بگیرید، در گام دوم در تابع با var_dump از متغیر xml و res قبل از بررسی در شرط if خروجی بگیرید، به فرض:
var_dump($res);
لطفا نتیجه این موارد را ارسال کنید تا دقیقتر بتوانیم راهنمایی کنیم.
نویسنده: روستازاده
۲۱:۲۵ ۱۴۰۱/۰۱/۱۸
با سلام و خسته نباشید
واسه جفتش امتحان کردم
string(0) "" bool(false)
نمی دونم مشکل از کجاست! یه نمونه می تونید خودتون تست کنید تابعش رو بهم بدید بعد منم تست کنم ببینم با نتیجه شما همخوانی دارد یا نه؟
چون نمی دونم چرا نتیجه رو درست برنمی گردونه!
پاسخ: 
کدی که ما تست کردیم و مشکلی نداشت:
<?php
if(!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
$ip = $_SERVER['HTTP_X_FORWARDED_FOR'];
} else {
$ip = $_SERVER['REMOTE_ADDR'];
}

function getCountry($ip=''){
$ip = trim($ip);
$xml = simplexml_load_file("http://www.geoplugin.net/xml.gp?ip=$ip");
$res = strtolower($xml->geoplugin_countryCode);
if(empty($res) or $res == 'xx' or strlen($res)>3){
$res = 'eu';
}

//return
return $res;
}

echo getCountry($ip);
?>
احتمال دارد برنامه شما در مرحله دریافت آی پی کاربر دچار مشکلی باشد.
نویسنده: روستازاده
۲۲:۳۹ ۱۴۰۱/۰۱/۱۸
درود بر شما
ببخشید شمارو هم توی زحمت انداختم آی پی که من بهش میدم آی پی که ذخیره شده مثلا کاربری اومده نظر داده آی پیش ثبت شده ای پی هم که ثبت شده واقعی است مثلا
193.176.84.181
اینو دستی که میزنم می نویسه
RO
و همون رو که توی سایت تابع بالا دستی وارد می کنم درست نشون میده ولی با استفاده از تابع شما هیچی برنمی گردونه حتی نمونه آخر تابع شما بازم زدم
باز نوشت eu این تابع رو چند ساله استفاده می کنم و همیشه مشکل داشته قبلا برام مهم نبود ولی از وقتی با سایت شما آشنا شدم میخوام بدونم دلیلش چیه
پاسخ: 
به نظر حل مشکل بدون تست و خطایابی در سرورتان به نحو دیگری میسر نیست، همچنین می توانید برای بررسی آنلاین با TeamViewer از طریق فرم تماس هماهنگی کنید، در هر صورت کدها عینا در این آدرس استفاده شده که می توانید خروجی را ملاحضه کنید:
webgoo.ir/test/test.php
نویسنده: روستازاده
۲۲:۴۷ ۱۴۰۱/۰۱/۱۸
کافرم کرد انقد نوشت eu eu eu واسه همه چی می نویسه eu eu خخخ مرگ بر هرچی eu ههه
پاسخ: 
باید دلیل مشکل را پیدا و رفع کرد :)
نویسنده: روستازاده
۲۳:۲۱ ۱۴۰۱/۰۱/۱۸
واسه صفحه تست شما زدم درست نوشت احتمال داره مشکل از هاست باشه؟
و یا از نسخه php؟ توی پوشه روت هم تابع رو اجرا کردم بازم نوشت eu آیا تابع simplexml_load_file روی همه هاست ها قابل اجرا هست؟ چند ساله ازش استفاده می کنم بجاش زدم ir و بعد بهش توجه نکردم با simplexml_load_string هم چک کردم اونم eu نوشت با file_get_contents هم زدم با اون که لودش بسیار ضعیف شد و باز با اونم نوشت eu الان مسئله eu واسه من شده مسئله جنگ ایران و اسرائیل ههه
پاسخ: 
تا جایی که اطلاع داریم simplexml_load_string بر روی نسخه های 5 و مابعد PHP در دسترس است، البته اگر در دسترس نباشد اجرای کدها با خطا مواجه می شود، نکته دیگر اینکه کد باید آنلاین و در سرور تست شود نه در لوکال هاست چون آدرس IP در لوکال ثابت است، اگر با وجود همه این موارد مشکل رفع نشد صرفا تست و خطایابی در سرورتان می تواند به حل مشکل کمک کند.
نویسنده: روستازاده
۲۳:۳۸ ۱۴۰۱/۰۱/۱۸
واسه teamviewer الان با گوشی موبایل کار می کنم بعد اگه درست نشد حتما اینکارو می کنم واسه واقعی بودن ای پی کاربران از این تابع استفاده می کنم که با تابع شما همخوانی داره
function userIp()
{
$out = '0.0.0.0';
if (!empty($_SERVER['HTTP_CLIENT_IP']))
$out =$_SERVER['HTTP_CLIENT_IP'];
elseif(!empty($_SERVER['HTTP_X_FORWARDED_FOR']))
$out = $_SERVER['HTTP_X_FORWARDED_FOR'];
else
$out = $_SERVER['REMOTE_ADDR'];

$out = strip_tags($out);
return self::safe_html($out);
}
پاسخ: 
به هر صورت کدنویسی برنامه شی گرا است و این امکان وجود دارد که جای دیگری از متدها روندی اتفاق بیفتد که بر خروجی نهایی موثر باشد.
نویسنده: روستازاده
۲۳:۴۰ ۱۴۰۱/۰۱/۱۸
نه اصلا از لوکال استفاده نمی کنم واسه هاست لینوکس و هاست سایتمه چون می دونم لوکال بیشتر کدها و تابع ها روش جواب نمیده
پاسخ: 
تابع نمایش IP را مستقل تست کنید و ببینید اصلا خروجی مورد نظر را چاپ می کند یا خیر، شاید کمک کند.
نویسنده: روستازاده
۱۲:۳۸ ۱۴۰۱/۰۱/۱۹
با سلام و با تشکر مجدد از شما
آره تابع ip درست کار می کنه و اون مشکلی نداره و آی پی ها رو درست میزنه تابع نمایش پرچم فقط مشکل داره بارها تابع getCountry رو چک کردم با هیچ کدوم از فانکشن ها و تابع های دیگه تداخل نداشت حتی دیشب توی پوشه روت اصلی هم چک کردم اونجا هم جواب نداد چون واسه شما روی پوشه اصلی بدون مشکل نتیجه رو برگردونده بود توی تابعهای دیگه دنبال simplexml_load_file گشتم که ببینم جاهای دیگه با تابعهای دیگه کار می کنه دیدم یه جای دیگه از این تابع استفاده شده و نتیجه ها رو درست برمی گردونه اونجا واسه rss بود که xml رو load لود می کرد و مشکلی نداشت
امروز یه تیکت به پشتیبانی میدم که بررسی کنه چرا این تابع برای من کار نمی کنه
چون دیگه واقعا کم آوردم چرا جواب نمی گیرم ازش
نویسنده: محمود
۱۲:۴۶ ۱۴۰۱/۰۴/۲۳
سلام مهندس میرزایی وقت بخیر
تو میهن وب هاست نوشته تعداد ایمیل ارسالی از طریق php در روز ۱۵۰ عدد و از طریق smtp در ساعت 30 عدد منظورش چیه من که از کلاس phpmailer استفاده میکنم جزو کدوم دسته قرار میگیره ؟
سپاس از راهنمایی تون موفق باشید
پاسخ: 
منظور تابع mail داخلی در PHP یا استفاده از حالت IsSMTP در PHPMailer است:
$mail->IsSMTP();
اگر از PHPMailer با تنظیمات بالا استفاده می کنید و نام کاربری و کلمه عبور تنظیم کرده اید مشمول حالت دوم می شوید.
more لطفا پیش از ارسال دیدگاه نکات زیر را مد نظر داشته باشید:
- به سوالات کلی، مبهم و مشکلاتی که تلاشی برای رفع آنها نکرده باشید پاسخ مختصر داده شده یا به بخش برنامه نویسی اختصاصی ارجاع داده می شوند.
- کدها و اسکریپت های طولانی را ترجیحا در یک صفحه وب آنلاین یا به صورت حساب موقت و آزمایشی قرار دهید تا امکان بررسی دقیق و خطایابی میسر باشد.
- تمام دیدگاه ها خوانده شده و برای هر کاربر مدت زمان محدودی جهت پاسخگویی در نظر گرفته می شود، لطفا از طرح سوالات متعدد در بازه زمانی کوتاه خودداری کنید.
- در مواردی که امکان رفع مشکل در زمان متداول میسر نباشد ممکن است نیاز به ارجاع و ثبت سفارش در بخش برنامه نویسی باشد که در اینصورت اطلاع رسانی خواهد شد.



 refresh
10 × 10
8 × 2
20 × 20
=
آخرین دیدگاه ها
more برای دسترسی سریع به یادداشت مربوطه می توانید از لینک مطلب در کادر زیر استفاده کنید.
دانیال
در:
سلام مجدد این شکلی وارد می کنم
۱۴۰۱/۰۵/۲۳

دانیال
در:
سلام، ببخشید من برای تبدیل لینک این کد رو در htaccess نوشتم آدرس کار می کند ولی مشکل این هست که php به من...
۱۴۰۱/۰۵/۲۲

ali
در:
با سلام کلا دستورات جاوا اسکریپ رو چطوری باید به قالب های آماده وردپرس اضافه کنیم؟ مثلا innerHtml که استایل های داخل Html را...
۱۴۰۱/۰۵/۲۲

امیر
در:
با سلام و درود بر شما استاد بسیار عالی بود کارم درست شد از لطف و محبتتون بسیار ممنون و سپاسگزارم در...
۱۴۰۱/۰۵/۱۵

امیر
در:
با سلام و خسته نباشید استاد من دو تا اکشن دارم editp و editpost دسترسی کاربران رو به این دو تا اکشن تعریف کردم...
۱۴۰۱/۰۵/۱۳

امیرحسین
در:
سلام وقت بخیر، من میخواستم داخل شی گرایی php وقتی یک متودی صدا زده میشه چک کنه ببینه اجازه اجرا شدنو داره یا خیر یعنی...
۱۴۰۱/۰۵/۱۲

امیرحسین
در:
سلام استاد وقت بخیر من یه الگویی نوشتم: هر چقدر تعداد داشت محدودیتی نداشته باشه و تک تک عدد های بین کاما را...
۱۴۰۱/۰۵/۰۹

سعید
در:
باسلام با تشکر از شما درست بود و مشکلی نداشت در پناه خدای بزرگ باشید
۱۴۰۱/۰۵/۰۸

سعید
در:
با سلام و خسته نباشید شرط های زیر رو نگاه کنید: اگه دقت کنید می بینید که جفت شرط ها شبیه هم هستند....
۱۴۰۱/۰۵/۰۷

majid
در:
سلام ممنون از آموزشتون اگر بخوایم درون کامنت سایت های خارجی هم لغت لینک دار وارد کنیم با این کدها میشه؟
۱۴۰۱/۰۵/۰۲

امید سلمانی
در:
برای لینک دار کردن عکس از چه خروجی در html استفاده کنیم برای ذخیره سازی من ذخیره می کنم ولی عکس html است من می...
۱۴۰۱/۰۵/۰۲

پـــرتو
در:
چشم در اولین فرصت ارسال می کنم
۱۴۰۱/۰۴/۳۰

پرتو
در:
بعد دیگ اینک یه سوال این رنگ پس زمینه ابی رنگ توی نوار منو افقی کجاست یعنی اینک رنگش کدومه ممنون میشم بگین منتظر جوابتون...
۱۴۰۱/۰۴/۲۸

پرتو
در:
سلام خسته نباشید ببخشید بلاگفا از شمام قطعه یا فقط مال من اینطوریه بعد اینک درست میشه یا نه؟
۱۴۰۱/۰۴/۲۸
  در انتظار بررسی: ۰
 پاسخگویی به سوالات ممکن است تا 24 ساعت زمان ببرد.