Mengirimkan Email Dengan Melampirkan File PDF Menggunakan Fungsi PHP mail()

File PDF merupakan file atau dokumen yang paling banyak digunakan untuk menampilkan dokumen penting seperti transaksi perdagangan, dokumen kependudukan hingga materi pendidikan. PDF atau Portable Document Format memiliki fungsi yang cukup penting di dalam kehidupan sehari-hari untuk menunjang berbagai aktivitas dan pekerjaan. Hal ini karena dokumen PDF dapat diakses oleh hampir semua perangkat walaupun perangkat tersebut memiliki OS (Operating System) yang berbeda-beda.

Selain itu, dokumen PDF juga memiliki kelebihan lainnya yaitu dapat digabungkan dengan dokumen PDF lainnya ataupun dipecah ke dalam beberapa bagian dengan tool tambahan. Dokumen PDF juga dapat dengan mudah dikonversi ke dalam bentuk format dokumen lainnya seperti DOCX, XLSX, PPT hingga ke dalam bentuk gambar (PNG, JPG).

Dalam dunia perdagangan, setiap terjadi transaksi keuangan, biasanya laporan transaksi akan dikirimkan kepada client. Laporan ini akan dikirim dalam bentuk dokumen PDF. Sebagai contoh misalnya pada transaksi perdagangan saham, setiap transaksi baik itu penjualan maupun pembelian sudah pasti laporannya akan dikirim via email dalam bentuk PDF. Jika anda pernah menggunakan transportasi pesawat ataupun kereta api, setelah pemesanan, maka tiket akan segera dikirim via email dalam bentuk PDF.

Dan untuk mengirimkan dokumen PDF dengan menggunakan email, perlu sistem yang harus dibuat untuk menunjang aktivitas dan keperluan di atas.

Mengirimkan Email Dengan Melampirkan File PDF Menggunakan Fungsi PHP mail()

Fungsi PHP mail() merupakan fungsi bawaan PHP yang digunakan untuk mengirimkan teks melalui media email. Biasanya fungsi mail(), digunakan untuk mengirimkan konten hanya dalam bentuk teks maupun dalam bentuk HTML tag. Dan tidak untuk melampirkan dokumen (attachment) dalam bentuk file melalui fungsi tersebut. Kalangan umum biasanya menggunakan library lain seperti phpmailer, maupun swiftmailer untuk melampirkan file-file pendukung via email.

Fungsi mail() pada PHP juga dapat digunakan untuk mengirim pesan teks sekaligus menyertakan file-file pendukung via email. Di sini saya akan menggunakan file PDF sebagai file attachment-nya. Anda dapat menggunakan file dalam bentuk format lainnya sesuai dengan keperluan yang anda butuhkan.

Fungsi PHP mail() :

mail($penerima,$subject,$messages,$headers)

Alur Dan Tahapan Fungsi mail() Dengan File Lampiran

Hal pertama yang dipersiapkan adalah file PDF itu sendiri. Untuk menyertakan file tersebut pada email, dilakukan dengan melakukan pembacaan keseluruhan konten file. Kemudian diencode-kan dalam bentuk base64 format, lalu dipecah dalam bagian-bagian kecil via chunk_split(). Hasilnya sudah siap untuk diikutkan pada konten email.

1
2
3
4
5

// File
$file = fopen($pdfLocation, 'rb');
$data = fread($file, filesize($pdfLocation));
fclose($file);
$pdf_content = chunk_split(base64_encode($data));

Kemudian pada bagian headers, hal utama yang harus dituliskan adalah Content-Type dengan nilai "multipart/mixed;" diteruskan dengan boundary sebagai penanda. Pada bagian messages untuk penyertaan file attachment, Content-Type menggunakan nilai "application/octet-stream" dilanjutkan dengan nama file PDF. Lalu Content-Disposition menggunakan nilai "attachment;".

Untuk mengakhiri perintah, setiap akhir perintah harus menyertakan PHP eol(End Of Line). Di sini dapat menggunakan "\r\n" sebagai pengganti penanda End Of Line.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

