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

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
برچسب ها: PHP
قبلی »
« بعدی
related مطالب بیشتر:
آموزش ساخت نقشه XML سایت (Sitemap) با PHP و MySQL
نمایش قسمتی از متن و پاراگراف با PHP
نمایش آمار بازدیدها با PHP بدون استفاده از دیتابیس
دریافت و نمایش پیج رنک گوگل با PHP
محدود کردن لینک دانلود مستقیم فایل ها با PHP و htaccess
دیدگاه
more ۱۴۸ دیدگاه برای این مطلب ارسال شده است.
more چینش دیدگاه ها به ترتیب از جدیدترین به قدیمی ترین است.
فردین امین رضایی
۰۱:۲۸ ۱۳۹۷/۱۰/۱۸
سلام
خیلی ممنون از آموزش ساده و کاربردیتون
سرور من دستور mail را بسته بود و ورژن جدید phpmailer هم کار نمیکرد. این آموزش شما مشکل منو به کل حل کرد.
موفق باشید
amir
۱۶:۰۹ ۱۳۹۷/۱۰/۰۵
سلام.
سوال من:
اون 
\r\n
ها برای چیه؟؟؟
این کاراکترها برای ایجاد خط جدید و رعایت Syntax در هنگام ارسال ایمیل است، به فرض 
$var_1 . "\r\n" . $var_2
در خروجی به صورت دو خط مجزا پردازش می شوند:
$var_1
$var_2
akbar_akbari
۱۰:۵۴ ۱۳۹۷/۰۷/۲۴
با سلام
در localhost روی سرور wamp کد زیر را نوشتم تا ایمیل ارسال کنم بعد از اجرا می نویسه با موفقیت ارسال شد ولی میرم توی اکانت جمیل ام هیچ ارسالی را نمی بینم لطفا راهنمایی فرمایید 
<form method='post' action='az1.php'>
        To: <input name='to' type='text'><br>
        From: <input name='email' type='text'><br>
        Subject: <input name='subject' type='text'><br>
        Message:<br><textarea name='message' rows='15' cols='40'></textarea><br>
        <input type='submit' value="Send Email"> 
    </form>

<?php
    $email = $_POST['email'];
    $to = $_POST['to'];
    $subject = $_POST['subject'];
    $message = $_POST['message'];
   $r=mail($to, $subject,$message);
    //  $r=mail($to, $subject,$message, "From:" . $email);

   if($r==true)
	   echo"با موفقیت ارسال شد  ";
   else
	   echo"ارسال نشد ";
?>
ارسال ایمیل در لوکال هاست به سادگی ممکن نیست و باید از SMTP گوگل استفاده کنید، توضیح نحوه تنظیم و استفاده از این قابلیت در قسمت انتهایی همین آموزش قرار داده شده است.
سید محسن سادات رسول
۱۳:۵۲ ۱۳۹۶/۰۴/۰۳
سلام
خیلی از شما ممنونم بخاطر سایت خوبتون و زحماتی که می کشید
چند سوال داشتم بی زحمت اگر جواب بدید ممنون میشم
1- چرا mail به ایمیل های جی میل ارسال نمیشه یا اگر ارسال میشه دریافت نمی کنند ولی بجاش به یاهو راحت ارسال میشه؟
2- در سرور های مجازی مابرای استفاده از smtp و در قسمت هاست چگون باید آدرس دهی کنیم تا وصل شود ؟
باتشکر
در مورد عدم دریافت ایمیل در Gmail این نوع مشکلات می تواند ناشی از قرار گرفتن IP سرور شما در لیست سیاه ایمیل ها باشد، برای رفع مشکل IP سایت خود را در سرویس های زیر بررسی و موضوع را با پشتیبانی هاست موضوع را مطرح کنید:
https://www.google.com/search?q=check+ip+email+in+black+list
در مورد سوال دوم متاسفانه ارسال ایمیل با تنظیمات خود سرور مجازی چندان ساده نیست، بهتر است از phpmailer در سرور مجازی استفاده کنید.
ابراهیم
۱۴:۳۴ ۱۳۹۶/۰۳/۰۳
سلام خسته نباشید
من ساده ترین کد (اولین کدی که نوشتید) شما رو برای تست عینا نوشتم ولی خطا میده
خطاش اینه:
Failed to connect to mailserver at "localhost" port 25, verify your "SMTP" and "smtp_port" setting in php.ini or use ini_set()
میشه بگید مشکل چیه؟ (تنظیمات php.ini که طبق گفته شما فعال و موردی نداره)
برای کارکرد صحیح تابع mail بخصوص در لوکال باید تنظیمات سرور ایمیل به درستی در فایل php.ini اعمال شده باشد، این تنظیمات معمولا در لوکال باید به صورت دستی انجام شود و نیازمند فعال بودن یک SMTP سرور مانند Sendmail است که نصب آن در لوکال ساده نیست، لذا توصیه می کنیم در لوکال از این شیوه استفاده نکنید، در سرور نیز در صورت بروز خطا باید با پشتیبانی موضوع را مطرح کنید!
vaiouser
۱۷:۰۷ ۱۳۹۶/۰۲/۱۷
سلام خسته نباشید
من یه مشکل خیلی بزرگ دارم اونم اینه که اگه کاربر ایمیلش یاهو باشه اصلا ایمیلی دریافت نمیکنم
میشه بگید مشکلش چیه؟؟؟؟؟؟؟؟؟
ممنون میشم
این مشکل نیاز به بررسی دقیق دارد، این احتمال وجود دارد که سرور سایت شما در لیست سیاه یاهو قرار گرفته باشد همچنین ممکن است فایروال سرور شما ایمیل های یاهو را به دلیلی بلاک کرده باشد.
Amir
۰۹:۴۵ ۱۳۹۶/۰۲/۰۸
سلام
من یه فرم دارم که وقتی کاربر ثبت نام میکنه ایملش رو وارد میکنه و تابع phpmailer براش ایمیل ارسال میکنه. گاها کاربر ایمیل اشتباه وارد میکنه مثلا aaa@yahoo.com چطور میتونم این ایمیل اشتباه رو در دیتابیس ذخیره کنم تا بتونم دفعه بعد جلوش رو بگیرم؟
بررسی صحت ایمیل معمولا صرفا محدود به نحوه نگارش آن است که با دستورات Regex یا filter_var در PHP این کار انجام می شود:
<?php
$email = "abc123@mail.com"; 
$regex = '/^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,3})$/'; 
if (preg_match($regex, $email)) {
 echo $email . " is a valid email.";
} else { 
 echo $email . " is an invalid email.";
}           
?>

