پنجشنبه ۲۴ اردیبهشت ۱۴۰۵

Thursday, May 14, 2026 GMT +3: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 مطالب بیشتر:
ارسال پارامتر به URL و دریافت مقادیر با PHP
ساخت منوی هوشمند با PHP و CSS
نمایش قسمتی از متن و پاراگراف با PHP
ساخت فید خوان آر اس اس (RSS Feed Reader) با PHP
نمایش آمار بازدیدها با PHP بدون استفاده از دیتابیس
دیدگاه
more ۱۴۸ دیدگاه برای این مطلب ارسال شده است.
more چینش دیدگاه ها به ترتیب از جدیدترین به قدیمی ترین است.
۲۳:۵۲ ۱۳۹۳/۰۱/۲۴
درود ممنون از توضیحات برای قسمت دوم سوالم که مربوط به دریافت بود تونستم با استفاده وب میل هایی که تست کردم به نتایجی برسم
هادی
۱۲:۲۸ ۱۳۹۳/۰۱/۲۴
درود
ممنون از راهنمایی هایتان
1- اگر بخواهم از طریق یک فرم ثابت ایمیل را ارسال کنم تغییرات فایل mail.php چگونه خواهد شد یه نمونه اگر مثلا موضوع یا گیرنده را بگویید کافیست
2- امکان این وجود دارد که ایمیل های دریافتی را نیز با این روشها در سیستم داشته باشیم؟؟
در مورد سوال اول کافی است اطلاعات فرم را از طریق متد POST دریافت و در متغیرهایی مقداردهی کنید، سپس به جای مقادیر مستقیم که در کدها تنظیم شده، از متغیر استفاده کنید، مثال:
<?php
$user_name = $_POST['name'];
$user_mail = $_POST['mail'];
$mail->AddAddress($user_mail, $user_name); // تنظیم آدرس گیرنده ایمیل
?>
در مورد سوال دوم، منظورتان مشخص نیست، کدهای گفته شده برای ارسال ایمیل است، دریافت آن باید با برنامه هایی مانند Outlook در ویندوز یا سرویس دهنده های ایمیل مانند یاهو، جیمیل و... (بسته به آدرس گیرنده ایمیل) انجام شود.
۰۲:۴۵ ۱۳۹۳/۰۱/۱۶
سلام خسته نباشید.
من میخوام هر روز یک گزارش از کل کارهایی که در سایتم رخ داده (ثبت سفارش و ثبت خرید) ، به مدیر سایت ایمیل بشه یا یه جایی ذخیره بشه. میشه لطفا یکم راهنماییم کنید.
واقعا ممنون میشم. مرسی
ابتدا باید گزارشات را در دیتابیس یا یک فایل متنی ذخیره کنید (باید کد آن را بنویسید)، سپس باید کدی داشته باشید که این موارد را از طریق ایمیل ارسال کند، در نهایت نیز این فایل (فایل مربوط به ارسال ایمیل) را از طریق امکاناتی مانند Cron Jobs در cPanel در فواصل زمانی مشخص اجرا کنید.
۲۳:۲۹ ۱۳۹۲/۱۲/۲۳
با سلام و تشکر . مشکل من اینه که وقتی اطلاعات فرم که دریافت کردم توی یه متغییر میریزم و به صورت html ارسال میشه کد های php را نمیخونه و ارسال نمیکنه
کد من :
<html>
<body>
<?php echo $_POST["message"] ; ?>
</body>
</html>
سوالتان واضح نیست!
اگر در ارسال محتوا از طریق ایمیل مشکل دارید، ابتدا کل موارد (کدهای HTML + محتوای ارسال شده از فرم) را به یک متغیر نسبت دهید و سپس متغیر را به عنوان بدنه ایمیل ارسال کنید، قاعدتا باید با Syntax دستورات PHP آشنا باشید، در غیر این صورت لطفا به آموزش های مقدماتی مراجعه کنید.
morteza
۲۲:۰۴ ۱۳۹۲/۱۲/۲۲
با سلام
واقعاً عااااالی بود این آموزش . . . خیلی ممنونم
من یک صفحه html ساختم همراه css بدون عکس و کدهای این صفحه رو کپی کردم داخل
$mail->MsgHTML('')
توسط gmail ، این ایمیل رو هم به یک ایمیل gmail فرستادم هم به یک ایمیل یاهو.
مشکل اینجاست که تو gamil اصلاً هیچ css ای وجود نداشت. تو یاهو هم دست و پا شکسته یه مقدار از css ها اجرا شدند.
میخواستم بدونم نحوه ی صحیح این ایمیل باید به چه صورت باشد.
با تشکر فراوان
باید ایمیل را به صورت HTML ارسال و از استایل CSS خطی برای موارد مورد نظر استفاده کنید (در صورتی که این کار را صحیح انجام دهید و خطایی در سورس کدها نباشد، نباید مشکلی وجود داشته باشد، در غیر این صورت سورس کدتان را بررسی کنید، احتمال وجود اشتباه در تگ ها زیاد است!).
بهنام
۱۵:۵۶ ۱۳۹۲/۱۲/۱۱
سلام دوست عزیز از آموزش های مفیدتون خیلی استفاده می کنم امیدوارم همیشه در طی زندگیتون موفق باشید
سوالی که دارم این که من اگه بخوام با همین تابع
mail()
اگه بخوام به دو نفر همزمان ایمیل بدم چطوری میشه؟ لطفا کمکم کنید
می توانید ایمیل ها را در یک آرایه تعریف و با حلقه foreach تک تک به گیرنده ها ایمیل را ارسال کنید، نمونه کد:
<?php
$email_array = array(
'email_1@test.com',
'email_2@test.com'
);
foreach($email_array as $key => $value){
mail($email_array[$value], $subject, $message, $headers);
}
?>
۱۹:۳۳ ۱۳۹۲/۱۱/۲۰
باسلام
هنگام ارسال ایمیل از طریق stmp جیمیل، با این خطا مواجه میشم:
SMTP -> ERROR: Failed to connect to server: Connection timed out (110) 
پورت 465 و 25 و بقیه پورت هایی که سرچ کردم رو تست کردم، اطلاعات اتصال به سرور جیمیل هم مطمئنم درسته، یه جا خوندم که مشکل از بسته بودن پورت هاست، پورت ها رو چک کردم هیچ کدوم از پورت های بالا باز نبود، الان نمیدونم باید چیکار کنم.
حل این مشکل نیاز به بررسی بیشتر و تست از طریق ISP شما دارد که قاعدتا برایمان امکانپذیر نیست، در کل احتمال اینکه مشکل ناشی از محدودیت های مخابراتی باشد زیاد است!
mogoei
۲۰:۰۳ ۱۳۹۲/۱۱/۱۹
سلام خسته نباشید بنده کدهای زیر رو برای ارسال ایمیل نوشتم
<html>
<head>
<meta http-equiv="content-type" content="text/html" />
<meta name="author" content="phpDesigner.8.1" />

