이메일 Email Class¶

이메일 함수 사용하기 Using the Email Library¶

$this->load->library('email');

$this->email->from('your@example.com', 'Your Name');
$this->email->to('someone@example.com');
$this->email->cc('another@another-example.com');
$this->email->bcc('them@their-example.com');

$this->email->subject('Email Test');
$this->email->message('Testing the email class.');

$this->email->send();

$config['protocol'] = 'sendmail';
$config['mailpath'] = '/usr/sbin/sendmail';
$config['charset'] = 'iso-8859-1';
$config['wordwrap'] = TRUE;

$this->email->initialize($config);

The text of your email that
gets wrapped normally.

{unwrap}http://example.com/a_long_link_that_should_not_be_wrapped.html{/unwrap}

More text that will be
wrapped normally.

클래스 레퍼런스 Class Reference¶

class CI_Email¶

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

인수:	$from (string) – “From” e-mail address $name (string) – “From” display name $return_path (string) – Optional email address to redirect undelivered e-mail to
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

이메일 주소와 발신자명 세팅:

$this->email->from('you@example.com', 'Your Name');

배달되지 않은 메일을 리다이렉션 하는데 도움이 되게 답신받을 주소를 세팅합니다:

$this->email->from('you@example.com', 'Your Name', 'returned_emails@example.com');

Note

Return-Path can’t be used if you’ve configured ‘smtp’ as your protocol.

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

인수:	$replyto (string) – E-mail address for replies $name (string) – Display name for the reply-to e-mail address
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

답신을 받을(reply-to) 메일 주소와 이름을 설정합니다. 설정하지 않으면 from 함수에서 제공된 정보를 기본으로 사용하게 됩니다. 예제:

$this->email->reply_to('you@example.com', 'Your Name');

to($to)¶

인수:	$to (mixed) – Comma-delimited string or an array of e-mail addresses
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

수신자의 이메일 주소를 설정합니다. 하나 이상의 주소를 설정할 수 있으며, 여러 개를 설정할 때는 콤마(,)로 구분하여 설정하거나, 배열로 넘겨줄 수도 있습니다:

$this->email->to('someone@example.com');

$this->email->to('one@example.com, two@example.com, three@example.com');

$this->email->to(
        array('one@example.com', 'two@example.com', 'three@example.com')
);

cc($cc)¶

인수:	$cc (mixed) – Comma-delimited string or an array of e-mail addresses
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

CC 메일주소를 설정합니다. “to” 함수처럼, 하나 이상의 주소를 설정할 수 있으며, 여러 개를 설정할 때는 콤마(,)로 구분하여 설정하거나, 배열로 넘겨줄 수도 있습니다.

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

인수:	$bcc (mixed) – Comma-delimited string or an array of e-mail addresses $limit (int) – Maximum number of e-mails to send per batch
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

BCC 메일주소를 설정합니다. “to” 함수처럼, 하나 이상의 주소를 설정할 수 있으며, 여러 개를 설정할 때는 콤마(,)로 구분하여 설정하거나, 배열로 넘겨줄 수도 있습니다.

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) – E-mail subject line
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

메일 제목을 설정합니다:

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

message($body)¶

인수:	$body (string) – E-mail message body
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

이메일 내용을 설정합니다:

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

set_alt_message($str)¶

인수:	$str (string) – Alternative e-mail message body
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

대체 내용을 설정합니다:

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

HTML 메일을 수신하지 못하는 수신자에게 전달하는 경우에 html로 작성된 내용을 대신할 내용을 설정합니다. 이 항목은 html로 내용을 작성할 경우에 사용할 수 있는 옵션입니다. html 메세지를 보낼때 본 함수를 사용하여 대체메시지를 작성하시지않으면, CodeIgniter 는 자동으로 html 메세지에서 태그를 제거하여 대체메세지로 사용합니다.

set_header($header, $value)¶

인수:	$header (string) – Header name $value (string) – Header value
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

e-mail 에 추가적은 header 를 설정합니다:

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

clear([$clear_attachments = FALSE])¶

인수:	$clear_attachments (bool) – Whether or not to clear attachments
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

모든 이메일 변수들을 초기화 하여 비웁니다. 이 함수는 루프를 이용하여 메일을 전송할 경우를 위하여 각 사이클 마다 데이터를 리셋하도록 해줍니다.

foreach ($list as $name => $address)
{
        $this->email->clear();

        $this->email->to($address);
        $this->email->from('your@example.com');
        $this->email->subject('Here is your info '.$name);
        $this->email->message('Hi '.$name.' Here is the info you requested.');
        $this->email->send();
}

파라미터로 TRUE 를 넘겨주면, 첨부파일도 함께 비워집니다:

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

send([$auto_clear = TRUE])¶

인수:	$auto_clear (bool) – Whether to clear message data automatically
반환값:	TRUE on success, FALSE on failure
반환형:	bool

메일전송함수입니다. 전송성공여부에 따라서 TRUE / FALSE를 반환합니다. 아래와 같이 전송성공여부를 체크하여 적절히 코딩하시면 되겠죠:

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

이 함수는 만약에 인자로 FALSE를 넘기면, 그리고 요청이 성공하면, 모든 파라미터를 자동 초기화합니다:

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

Note

print_debugger() 함수를 사용하기 위해서는, 이메일 파라미터를 초기화하지 말아주세요.

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

인수:	$filename (string) – File name $disposition (string) – ‘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) – Custom file name to use in the e-mail $mime (string) – MIME type to use (useful for buffered data)
반환값:	CI_Email instance (method chaining)
반환형:	CI_Email

파일을 첨부할 수 있게 해주는 함수입니다. 파일 경로와이름(path/name)을 첫 번째 파라미터로 넘겨주세요. URL이 아니라 파일경로를 넘겨야 합니다. 여러 개의 파일을 첨부할 경우 함수를 여러 번 호출해주시면 됩니다 예제:

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

기본 첨부파일을 사용하려면, 2번째 파라마터를 공백으로 남겨두세요. 그렇지 않으면 사용자 지정값을 사용합니다:

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

URL 을 사용할 수도 있습니다:

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

사용자 정의 파일명을 사용하고 싶으면, 세 번째 파라미터를 이용하세요:

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

만약에 real - physical - file 대신에 buffer string 을 사용하고 싶다면, 첫 번째 파라미터를 buffer 로 남겨두세요, 세 번째 파라미터는 파일명, 네 번째 파라미터는 mime-type 입니다:

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

attachment_cid($filename)¶

인수:	$filename (string) – Existing attachment filename
반환값:	Attachment Content-ID or FALSE if not found
반환형:	문자열

HTML 안에 첨부파일을 포함시킬 수 있도록, 첨부파일의 Content-ID 를 설정하고 반환합니다. 첫 번째 파라미터는 이미 첨부된 파일명이어야 합니다.

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

Note

각 이메일의 Content-ID 는 반드시 유일해야 하기 때문에 재생성되어야 합니다.

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

인수:	$include (array) – Which parts of the message to print out
반환값:	Formatted debug data
반환형:	문자열

모든 서버메세지, 이메일 헤더, 이메일 메세지들을 포함한 문자열을 리턴합니다. 디버깅시에 유용합니다.

메세지의 어느 부분이 출력되어야 하는지 선택 지정할 수 있습니다. 옵션은 : headers, subject, body.

예제:

// 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

기본적으로 모든 원시 데이터가 출력될 것입니다.