PHP Master | Menghantar e -mel dengan Swift Mailer

3

Kunci Takeaways

• Swift Mailer adalah perpustakaan berasaskan komponen yang membolehkan pengaturcara menghantar e-mel dengan mudah menggunakan pendekatan berorientasikan objek, dengan keperluan minimum Php 5.2 atau lebih tinggi dengan lanjutan SPL dan had memori minimum 8MB.
• Swift Mailer boleh dipasang melalui pir atau dengan memuat naik fail menggunakan FTP. Ia terdiri daripada lebih daripada 150 kelas dan antara muka, termasuk pengirim, pengangkut, entiti mime, encoder, dan plugin.
• Swift Mailer menyediakan fungsi untuk membuat e-mel dengan pelbagai penerima, subjek, dan badan teks biasa. Ia juga membolehkan lampiran, konfigurasi SMTP tersuai, dan penerima penjejakan yang tidak menerima e -mel.
• Swift Mailer juga mempunyai plugin penghias yang membolehkan anda menghantar e -mel yang sama kepada beberapa penerima dengan perbezaan kecil, seperti nama penerima di dalam badan e -mel. Ini bermanfaat untuk tugas seperti menghantar surat berita kepada pelanggan.

Menghantar e -mel secara pemrograman adalah tugas biasa yang sering ditangani oleh pengaturcara. Walaupun anda boleh menggunakan fungsi asli PHP, mereka boleh menjadi terlalu rendah, terutamanya apabila anda ingin melampirkan satu atau lebih fail ke mesej anda. Jika anda tidak mahu menggunakan fungsi asli, atau jika anda ingin menghantar mel menggunakan pendekatan berorientasikan objek, maka ini adalah artikel untuk anda. Saya akan memperkenalkan anda kepada Swift Mailer, perpustakaan berasaskan komponen yang kuat yang membolehkan anda menghantar e-mel dengan mudah. Bermula pada tahun 2005, Swift Mailer adalah perpustakaan yang menyediakan beberapa kelas yang membolehkan anda menghantar e -mel dari dalam skrip PHP atau aplikasi web anda. Swift Mailer mempunyai beberapa keperluan, namun mereka minimum; Perpustakaan memerlukan PHP 5.2 atau lebih tinggi dengan lanjutan SPL dan had memori minimum 8MB. Memetik dokumentasi rasmi, memasang Swift Mailer adalah remeh. Biasanya ia hanya satu kes memuat naik fail sumber yang diekstrak ke pelayan web anda. Cara paling mudah untuk memasang perpustakaan adalah melalui pir atau memuat naik fail menggunakan FTP. Memasang dari saluran pir hanyalah soal jenis dua arahan:

pear channel-discover pear.swiftmailer.org
pear install swift/swift

Kaedah kedua mungkin yang paling mudah jika anda berada di hosting bersama dan anda tidak mempunyai akses ke shell arahan. Muat turun perpustakaan dari laman web rasmi dan muat naik folder lib.

Keluarga Mailer Swift Kelas

Swift Mailer diperbuat daripada lebih daripada 150 kelas dan antara muka yang dikumpulkan bersama dalam beberapa komponen. Setiap daripada mereka mempunyai tujuan tertentu.

• Mailer: Mailer, yang direalisasikan oleh kelas Swift_Mailer, adalah kelas pusat di perpustakaan dan yang sebenarnya menghantar e -mel melalui kaedah hantar (). Pembangunnya menerima contoh kelas yang melaksanakan antara muka swift_transport yang membolehkan anda menghantar e -mel menggunakan smtp tersuai.
• Pengangkutan: Mereka melaksanakan antara muka swift_transport dan skop mereka adalah untuk berkomunikasi dengan perkhidmatan untuk menyampaikan mesej e -mel. Kelas utama adalah swift_smtptransport yang menggunakan protokol SMTP, swift_sendmailTransport yang berkomunikasi dengan eksekutif Sendmail tempatan, dan swift_mailtransport yang bergantung pada fungsi Mail () PHP.
entiti mime: Ini adalah komponen utama dalam perpustakaan. Kelas yang anda akan gunakan untuk menentukan penerima, subjek, badan dan sebagainya, yang dipanggil swift_message terbuat dari beberapa entiti yang dikumpulkan bersama. Dua contoh entiti adalah lampiran dan tajuk e -mel.
Encoders: Komponen ini bukan sesuatu yang anda akan berurusan dengan kerana ia bertindak di belakang tabir. Terdapat dua jenis pengekod: Base64 dan dipetik-dicetak. Matlamat mereka adalah untuk mengubah kandungan ke dalam format yang mematuhi spesifikasi RFC.
Plugin: Ini digunakan untuk memperluaskan fungsi asas Swift Mailer. Beberapa plugin adalah antiflood, yang membolehkan anda mengehadkan bilangan mesej yang dihantar semasa sambungan SMTP tunggal, Logger, digunakan untuk log apa yang berlaku semasa proses hantar, dan penghias, plugin yang menakjubkan yang membolehkan anda menggunakan templat e -mel dan ubah hanya beberapa perbezaan dalam teks e -mel.