http://in1.php.net/filter_var
اما اگر می خواهید به صورت دستی بانکی از ایمیل های نامعتبر داشته باشید، باید برای آن کدنویسی کنید و ایمیل های نامعتبر را با دستورات MySQL در دیتابیس ذخیره نمائید و هر بار قبل از ارسال ایمیل، آدرس مربوطه را از دیتابیس SELECT کرده و اگر نتیجه ای یافت نشد، ایمیل را ارسال نمائید، انجام تمامی این مراحل نیازمند آشنایی قبلی شما با نوشتن برنامه های داینامیک PHP و MySQL است.
علی
۲۱:۴۸ ۱۳۹۵/۱۰/۱۸
سلام من یه کد لازم دارم که عدد تصادفی که با تابع رند به دست میارم به شماره همراه فرد بفرستم
برای این موارد باید از سرویس های ارسال SMS که شرکت های مختلف ارائه می دهند استفاده کنید!
امیر
۱۲:۳۰ ۱۳۹۵/۰۹/۱۵
سلام
خدایش کارتون درسته . تا الان 100 سایت بیشتر سر زدم ولی سایت شما بهترینشون بوده ، واقعا هر سایت دیگه ای بود با این کیفیت مطالب میذاشت بابت نمایشش اندازه ی طراحی سایت هزینه میگرفت
موفقو پیروز باشید
حامد
۱۷:۵۱ ۱۳۹۵/۰۷/۲۸
مطلب کاربردی و کاملی بود ؛
سپاسگزارم .
زینب
۰۳:۰۸ ۱۳۹۵/۰۵/۱۵
تمامی مطالب سایت شما عالی اند.
من بارها به سایت شما مراجعه کرده ام و از مطالب مفید آن استفاده برده ام.
بی نهایت سپاسگزارم.
سید عباس زهراپناهی
۲۰:۱۰ ۱۳۹۵/۰۱/۰۱
سلام استاد ببخشید عیدتون به شما مبارک یه سوال داشتم من هاستم رایگانه و خیلی باهاش راحتم فقط وقتی میخوام هر ایمیلی رو ارسال کنم نمیشه البته اسکریپت شما روی لوکال کار میکنه اما روی سرور این پیغام رو میده
SMTP Error: Could not connect to SMTP host.
اینم آدرس هاست
https://members.000webhost.com/
هاست شما باید از قابلیت ارسال ایمیل با SMTP پشتیبانی کند، در غیر اینصورت قادر به استفاده از این روش نیستید (مگر اینکه از SMTP سرورهای دیگر نظیر گوگل استفاده کنید).
Matori73
۰۱:۰۰ ۱۳۹۴/۱۲/۰۲
درود !
مشکل رفع شد و پیام های دریافتی یونیکد نیستند، بسیار ممنونم ...
فقط یک موردی هست که ممنون میشم در موردش راهنمایی بفرمایید : مقادیر r/n/ در پیام دریافتی، عملا بی تاثیر هستن، یعنی کل اطلاعات درج شده در ایمیل دریافتی، در یک خط قرار میگیرن ! (این مورد تا قبل از حل مشکل یونیکد شدن پیام دریافتی، وجود نداشته !)
تشکر ...
نوع محتوا به صورت text/html تنظیم شده، لذا به جای r/n/ باید از تگ 
<br>
در متن پیام استفاده کنید، همچنین می توانید نوع محتوا را text/plain تنظیم نمائید!
Matori73
۱۵:۴۹ ۱۳۹۴/۱۱/۳۰
درود !
در مورد فرم زیر، کمک میخواستم !
میخواستم از $headers استفاده کنم تا ایمیل دریافتی فارسی بشه و به صورت یونیکد نمایش نده متن ها رو ولی موفق نبودم و هر جور که تست کردم باز ایمیل دریافتی، یونیکد بود و فارسی رو نمایش نمیداد ..
حذف شد
قسمت مربوط به تابع mail را به صور زیر تنظیم کنید، در صورتی که مشکل با این شیوه حل نشود، نیاز به تست و بررسی آنلاین (در سرور شما) دارد:
if(mail($address, $e_subject, $msg, "From: $email\r\nReply-To: $email\r\nReturn-Path: $email\r\nContent-type: text/html; charset=utf-8 \r\n"))
سیما
۱۰:۵۰ ۱۳۹۴/۱۱/۱۸
سلام من برای اینکه بتونم به تمام کاربران سایت از طریق همین کلاس phpmailer ایمیل ارسال کنم یک حلقه ایجاد کردم و تابع مربوطه رو داخل این حلقه فراخوانی کردم ولی نمیدونم چرا خطا میده و ایمیل ها ارسال نمیشه
ممنون میشم اگر از طریق ایمل بهم پاسخ بدید
خطایی که میده:
<b>Fatal error</b>:  Uncaught exception 'phpmailerException' with message 'Invalid address: ' in /home/kalaco/domains/9kala.com/public_html/phpmailer/class.phpmailer.php:770
Stack trace:
#0 /home/kalaco/domains/9kala.com/public_html/phpmailer/class.phpmailer.php(706): PHPMailer-&gt;addAnAddress('to', Array, '')
#1 /home/kalaco/domains/9kala.com/public_html/ar_6969_zr/functions.php(21): PHPMailer-&gt;addAddress(Array)
#2 /home/kalaco/domains/9kala.com/public_html/ar_6969_zr/action.php(838): email_to_shop(Array, '&lt;p style=&quot;text-...')
#3 {main}
  thrown in <b>/home/kalaco/domains/9kala.com/public_html/phpmailer/class.phpmailer.php</b> on line <b>770</b><br />
