ÓʼþÀà | Email Class

CodeIgniterÇ¿´óµÄµç×ÓÓʼþÀàÖ§³ÖÒÔϹ¦ÄÜ£º

• ¶àÖÖЭÒ飺Mail£¬SendmailºÍSMTP
• ÓÃÓÚSMTPµÄTLSºÍSSL¼ÓÃÜ
• ¶à¸öÊÕ¼þÈË
• CCºÍBCC
• HTML»ò´¿Îı¾µç×ÓÓʼþ
• ¸½¼þ
• Word°ü×°
• ÓÅÏȼ¶
• BCCÅú´¦Àíģʽ£¬¿ÉÒÔ½«´óÁ¿µç×ÓÓʼþÁбí·Ö½âΪСBCCÅú´Î¡£
• µç×ÓÓʼþµ÷ÊÔ¹¤¾ß
• ʹÓõç×ÓÓʼþ¿â
  • ·¢Ë͵ç×ÓÓʼþ
  • ÉèÖÃÓʼþÊ×Ñ¡Ïî
    • ÔÚÅäÖÃÎļþÖÐÉèÖõç×ÓÓʼþÊ×Ñ¡Ïî

• Àà²Î¿¼

ʹÓõç×ÓÓʼþ¿â

·¢Ë͵ç×ÓÓʼþ

·¢Ë͵ç×ÓÓʼþ²»½ö¼òµ¥£¬¶øÇÒÄú¿ÉÒÔËæʱ¶ÔÆä½øÐÐÅäÖûò½«ÄúµÄÆ«ºÃÉèÖÃÉèÖÃΪÅäÖÃÎļþ¡£

ÒÔÏÂÊÇÒ»¸öÑÝʾÄúÈçºÎ·¢Ë͵ç×ÓÓʼþµÄ»ù±¾Ê¾Àý¡£×¢Ò⣺´ËʾÀý¼Ù¶¨ÄúÕýÔÚ´ÓÄúµÄÒ»¸ö¿ØÖÆÆ÷·¢Ë͵ç×ÓÓʼþ¡£

ÉèÖÃÓʼþÊ×Ñ¡Ïî

ÓÐ21ÖÖ²»Í¬µÄÓÅÏÈÑ¡Ôñ¿ÉÓÃÓÚ¶¨ÖÆÄúµÄµç×ÓÓʼþ·¢ËÍ·½Ê½¡£Äú¿ÉÒÔ°´ÕÕ´Ë´¦ËùÊöÊÖ¶¯ÉèÖÃËüÃÇ£¬»òÕßͨ¹ý´æ´¢ÔÚÅäÖÃÎļþÖеÄÊ×Ñ¡Ïî×Ô¶¯ÉèÖÃËüÃÇ£¬ÈçÏÂËùÊö£º

Ê×Ñ¡ÏîÊÇͨ¹ýÏòµç×ÓÓʼþ³õʼ»¯·½·¨´«µÝÒ»×éÊ×Ñ¡ÏîÖµÀ´ÉèÖõġ£ÒÔÏÂÊÇÄúÈçºÎÉèÖÃһЩÊ×Ñ¡ÏîµÄʾÀý£º

×¢Òâ

Èç¹ûÄú²»ÉèÖÃËüÃÇ£¬´ó²¿·ÖÊ×Ñ¡Ï»áʹÓÃĬÈÏÖµ¡£

ÔÚÅäÖÃÎļþÖÐÉèÖõç×ÓÓʼþÊ×Ñ¡Ïî

Èç¹ûÄú²»ÏëʹÓÃÉÏÊö·½·¨ÉèÖÃÊ×Ñ¡ÏÔò¿ÉÒÔ½«ËüÃÇ·ÅÈëÅäÖÃÎļþÖС£Ö»Ðè´´½¨Ò»¸öÃûΪemail.phpµÄÐÂÎļþ£¬ÔÚ¸ÃÎļþÖÐÌí¼Ó$ configÊý×顣Ȼºó½«¸ÃÎļþ±£´æÔÚconfig / email.phpÖУ¬Ëü½«×Ô¶¯Ê¹Óá£Èç¹û½«$this->email->initialize()Ê×Ñ¡Ïî±£´æÔÚÅäÖÃÎļþÖУ¬Ôò²»ÐèҪʹÓø÷½·¨¡£

µç×ÓÓʼþÆ«ºÃ

ÒÔÏÂÊÇ·¢Ë͵ç×ÓÓʼþʱ¿ÉÒÔÉèÖõÄËùÓÐÊ×Ñ¡ÏîÁÐ±í¡£

ѹµ¹Ò»ÇеĴʰü×°

Èç¹ûÄúÆôÓÃÁË×Ô¶¯»»Ðй¦ÄÜ£¨½¨Òé×ñÑ­RFC 822£©£¬²¢ÇÒÄúµÄµç×ÓÓʼþÖÐÓкܳ¤µÄÁ´½Ó£¬ÔòËüÒ²¿ÉÄܱ»·â×°£¬µ¼ÖÂÆä±»ÊÕ¼þÈËÎÞ·¨µã»÷¡£CodeIgniterÔÊÐíÄúÊÖ¶¯¸²¸Ç²¿·ÖÏûÏ¢ÖеÄÎÄ×Ö»»ÐУ¬ÈçÏÂËùʾ£º

·ÅÖÃÄ㲻ϣÍûÓôʰü×°µÄÎïÆ·£º{unwrap} {/ unwrap}

Àà²Î¿¼