Contoh asas

Dengan saya setakat ini? Baik. Sekarang bahawa anda mempunyai idea bagaimana komponen dianjurkan di perpustakaan, mari kita dapatkan tangan kami kotor dan melihat bagaimana untuk memanfaatkan kuasa dan fleksibiliti Swift Mailer. Dalam contoh pertama dan sangat mudah ini, saya akan menunjukkan kepada anda penciptaan e-mel yang mempunyai dua penerima, subjek, dan badan teks biasa. Setelah dibuat, ia akan dihantar kepada penerima. Kod berikut menggunakan tiga kelas yang disebutkan dalam bahagian sebelumnya: swift_mailtransport, swift_mailer dan swift_message. Di samping itu, perhatikan baris pertama kod, memerlukan_once yang menarik dalam autoloader Swift Mailer yang diperlukan untuk menggunakan perpustakaan.

Seperti yang anda lihat, swift_mailtransport digunakan untuk membuat contoh lapisan pengangkutan yang akan menggunakan fungsi PHP Mail () asli. Kemudian saya membuat swift_message contoh yang boleh anda fikirkan sebagai objek e -mel. Dalam baris berikut, saya menetapkan penerima menggunakan kaedah setTo (), subjek e -mel menggunakan setSubject (), badan e -mel menggunakan setBody (), dan pengirim menggunakan kaedah setfrom (). Dengan lapisan yang ditakrifkan dan e -mel yang dibuat, sudah tiba masanya untuk menghantar e -mel, yang dilakukan menggunakan kaedah SEND () kelas SWIFT_MAILER.

pear channel-discover pear.swiftmailer.org
pear install swift/swift

Contoh dengan lampiran

Tidak ada keraguan bahawa lampiran adalah ruji sistem e -mel hari ini. Tiada siapa yang boleh hidup tanpa mereka. Contoh yang lebih rumit ini akan menunjukkan kepada anda cara menghantar e -mel yang bukan sahaja mempunyai lampiran tetapi juga ciri -ciri lain.

Dua penerima tambahan, satu di CC dan yang kedua di BCC menggunakan setCC () dan setBCC ().
• satu lampiran yang diambil dari cakera menggunakan kaedah lampiran ().
• Konfigurasi SMTP tersuai menggunakan kelas swift_smtptransport.
• Ketahui penerima apa yang belum menerima e -mel menggunakan parameter kedua kaedah hantar ().

pear channel-discover pear.swiftmailer.org
pear install swift/swift

Saya menggunakan lapisan pengangkutan yang berbeza, SMTP yang ditetapkan menggunakan kelas SWIFT_SMTPTRANSPORT. Ia menerima dua parameter: pelayan SMTP dan port sambungan. Anda menggunakan contoh untuk menetapkan nama pengguna dan kata laluan yang sesuai untuk mengakses pelayan menggunakan kaedah setUserName () dan setPassword (). Kemudian, seperti contoh pertama, saya membuat objek swift_message dan menetapkan penerima, subjek, dan sebagainya. Walau bagaimanapun, kali ini saya juga mengambil kesempatan daripada setCc () dan setBCC () Kaedah yang, seperti yang anda boleh meneka, membolehkan anda menetapkan salinan karbon dan penerima salinan karbon buta. Kaedah utama contoh ini adalah lampiran () yang melampirkan fail yang diambil dari cakera keras menggunakan kaedah statik daripath () yang mengambil jalan ke fail yang anda mahu dilampirkan sebagai parameternya. Perhatikan bahawa kali ini saya juga mencetak bilangan penerima gagal yang diambil menggunakan parameter kedua Kaedah Send ().

Menggunakan templat

