array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'tr', ), 'this' => array ( 0 => 'function.mail.php', 1 => 'mail', ), 'up' => array ( 0 => 'ref.mail.php', 1 => 'Eposta İşlevleri', ), 'prev' => array ( 0 => 'function.ezmlm-hash.php', 1 => 'ezmlm_hash', ), 'next' => array ( 0 => 'book.mailparse.php', 1 => 'Mailparse', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'tr', 'path' => 'reference/mail/functions/mail.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
mail — Eposta gönderir
$kime
,$konu
,$ileti
,$ek_başlıklar
= [],$ek_bağımsız değişkenler
= ""Sends an email.
kime
Epostanın alıcısı veya alıcıları.
Bu dizgenin biçemi » RFC 2822'ye uygun olmalıdır. Bazı örnekler:
konu
Epostanın konusu.
Konu » RFC 2047'nin koşullarını yerine getirmelidir.
ileti
Gönderilecek ileti.
Her satır bir CRLF (\r\n) karakteri ile bitmeli ve 70 karakterden uzun olmamalıdır.
(Sadece Windows'ta) PHP, bir SMTP sunucu ile doğrudan konuşacaksa, bir satırın başında noktaya rastlanırsa bu nokta silinir. Bu hoşunuza gitmiyorsa bu noktaları çift nokta haline getirin.
<?php
$text = str_replace("\n.", "\n..", $text);
?>
ek_başlıklar
(seçimlik)Eposta başlığının sonuna yerleştirilecek string veya array türünde veri.
Bu genellikle ek başlıklar eklemek için kullanılır (From, Cc, Bcc gibi). Çok sayıda başlık eklenecekse bunlar birer CRLF (\r\n) ile birbirlerinden ayrılmalıdır. Bu başlığı oluşturmak için dış veriler kullanılıyorsa, istenmeyen başlıkların araya girmemesi için veriler elden geçirilip temizlenmelidir.
Bir dizi aktarılmışsa, anahtarları başlık isimleri, değerleri de ilgili başlık değerleri olmalıdır.
Bilginize:
Eposta gönderilirken bir
From
başlığı içermesi gerekir. Bu başlık, bu bağımsız değişken ile belirtilebileceği gibi öntanımlı gönderici adresini php.ini dosyasında da belirtmek mümkündür.Bunu yapmazsanız şöyle bir hata alırsınız:
Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing
(Uyarı: mail(): php.ini dosyasında "sendmail_from" atanmamış veya özel "From:" başlığı eksik).From
başlığı Windows altında doğrudan SMTP üzerinden gönderirkenReturn-Path
başlığını da tanımlar.
Bilginize:
Eğer ileti alınmazsa satırsonlarını CRLF (\r\n) ile değil sadece LF (\n) ile sonlandırmayı deneyin. Bazı düşük kaliteli Unix eposta sunucuları (en bilineni » qmail) LF karakterlerini otomatik olarak CRLF karakterleri ile değiştirir (CRLF kullanıldıysa sonuç CRCRLF olur). Bu yöntem » RFC 2822'ye uygun olmadığından başka çare yoksa kullanılmalıdır.
ek_bağımsız değişkenler
(seçimlik)
Eposta gönderirken kullanılan programa komut satırı seçenekleri
aktarmak için kullanılır. Eposta gönderme programının adı
sendmail_path
yapılandırma yönergesinde belirtilir.
Örneğin, sendmail kullanılıyorsa bu bağımsız değişkeni
-f
komut satırı seçeneği ile zarf gönderici adresini
belirtmek için kullanabilirsiniz.
Bu bağımsız değişken komut çalıştırmayı engellemek için dahili olarak escapeshellcmd() işlevi tarafından öncelenir, fakat işlev ek bağımsız değişkenler eklemeye izin verir. Güvenlik nedeniyle, kabuk komutuna istenmeyen bağımsız değişkenler eklenmesinden kaçınmak için bu bağımsız değişkenin kullanıcı tarafından elden geçirilip temizlenmesi önerilir.
escapeshellcmd() işlevi otomatik uygulandığından, internet RFCleri tarafından eposta adreslerinde izin verilen bazı karakterler kullanılamaz. mail() böyle karakterlere izin veremez, bu bakımdan bu tür karakterlerin kullanılmasının gerekli olduğu programlarda alternatif e-posta gönderme yöntemleri (bir iskelet veya kitaplık kullanmak gibi) önerilir.
Zarf göndericisinin (-f) bu bağımsız değişken ile belirtildiği durumda,
iletiye bir 'X-Warning
' başlığının eklenmemesi için
HTTP sunucusunu çalıştıran kullanıcının sendmail
yapılandırma dosyasını güvenilir kullanıcı olarak kaydedilmesi gerekir.
sendmail kullanıcıları için, bu dosyanın yeri:
/etc/mail/trusted-users.
Eposta sunucu tarafından başarıyla teslim alınmışsa true
, aksi takdirde
false
döner.
Yalnız şuna dikkat edin: Epostanın sunucu tarafından teslim alınması, epostanın alıcısına ulaştığı anlamına gelmez.
Sürüm: | Açıklama |
---|---|
7.2.0 |
ek_başlıklar bağımsız değişkeni artık dizi de kabul ediyor.
|
Örnek 1 - Eposta gönderimi
mail() işlevi ile basit bir eposta gönderelim:
<?php
// İleti
$ileti = "Line 1\r\nLine 2\r\nLine 3";
// Satırlarımızın 70 karakterden uzun olanlarını katlamamız lazım
$ileti = wordwrap($ileti, 70, "\r\n");
// Epostayı gönderelim
mail('kafeinli@example.com', 'İleti konusu', $ileti);
?>
Örnek 2 - Ek başlıklarla eposta gönderimi
From ve Reply-To adreslerini ek başlıklar olarak belirtelim:
<?php
$kime = 'nobody@example.com';
$konu = 'konu';
$ileti = 'Merhaba';
$başlıklar = 'From: webmaster@example.com' . "\r\n" .
'Reply-To: webmaster@example.com' . "\r\n" .
'X-Mailer: PHP/' . phpversion();
mail($kime, $konu, $ileti, $başlıklar);
?>
Örnek 3 - array türünde ek başlıklarla eposta gönderimi
Bu örnekte, üst örnekteki eposta gönderilmekte, ancak ek başlıklar bir dizi olarak aktarılmaktadır (PHP 7.2.0 ve sonrasında kullanılabilir).
<?php
$kime = 'nobody@example.com';
$konu = 'konu';
$ileti = 'Merhaba';
$başlıklar = array(
'From' => 'webmaster@example.com',
'Reply-To' => 'webmaster@example.com',
'X-Mailer' => 'PHP/' . phpversion()
);
mail($kime, $konu, $ileti, $başlıklar);
?>
Örnek 4 - Ek komut satırı seçenekleriyle eposta gönderimi
sendmail_path
yönergesinde belirtilen posta gönderme
programına komut satırı bağımsız değişkenleri aktarmak için
ek_bağımsız değişkenler
bağımsız değişkeni kullanılabilir.
<?php
mail('nobody@example.com', 'the subject', 'the message', null,
'-fwebmaster@example.com');
?>
Örnek 5 - HTML eposta gönderimi
mail() işleviyle HTML eposta göndermek de mümkündür.
<?php
// çok sayıda alıcı
$to = 'johny@example.com, sally@example.com'; // virgüle dikkat
// konu
$subject = 'Ağustos ayında hatırlanacak doğum günleri';
// ileti
$message = '
<html>
<head>
<title>Ağustos ayında hatırlanacak doğum günleri</title>
</head>
<body>
<p>Ağustos ayındaki doğum günleri!</p>
<table>
<tr>
<th>Kişi</th><th>Gün</th><th>Ay</th><th>Yıl</th>
</tr>
<tr>
<td>Ali</td><td>3</td><td>Ağustos</td><td>1970</td>
</tr>
<tr>
<td>Veli</td><td>17</td><td>Ağustos</td><td>1973</td>
</tr>
</table>
</body>
</html>
';
// HTML eposta göndermek için, the Content-type başlığı belirtilmeli
$headers[] = 'MIME-Version: 1.0';
$headers[] = 'Content-type: text/html; charset=utf-8';
// Ek başlıklar
+$headers[] = 'To: Mary <mary@example.com>, Kelly <kelly@example.com>';
+$headers[] = 'From: Birthday Reminder <birthday@example.com>';
+$headers[] = 'Cc: birthdayarchive@example.com';
+$headers[] = 'Bcc: birthdaycheck@example.com';
// İletiyi postalayalım
mail($to, $subject, $message, implode("\r\n", $headers));
?>
Bilginize:
HTML veya daha karmaşık bir eposta göndermek isterseniz » PEAR::Mail_Mime PEAR paketini kullanmanızı öneririz.
Bilginize:
mail() işlevinin Windows SMTP gerçeklenimi bir çok bakımdan sendmail gerçekleniminden farklıdır. Birincisi, iletileri göndermek için yerel bir program kullanılmaz, doğrudan soketlerle çalışılır ve MTA'nın soketi dinlediği varsayılır.
İkincisi,
From:
,Cc:
,Bcc:
veDate:
gibi özel başlıklar, epostayı ilk alan MTA tarafından yorumlanmaz, fakat PHP tarafından çözümlenir.Aslında,
to
bağımsız değişkeninin "Adı Soyad <birisi@example.com>" biçeminde bir adres olmaması gerekir. mail komutu MTA ile anlaşırken bunu gerektiği gibi çözümleyemeyebilir.
Bilginize:
Çok sayıda epostayı göndermek için mail() işlevini bir döngüye sokmak hiç de iyi bir fikir değildir. Bu işlev her eposta için SMTP soketini açıp kapadığından verimli değildir.
Çok sayıda eposta göndermek için, » PEAR::Mail ve » PEAR::Mail_Queue paketlerine bakınız.
Bilginize:
Şu RFC'ler yararlı olabilir: » RFC 1896, » RFC 2045, » RFC 2046, » RFC 2047, » RFC 2048, » RFC 2049 ve » RFC 2822.