class CI_Emailfrom($from[, $name = ''[, $return_path = NULL]])

• $ from£¨string£© - ¡°From¡±µç×ÓÓʼþµØÖ·
• $ name£¨×Ö·û´®£© - ¡°´Ó¡±ÏÔʾÃû³Æ
• $ return_path£¨×Ö·û´®£© - ¿ÉÑ¡µç×ÓÓʼþµØÖ·½«Î´·¢Ë͵ĵç×ÓÓʼþÖض¨Ïòµ½

$ this-> email-> from£¨'email protected'£¬'Your Name'£©;

You can also set a Return-Path, to help redirect undelivered mail:

$this->email->from('email?protected', 'Your Name', 'email?protected');

Note

Return-Path can¡¯t be used if you¡¯ve configured ¡®smtp¡¯ as your protocol.

reply_to($replyto[, $name = ''])

• $replyto (string) ¨C E-mail address for replies
• $name (string) ¨C Display name for the reply-to e-mail address

$this->email->reply_to('email?protected', 'Your Name');

to($to)

• $to (mixed) ¨C Comma-delimited string or an array of e-mail addresses

$this->email->to('email?protected');

$this->email->to('email?protected, email?protected, email?protected');

$this->email->to( array('email?protected', 'email?protected', 'email?protected') );

cc($cc)

• $cc (mixed) ¨C Comma-delimited string or an array of e-mail addresses

bcc($bcc[, $limit = ''])

• $bcc (mixed) ¨C Comma-delimited string or an array of e-mail addresses
• $limit (int) ¨C Maximum number of e-mails to send per batch

If $limit is set, ¡°batch mode¡± will be enabled, which will send the emails to batches, with each batch not exceeding the specified $limit.

subject($subject)

• $subject (string) ¨C E-mail subject line

$this->email->subject('This is my subject');

message($body)

• $body (string) ¨C E-mail message body

$this->email->message('This is my message');

set_alt_message($str)

• $str (string) ¨C Alternative e-mail message body

$this->email->set_alt_message('This is the alternative message');

This is an optional message string which can be used if you send HTML formatted email. It lets you specify an alternative message with no HTML formatting which is added to the header string for people who do not accept HTML email. If you do not set your own message CodeIgniter will extract the message from your HTML email and strip the tags.

set_header($header, $value)

• $header (string) ¨C Header name
• $value (string) ¨C Header value

$this->email->set_header('Header1', 'Value1'); $this->email->set_header('Header2', 'Value2');

clear([$clear_attachments = FALSE])

• $clear_attachments (bool) ¨C Whether or not to clear attachments

foreach ($list as $name => $address) { $this->email->clear(); $this->email->to($address); $this->email->from('email?protected'); $this->email->subject('Here is your info '.$name); $this->email->message('Hi '.$name.' Here is the info you requested.'); $this->email->send(); }

If you set the parameter to TRUE any attachments will be cleared as well:

$this->email->clear(TRUE);

send([$auto_clear = TRUE])

• $auto_clear (bool) ¨C Whether to clear message data automatically

if ( ! $this->email->send()) { // Generate error }

This method will automatically clear all parameters if the request was successful. To stop this behaviour pass FALSE:

if ($this->email->send(FALSE)) { // Parameters won't be cleared }

Note

In order to use the print_debugger() method, you need to avoid clearing the email parameters.

attach($filename[, $disposition = ''[, $newname = NULL[, $mime = '']]])

• $filename (string) ¨C File name
• $disposition (string) ¨C ¡®disposition¡¯ of the attachment. Most email clients make their own decision regardless of the MIME specification used here. https://www.iana.org/assignments/cont-disp/cont-disp.xhtml
• $newname (string) ¨C Custom file name to use in the e-mail
• $mime (string) ¨C MIME type to use (useful for buffered data)

$this->email->attach('/path/to/photo1.jpg'); $this->email->attach('/path/to/photo2.jpg'); $this->email->attach('/path/to/photo3.jpg');

To use the default disposition (attachment), leave the second parameter blank, otherwise use a custom disposition:

$this->email->attach('image.jpg', 'inline');

You can also use a URL:

$this->email->attach('http://example.com/filename.pdf');

If you¡¯d like to use a custom file name, you can use the third parameter:

$this->email->attach('filename.pdf', 'attachment', 'report.pdf');

If you need to use a buffer string instead of a real - physical - file you can use the first parameter as buffer, the third parameter as file name and the fourth parameter as mime-type:

$this->email->attach($buffer, 'attachment', 'report.pdf', 'application/pdf');

attachment_cid($filename)

• $filename (string) ¨C Existing attachment filename

$filename = '/img/photo1.jpg'; $this->email->attach($filename); foreach ($list as $address) { $this->email->to($address); $cid = $this->email->attachment_cid($filename); $this->email->message('<img src="cid:'. $cid .'" alt="photo1" />'); $this->email->send(); }

Note

Content-ID for each e-mail must be re-created for it to be unique.

print_debugger([$include = array('headers', 'subject', 'body')])

• $include (array) ¨C Which parts of the message to print out

You can optionally specify which parts of the message should be printed. Valid options are: headers, subject, body.

Example:

// You need to pass FALSE while sending in order for the email data // to not be cleared - if that happens, print_debugger() would have // nothing to output. $this->email->send(FALSE); // Will only print the email headers, excluding the message subject and body $this->email->print_debugger(array('headers'));

Note

By default, all of the raw data will be printed.

Licensed under the MIT License.

https://www.codeigniter.com/user_guide/libraries/email.html