هرچند کدهای اصلی استفاده شده مشخص نیست، اما برای ارسال ایمیل به چند آدرس باید متد AddAddress را به صورت نمونه زیر فراخوانی کنید:
$mail->AddAddress('person1@domain.com', 'Person One');
$mail->AddAddress('person2@domain.com', 'Person Two');
قاعدتا می توانید همین آدرس ها را در یک آرایه داشته باشید و در حلقه استفاده کنید:
$recipients = array(
    'person1@domain.com' => 'Person One',
    'person2@domain.com' => 'Person Two',
);
foreach ($recipients as $email => $name) {
    $mail->AddCC($email, $name);
}
نخست
قبلی
1
2
3
4
5
6
7
بعدی
آخر
paged صفحه 3 از 10
more لطفا پیش از ارسال دیدگاه نکات زیر را مد نظر داشته باشید:
- به سوالات کلی، زمانبر، مبهم و مشکلاتی که تلاشی برای رفع آنها نکرده باشید پاسخ مختصر داده شده یا به بخش برنامه نویسی اختصاصی ارجاع داده می شوند.
- کدها و اسکریپت های طولانی را ترجیحا در یک صفحه وب آنلاین یا به صورت حساب موقت و آزمایشی قرار دهید تا امکان بررسی دقیق مشکل و خطایابی میسر باشد.
- تمام دیدگاه های ارسالی خوانده شده و برای هر کاربر مدت زمان لازم جهت پاسخگویی در نظر گرفته می شود، لطفا از طرح سوالات متعدد در بازه زمانی کوتاه خودداری کنید.



 refresh
10 × 10
5 × 2
20 × 20
=
آموزش مقدماتی | آموزش کاربردی | مهارتهای وب | تماس با ما | انتقادات و پیشنهادات | برنامه نویسی وب | پشتیبانی فنی | تبلیغات | درباره ما | حریم خصوصی | سوالات متداول | HEX RGB
copyright  محتوا در وبگو به صورت تألیفی تهیه می شود و دارای حق تألیف است، در صورت نیاز به کپی برداری لطفا ابتدا "شرایط استفاده" را مطالعه کنید.
copyright  خدمات و راه های ارتباطی ما صرفا تحت دامنه Webgoo.ir ارائه و اطلاع رسانی می شوند، صفحات یا عناوین مشابه مورد تائید نمی باشند.
© 2012 - 2026 Webgoo.ir - All Rights Reserved.