3.4. Email
3.4.4. Các phương thức
from()
Mode hay không
bcc_batch_size 200 Số địa chỉ email mỗi
nhóm khi sử dụng BCC Batch Mode
Cú pháp
$this->email->from(string $email, string $name)
Phương thức from() cho phép thiết lập địa chỉ email và tên của người gửị
reply_to()
Cú pháp
$this->email->reply_to(string $email, string $name)
Phương thức reply_to() cho phép thiết lập địa chỉ email sẽ nhận trả lờị Nếu phương thức này không được sử dụng, hệ thống sẽ tự nhận địa chỉ email trong phương thức from() làm địa chỉ nhận trả lờị
to()
Cú pháp
$this->email->to(string/array $emailAđresses)
Phương thức to() cho phép thiết lập những địa chỉ email sẽ được gửị Các địa chỉ này được cách nhau bởi dấu phẩy (,) hoặc được lưu trong một mảng. Ví dụ:
$this->email->to('one@examplẹcom, two@examplẹcom, three@examplẹcom'); $list = array('one@examplẹcom', 'two@examplẹcom', 'three@examplẹcom');
$this->email->to($list);
cc()
Cú pháp
$this->email->cc(string/array $emailAđresses)
Phương thức cc() cho phép thiết lập những địa chỉ email sẽ được nhận bản sao khi gửi email (carbon copy). Người nhận sẽ thấy những địa chỉ được thiết lập bằng phương thức cc(). Cũng giống như phương thức to(), ta có thể truyền vào danh sách các địa chỉ email hoặc một mảng.
bcc()
Cú pháp
Phương thức bcc() cho phép thiết lập những địa chỉ email sẽ được nhận bản sao khi gửi email, tuy nhiên người nhận sẽ không thấy những email được thiết lập trong phương thức to(), cc() và bcc() (blind carbon copy). Cũng giống như phương thức to(), ta có thể truyền vào danh sách các địa chỉ email hoặc một mảng.
subject()
Cú pháp
$this->email->subject(string $subject)
Phương thức subject() cho phép thiết lập tiêu đề của email.
message()
Cú pháp
$this->email->message(string $message)
Phương thức message() cho phép thiết lập nội dung của email.
set_alt_message()
Cú pháp
$this->email->set_alt_message(string $message)
Phương thức set_alt_message() cho phép thiết lập nội dung thay thế của email. Nếu email được gửi có dạng HTML nhưng người nhận không muốn hiển thị HTML vì lý do bảo mật, nội dung thay thế này sẽ được hiển thị. Nếu phương thức này không được sử dụng, CodeIgniter sẽ tự động tách bỏ các tag HTML trong phần nội dung email làm nội dung thay thế.
clear()
Cú pháp
$this->email->clear([boolean $clearAttachment])
Phương thức clear() sẽ xóa tất cả giá trị đã được thiết lập bởi các phương thức from(), reply_to(), to(), cc(), bcc(), subject(), message(). Phương thức này thường được sử dụng bên trong vòng lặp, giúp khởi động lại các giá trị sau mỗi lần lặp. Ví dụ:
foreach ($list as $name => $ađress) à
$this->email->to($ađress);
$this->email->from('your@examplẹcom');
$this->email->subject('Here is your info '.$name);
$this->email->message('Hi '.$namẹ' Here is the info you requested.'); $this->email->send();
}
Nếu biến tùy chọn $clearAttachment có giá trị TRUE, tất cả tập tin đính kèm cũng bị xóạ
send()
Cú pháp
$this->email->send()
Phương thức send() sẽ thực hiện việc gửi email. Phương thức này trả về TRUE nếu gửi email thành công, ngược lại trả về FALSE.
attach()
Cú pháp
$this->email->attach(string $filePath)
Phương thức attach() sẽ đính kèm tập tin vào email. Phương thức này nhận đường dẫn tương đối đến tập tin trên máy chủ làm đối số thứ nhất. Nếu muốn đính kèm nhiều tập tin, ta gọi phương thức này nhiều lần.
print_debugger()
Cú pháp
$this->email->print_debugger()
Phương thức print_debugger() sẽ hiển thị những thông tin trả về từ phía server, email header cũng như nội dung email. Thường được sử dụng cho việc gỡ lỗị Ví dụ:
if ( $this->email->send() == FALSE ) à
$this->email->print_debugger(); }