Contoh ketiga dan terakhir menunjukkan kepada anda cara menggunakan plugin penghias, sesuai untuk perkara seperti menghantar surat berita kepada pelanggan anda. Ia membolehkan anda menghantar e -mel yang sama kepada beberapa penerima yang mempunyai perbezaan kecil seperti nama penerima di dalam badan e -mel. Plugin akan melihat di dalam templat (badan) dan akan menggantikan ruang letak dengan nilai yang ditetapkan. Untuk menggunakan plugin, anda perlu mendaftarkannya menggunakan kaedah RegisterPlugin () dan kemudian membina dan menggunakan pelbagai nilai penggantian. Dalam kod berikut, saya akan meletakkan dua ruang letak, nama pengguna dan transaksi , yang akan digantikan secara programatik dengan nilai merujuk kepada e -mel pengguna.

<span><span><?php
</span></span><span><span>require_once 'lib/swift_required.php';
</span></span><span>
</span><span><span>// Create the mail transport configuration
</span></span><span><span>$transport = Swift_MailTransport<span>::</span>newInstance();
</span></span><span>
</span><span><span>// Create the message
</span></span><span><span>$message = Swift_Message<span>::</span>newInstance();
</span></span><span><span>$message->setTo(array(
</span></span><span>  <span>"hello@gmail.com" => "Aurelio De Rosa",
</span></span><span>  <span>"test@fake.com" => "Audero"
</span></span><span><span>));
</span></span><span><span>$message->setSubject("This email is sent using Swift Mailer");
</span></span><span><span>$message->setBody("You're our best client ever.");
</span></span><span><span>$message->setFrom("account@bank.com", "Your bank");
</span></span><span>
</span><span><span>// Send the email
</span></span><span><span>$mailer = Swift_Mailer<span>::</span>newInstance($transport);
</span></span><span><span>$mailer->send($message);</span></span>

Pembina plugin Decorator menerima satu parameter: pelbagai nilai untuk menggantikan ruang letak. Setiap nilai array ini menggunakan e-mel pengguna untuk kunci dan sub-array yang mengandungi pasangan pengganti tempat letak. Ini adalah tujuan dari array penggantian $. Dalam contoh di atas, sebagai tempat letak saya menggunakan rentetan di dalam dua kurungan (iaitu {FullName}) tetapi anda boleh menggunakan apa sahaja yang anda mahukan. Kali ini, saya tidak menetapkan semua penerima dalam pernyataan yang sama seperti sebelumnya dan saya menggunakan gelung. Ini dilakukan kerana plugin memintas proses penghantaran, membaca e -mel penerima, dan menggantikan ruang letak menggunakan nilai -nilai array penggantian.

Kesimpulan

Dalam artikel ini saya menunjukkan bagaimana anda boleh menghantar e -mel dengan mudah menggunakan Swift Mailer. Ini adalah perpustakaan yang sangat kuat yang, seperti yang anda lihat, membolehkan anda melakukan banyak perkara menggunakan pendekatan OOP. Sudah tentu Swift Mailer mempunyai banyak kaedah dan kelas lain yang saya tidak dilindungi dalam artikel ini. Anda boleh mengkaji mereka dalam dokumentasi rasmi, tetapi ini sepatutnya cukup untuk membuat anda mula menghantar e -mel tanpa kerumitan. imej melalui Fotolia

soalan yang sering ditanya mengenai Swift Mailer

Bagaimana saya boleh memasang Swift Mailer menggunakan komposer?

Swift Mailer boleh dipasang dengan mudah menggunakan komposer, alat untuk pengurusan ketergantungan dalam php. Untuk memasang Swift Mailer, anda perlu memasang komposer pada sistem anda. Sebaik sahaja anda memasang komposer, anda boleh memasang Swift Mailer dengan menjalankan arahan berikut dalam direktori projek anda: Komposer memerlukan "Swiftmailer/Swiftmailer:^6.0". Perintah ini memberitahu komposer untuk memuat turun pakej Swift Mailer dan kebergantungannya ke dalam projek anda.

Bagaimana saya boleh menghantar e -mel dengan Swift Mailer? Mengkonfigurasi pengirim, dan menghantar mesej. Berikut adalah contoh asas cara menghantar e -mel dengan Swift Mailer:

memerlukan_once '/path/to/vendor/autoload.php'; 🎜>>>>$message = (baru swift_message ())
-> setSubject ('hello')
-> setfrom (['john@doe.com' => 'John Doe'])
-> setto (['resepsiver@domain.org', 'lain@domain.org' => 'nama'])
-> setBody ('di sini adalah mesej itu sendiri'); $ pengangkutan = (baru swift_smtptransport ('smtp.example.org', 25))
-> setUserName ('nama pengguna anda')
-> setPassword ('kata laluan anda');

