FuelPHP - Manajemen Email
Fungsionalitas email adalah fitur yang paling banyak diminta dalam kerangka kerja web. FuelPHP menyediakan kelas email elegan yang dibundel sebagai satu paket. Ini digunakan untuk mengirim email teks biasa sederhana serta email teks kaya lanjutan dengan banyak lampiran. Ini mendukung fitur-fitur berikut - Surat teks biasa, surat HTML, lampiran, dan lampiran sebaris.
Konfigurasi
Untuk mengaktifkan fungsionalitas email dalam aplikasi, kita hanya perlu memuat paket email seperti yang ditentukan di bawah ini di file konfigurasi utama, fuel / app / config / config.php.
'always_load' => array (
'packages' => array (
'email',
),
),
Pilihan lainnya adalah memuat paket email, pengontrolnya sendiri sebagai berikut.
\Package::load('email');
Pengaturan email dapat dilakukan di file konfigurasi utama dan beberapa opsi penting adalah sebagai berikut,
driver - Driver email seperti smtp
is_html - Apakah akan mengirim email sebagai konten HTML atau tidak
priority - Prioritas email
smtp.host - Host server SMTP
smtp.port - Port server SMTP
smtp.username - Nama pengguna server SMTP
smtp.password - Kata sandi server SMTP
smtp.timeout - Batas waktu SMTP
smtp.starttls - Apakah server SMTP memerlukan perintah STARTTLS
API Email
Berikut adalah API yang disediakan oleh kelas driver email dan email.
menempa
Tujuan: Untuk membuat contoh driver email. Ini menciptakan driver berdasarkan konfigurasi atau input yang diterimanya. Driver email menyediakan fitur untuk membuat dan mengirim email. Beberapa driver email yang mungkin adalahsmtp, sendmail, mailgun, dan mandrill.
Parameter - Tidak ada atau susunan detail konfigurasi
Returns - Mengembalikan objek Email_Driver
Sebagai contoh,
$email = \Email::forge();
$email = \Email::forge (array(
'driver' => 'smtp',
));
tubuh
Purpose - Untuk mengatur badan pesan
Parameter - $ body - isi pesan
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->body('Body message');
//or pass it a View
$email->body(\View::forge('my/view', $data);
alt_body
Purpose - Untuk mengatur badan pesan alternatif
Parameter - $ alt_body - badan pesan alternatif
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->alt_body('Body message');
//or pass it a View
$email->alt_body(\View::forge('my/view', $data);
prioritas
Purpose - Untuk mengatur prioritas email
Parameter -
$priority- nilai prioritas. Opsinya adalah -
a. \Email::P_LOWEST
* \Email::P_LOW
* \Email::P_NORMAL
* \Email::P_HIGH
* \Email::P_HIGHEST
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->priority(\Email::P_HIGHEST);
html_body
Purpose - Untuk mengatur badan pesan dalam format HTML
Parameter -
$html - isi pesan dalam HTML;
generate_alt - apakah akan menghasilkan pesan alternatif;
auto_attach - apakah akan menyematkan gambar atau tidak
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
// Do generate the alt body, but don't auto attach images.
$email->html_body(\View::forge('welcome/email', $data), true, false);
dari
Purpose - Untuk mengatur alamat dari
Parameters -
$from - dari alamat email;
$name - Nama pengirimnya
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->from('[email protected]', 'My Name');
subyek
Purpose - Untuk mengatur subjek pesan
Parameter - $ subject - subjek pesan email
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->subject('Suject of the mail message');
untuk
Purpose - Untuk mengatur alamat email penerima
Parameters -
$email - alamat email atau susunan alamat email;
$name - nama penerima
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->to('[email protected]', 'My Dear Name');
$email->to (array(
'[email protected]',
'[email protected]' => 'My Dear friend',
));
header
Purpose - Untuk menyetel tajuk khusus ke pesan email
Parameters -
$header - jenis tajuk atau larik tajuk;
$value - nilai tajuk
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email->header('X-SMTPAP', 'XXXXXXXX');
$email>reply_to (array(
'X-SMTPAP' => 'XXXXXX',
'X-SMTPAP2' > 'XXXXXA',
));
melampirkan
Purpose - Untuk melampirkan file ke pesan email
Parameters-
$file - jalur file;
$inline - apakah akan melampirkan file sebaris atau tidak;
$cid - pengidentifikasi konten;
$mime - Jenis MIME dari file lampiran;
$name - penggantian nama file lampiran
Returns - Mengembalikan contoh saat ini
Sebagai contoh,
$email = \Email::forge();
$email>attach(DOCROOT.'attachments/sample_attachment.pdf');
Kirim
Purpose - Untuk mengirim surat.
Parameter -
$validate - apakah akan memvalidasi alamat email
Returns - benar atau salah
Sebagai contoh,
$email = \Email::forge();
try{
$email->send();
} catch(\EmailSendingFailedException $e) {
// The driver could not send the mail.
} catch(\EmailValidationFailedException $e) {
// One or more email addresses failed validation.
}
Contoh Email Kerja
Mari kita gunakan API yang dipelajari di bab sebelumnya dan buat kode sederhana untuk mengirim pesan. Berikut ini adalah kode paling sederhana untuk mengirim pesan.
$email = Email::forge();
$email->from('[email protected]', 'person1');
$email->to('[email protected]', 'person2');
$email->subject('Add something');
$email->body('contents of mail'); $email->send();