//boundary 
$uid = md5(time()); 
//headers for attachment 
$headers = "From:  $nama_pengirim <$pengirim>\r\n";
$headers .= "MIME-Version: 0\r\n";
$headers .= "Content-Type: multipart/mixed; boundary=\"".$uid."\"\r\n\r\n";
//text message
$messages = "--".$uid."\n";
$messages .= "Content-Type: text/html; charset=\"UTF-8\"\r\n";
$messages .= "Content-Transfer-Encoding: 7bit\n".$text_message."\r\n"; 
//for file attachment
$messages .= "--".$uid."\r\n";
$messages .= "Content-Type: application/octet-stream; name=\"".$pdfName."\"\r\n";
$messages .= "Content-Transfer-Encoding: base64\r\n";
$messages .= "Content-Description: ".$pdfName."\r\n";
$messages .= "Content-Disposition: attachment;\r\n";
$messages .= "filename=\"".$pdfName."\"\r\n\r\n".$pdf_content."\r\n\r\n";
$messages .= "--".$uid."\r\n";

Berikut isi file index.php secara keseluruhan yang digunakan untuk mengirimkan pesan email dan dilengkapi dengan file attachment dalam bentuk file PDF :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

<?php
// Settings
$penerima = "said490@gmail.com";
$pengirim = "no-reply@saidalfaruq.net";
$nama_pengirim = "said alfaruq";
$subject = "Your PDF email subject";
$pdfLocation = "pdf_test.pdf"; //pdf file location
$pdfName = "pdf_test.pdf"; // pdf file name recipient will get
$text_message = "<p>Email with PDF attachment</p>";
$text_message = "<p>Here your PDF file..</p>";
$text_message = wordwrap($text_message,70);
// File
$file = fopen($pdfLocation, 'rb');
$data = fread($file, filesize($pdfLocation));
fclose($file);
$pdf_content = chunk_split(base64_encode($data));
//boundary 
$uid = md5(time()); 
//headers for attachment 
$headers = "From:  $nama_pengirim <$pengirim>\r\n";
$headers .= "MIME-Version: 0\r\n";
$headers .= "Content-Type: multipart/mixed; boundary=\"".$uid."\"\r\n\r\n";
//text message
$messages = "--".$uid."\n";
$messages .= "Content-Type: text/html; charset=\"UTF-8\"\r\n";
$messages .= "Content-Transfer-Encoding: 7bit\n".$text_message."\r\n"; 
//for file attachment
$messages .= "--".$uid."\r\n";
$messages .= "Content-Type: application/octet-stream; name=\"".$pdfName."\"\r\n";
$messages .= "Content-Transfer-Encoding: base64\r\n";
$messages .= "Content-Description: ".$pdfName."\r\n";
$messages .= "Content-Disposition: attachment;\r\n";
$messages .= "filename=\"".$pdfName."\"\r\n\r\n".$pdf_content."\r\n\r\n";
$messages .= "--".$uid."\r\n";
ini_set('sendmail_from',$pengirim);
$return_path = "-".$pengirim;
// Send the email
$kirim = mail($penerima,$subject,$messages,$headers,$return_path);
if($kirim){
   echo "Email dengan PDF attachment berhasil dikirim.";
}else{
   echo "Ada kesalahan dalam pengiriman email.";
}
?>

Jika dijalankan, script diatas akan mengirimkan email beserta file PDF dengan nama "pdf_test.pdf". Berikut tampilan saat akun gmail dibuka dan email berhasil dikirimkan :

Saat pesan email dibuka :

Saat file PDF-nya dibuka :

Fungsi PHP mail() hanya akan berjalan baik jika dijalankan pada server (hosting) online. Jika dijalankan pada server localhost, fungsi ini tidak akan bekerja.

Demikian tutorial bagaimana cara mengirimkan email dengan melampirkan file PDF menggunakan fungsi php mail(). Semoga bermanfaat.

10 Jul 2022   0   1.264

Kategori : html - mysql - support - email