<title>Untitled 1</title>
</head>

<body>
<?php
$to = "someone@example.com";
$subject = "Test mail";
$message = "Hello! This is a simple email message.";
$from = "someonelse@example.com";
$headers = "From:" . $from;
mail ( $to, $subject, $message, $headers);
if(mail( $to, $subject, $message, $headers)){
echo "Mail Sent.";
}
?>
</body>
</html>
دست آخر این خطا رو میده
Warning: mail() [function.mail]: Failed to connect to mailserver at "localhost" port 25, verify your "SMTP" and "smtp_port" setting in php.ini or use ini_set() in C:\\xampp\\htdocs\\xampp\\mail.php on line 17
چطور میشه اون رو برطرف کرد ممنون
ارسال ایمیل در لوکال نیاز به تنظیماتی دارد، از طرفی تنظیم برنامه لوکال سرور برای ارسال ایمیل خیلی ساده نیست، با توجه به اینکه از XAMPP استفاده می کنید، باید به انجمن های مربوطه مراجعه و روش فعال سازی Send Mail را در این برنامه پیدا کنید (به نظر خیلی ساده و به راحتی عملی نیست).
الهام تدین
۱۶:۱۲ ۱۳۹۲/۱۱/۱۷
سلام
من برای من این خطا رو میده :
SMTP Error: Data not accepted. خطا:پیام شما ارسال نشد » SMTP Error: Data not accepted.
SMTP server error: Relaying not allowed - From: domain not local
مشکل از کجاست
ممکن است ایراد از دو مورد زیر باشد:
- تنظیمات ارسال ایمیل در کدهای شما (مانند درج آدرس نادرست برای سرور SMTP).
- تنظیمات نادرست سرور ایمیل هاستتان.
در هر صورت یک ایمیل به صورت تستی (با متن ساده به فرض test) به چند سرویس مختلف (مانند یاهو، جیمیل و...) ارسال کنید، اگر مشکل فقط برای بعضی از سایت ها بود، تنظیمات ایمیل سرور دچار اشکال است.
tofigh
۱۵:۴۰ ۱۳۹۲/۱۱/۱۲
سلام. خسته نباشید. من از کد ایمیل ساده برای ارسال ایمیل استفاده می کنم ولی رو یه هاست کار میکنه ولی رو یه هاست دیگه کار نمیکنه ممنون می شم راهنماییم کنید مرسی
این موضوع بستگی به تنظیمات PHP در هاست مورد نظر دارد، برخی هاست ها این امکان را فراهم نمی کنند و باید الزاما از SMTP استفاده کنید.
فرشیدموسوی
۱۹:۱۷ ۱۳۹۲/۱۱/۰۸
سلام خسته نباشید
من از SMTP استفاده کردم و برای یه مدت 2 و 3 ماه روی هاست و لوکالم کار می کرد بعد از این مدت به دلیل تغییر پسورد ایمیل SMTP به مشکل بر خوردم که خوب پسورد و درست کردم اما از اون موقع دیگه روی هاست کار نمیکنه به من خطای
"SMTP Error: ارتباط با میزبان SMTP میسر نیست. "
نشون میده
فقط برای هاست این خطا رو میده
روی لوکالم ایمیل میکنه بدون هیچ مشکلی
حل این مشکل نیاز به خطایابی دارد و بدون تست آنلاین نمی توان گفت مشکل از چیست، ممکن است ایراد از یک مورد جزئی یا تنظیمات سرور باشد.
mamad
۲۳:۴۵ ۱۳۹۲/۱۰/۲۵
دمت گرم.
کار ما رو راه انداخت
محمد ف
۱۵:۰۰ ۱۳۹۲/۱۰/۲۲
ممنون از پاسختون ، ردیف ها با تگ <br> درست شد اما متاسفانه در تیتر ایمیل یا همون from همچنان نام سرور که بصورت u21345@srv9.main-hosting.com میاره . البته تا قبل از تبدیل ایمیل به html این مورد صحیح آورده می شد و فقط subject و محتوای ایمیل (متن) با فونتی نامشخص میاورد . اما الان که فرمت یونیکد 8 و ایمیل هم html شده همه چیز درسته بجز این مورد؟؟
ببخشید به غیر از این مورد یک سوال دیگه هم داشتم: چطوری میتونم در محتوای ایمیل (متن) رنگ و فونت عناوین را متفاوت با متغیرهایی که توسط کاربر درج میشه تغییر بدم منظورم اینه که مثلاً عنوان نام با رنگ قرمز و اسمی که کاربر نوشته با رنگ مشکی برام ارسال بشه مثلاً این کد را باید چکار کنم
"NAME: $name\n<br>".
مورد اول نیاز به بررسی بیشتر دارد، احتمال اینکه اشتباهی در ویرایش کد کرده باشید زیاد است (در صورت تمایل کد را به ایمیل ما که در بخش تماس وجود دارد ارسال کنید تا بررسی شود)، پاسخ مورد دوم را در یادداشت قبلی دادیم، هنگامی که خروجی HTML است پس از تگ های HTML هم می توان برای شکل دادن ایمیل استفاده کرد، مثال:
"NAME: <b>$name</b>\n<br>".
محمد ف
۲۱:۱۹ ۱۳۹۲/۱۰/۲۰
ممنون از پاسختون . با کدی که شما گفتید فرمت html شد و متن ایمل فارسی و خوانا شد ولی 2 مشکل وجود داره
1 - متن ایمل پشت سر هم شده در حالی که در قبل از حل مشکل متن بصورت چند ردیفی بود مثلا بجای اینکه در یک ردیف نام و نام خانوادگی و در یک ردیف شماره تلفن باشه پشت سرهم و در یک خط افقی این اطلاعات رو میاره
مشکل دوم اینکه - در قسمت from بجای درج ایمیل ارسال کننده نام سرور میاد
ممنون میشم در این موارد هم راهنمایی فرمایید.
مشکل نمایش محتوا را باید با افزودن تگ <br> به محتوا رفع کنید، زمانی که ایمیل را به صورت HTML ارسال می کنید، نحوه نمایش محتوای نهایی نیز با تگ های HTML کنترل می شود!
در مورد مشکل دوم باید ببینید متغیر from با چه مقداری ست می شود، این مقدار باید آدرس ایمیل ارسال کننده یا نام او باشد.
محمد ف
۰۶:۱۶ ۱۳۹۲/۱۰/۲۰
ببخشید من این کد فرم تماس با منه ، اما متن ارسالی در outlook با فرمت text plain و ناخوانا نشان میده ، چطوری متن دریافتی به فرمت html بشه و در outlook فونت ها بصورت خوانا و یونیکد 8 نشون بده ... ممنون میشم کد تصحیح شده را برام بزارید ( من زیاد از php سر در نمیارم و این کد هم آماده از یکی از سایت ها پیدا کردم). با تشکر
حذف شد
هر چند رفع خطای اسکریپت های آماده باید از سایت ارائه دهنده کد درخواست شود، با این حال؛ قسمت مربوط به header ها را به شکل زیر تغییر دهید:
$headers = "Content-type: text/html; charset=utf-8 \r\n";
$headers .= "From: $from \r\n";
$headers .= "Reply-To: $from \r\n";
more لطفا پیش از ارسال دیدگاه نکات زیر را مد نظر داشته باشید:
- به سوالات کلی، زمانبر، مبهم و مشکلاتی که تلاشی برای رفع آنها نکرده باشید پاسخ مختصر داده شده یا به بخش برنامه نویسی اختصاصی ارجاع داده می شوند.
- کدها و اسکریپت های طولانی را ترجیحا در یک صفحه وب آنلاین یا به صورت حساب موقت و آزمایشی قرار دهید تا امکان بررسی دقیق مشکل و خطایابی میسر باشد.
- تمام دیدگاه های ارسالی خوانده شده و برای هر کاربر مدت زمان لازم جهت پاسخگویی در نظر گرفته می شود، لطفا از طرح سوالات متعدد در بازه زمانی کوتاه خودداری کنید.



 refresh
10 × 10
3 × 9
20 × 20
=