$ mailer = new swift_mailer ($ pengangkutan);

$ result = $ mailer-> hantar ($ mesej);

Bagaimana saya boleh menambah lampiran ke e -mel dengan Swift Mailer?

Swift Mailer membolehkan anda menambah lampiran ke e -mel anda. Anda boleh melampirkan fail dari jalan, rentetan, atau contoh lampiran Swift yang sedia ada. Berikut adalah contoh bagaimana untuk melampirkan fail dari jalan:

$ message = (baru swift_message ())

-> setSubject ('hello')

-> setfrom (['John @doe.com '=>' John Doe '])

-> setto ([' resepsiver@domain.org '])

-> setBody (' Inilah mesejnya sendiri ')
-> melampirkan (swift_attachment :: Frompath (' Path/to/image.jpg ');

Bagaimana saya boleh menghantar e -mel HTML dengan Swift Mailer?

Swift Mailer membolehkan anda menghantar e -mel HTML dengan menetapkan badan mesej ke rentetan HTML dan menetapkan jenis kandungan ke 'Teks/HTML'. Berikut adalah contoh:

$ message = (baru swift_message ())
-> setSubject ('hello')
-> setfrom (['john@doe.com' => 'John Doe '])
-> setto ([' resepiver@domain.org '])
-> setBody ('

Inilah html Mesej itu sendiri

',' Text/html ');

Bagaimana saya boleh mengendalikan kesilapan dalam Swift Mailer? Anda boleh menangkap pengecualian ini untuk mengendalikan kesilapan. Berikut adalah contoh:

cuba { $ mailer-> hantar ($ mesej);
} tangkapan (swift_transportexception $ e) { echo 'ada kesilapan Menghantar e -mel: '. $ e-> getMessage ();
}

Bagaimana saya boleh menggunakan Swift Mailer dengan gmail?

tetapan. Berikut adalah contoh:

$ pengangkutan = (baru swift_smtptransport ('smtp.gmail.com', 465, 'ssl'))

-> setusername ('nama pengguna gmail anda')

- > setpassword ('kata laluan gmail anda');
$ message1 = (baru swift_message ())
-> setSubject ('hello')
-> setfrom (['john@doe.com' => 'John Doe ']) setto ([' resepiver1@domain.org '])

-> setBody (' inilah mesej itu sendiri '); -> setSubject (' hello ') -> setfrom ([' john@doe.com '=>' John Doe '])

-> setto ([' resepiver2@domain.org '])
-> setBody (' inilah mesej itu sendiri '); hantar ($ message1);
$ result2 = $ mailer-> hantar ($ message2);
Mailer dengan Symfony?

Swift Mailer diintegrasikan dengan Symfony dan boleh digunakan sebagai perkhidmatan. Anda boleh menghantar e -mel dengan Swift Mailer dalam Symfony dengan mendapatkan perkhidmatan pengirim dan menggunakannya untuk menghantar mesej. Berikut adalah contoh:

$ message = (baru swift_message ())
-> setSubject ('hello')
-> setfrom (['john@doe.com' => 'John Doe ']) setto ([' resepiver@domain.org '])
-> setBody (' inilah mesej sendiri ');
anda boleh menetapkan keutamaan e -mel dengan Swift Mailer dengan memanggil kaedah setPriority pada contoh mesej. Keutamaan adalah integer antara 1 (tertinggi) dan 5 (terendah). Berikut adalah contoh:

$ message = (baru swift_message ())
-> setSubject ('hello')
-> setfrom (['john@doe.com' => 'John Doe '])

-> setto ([' resepiver@domain.org '])

-> setBody (' inilah mesej itu sendiri ')

-> setPriority (1);

Bagaimana saya boleh menghantar e -mel secara asynchronously dengan Swift Mailer?

Swift Mailer tidak menyokong e -mel tidak segerak menghantar keluar dari kotak. Walau bagaimanapun, anda boleh mencapai ini dengan menggunakan barisan mesej. Anda boleh memasukkan mesej dan kemudian menghantarnya dalam proses yang berasingan. Ini membolehkan permohonan anda terus memproses tugas lain tanpa menunggu e -mel dihantar.

Atas ialah kandungan terperinci PHP Master | Menghantar e -mel dengan Swift Mailer. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!