View this page in	Last updated: Sun, 18 Oct 2009
English \| Brazilian Portuguese \| Chinese \| Dutch \| French \| German \| Hungarian \| Japanese \| Polish \| Russian \| Spanish \| Turkish

Mail::send()

Mail::send() – E-mail elküldése

Synopsis

require_once 'Mail.php';

mixed send ( mixed $recipients , array $headers , string $body )

Description

E-mail elküldése. A send() függvényt a factory() függvény által visszaadott objektum biztosítja.

Parameter

mixed $recipients - egy tömb, vagy egy vesszővel elválasztott sztring a címzettekkel
array $headers - e-mail fejlécek asszociatív tömbje. A fejléc nevének a tömb kulcsa, a fejléc értékének a tömb értéke felel meg.
string $body - az e-mail tartalma.

Return value

boolean - TRUE vagy egy PEAR_Error objektum hiba esetén

Throws

**Possible PEAR_Error values**
Mailer driver	Hibakód	Hibaüzenet	Ok	Megoldás
sendmail/smtp	NULL	"No from address given."	A `$headers` tömbben legalább egy `from` elemet meg kell adni.	From elem hozzáadása: `<?php $headers['From'] = 'mymail@example.com'; ?>`
sendmail	NULL	"From address specified with dangerous characters."	A `$headers` tömb From eleme egy vagy több olyan karaktert tartalmaz, amely elképzelhető, hogy nem felel meg az RFC követelményeknek.	Ellenőrizzük a megadott From címet, hogy nem tartalmaz-e szóközt, pontosvesszőt (`;`), és-jelet (`&`) vagy backtick-et (`).
sendmail	NULL	"sendmail [`elérési út` ] not executable"	A sendmail programhoz megadott elérési út nem megfelelő. A megadott útvonalon nem található a sendmail futtatható fájlja.	Ellenőrizzük a Mail::factory() függvény meghívásakor átadott `$param['sendmail_path']` elem értékét. Ha másik levélküldő programot használunk (pl. qmail), ellenőrizzük a telepített programot. Alapesetben tartalmaznia kellene egy sendmail wrapper-t.
sendmail	NULL	"sendmail returned error code `kód` "	A sendmail hibával tért vissza, amelyet le kell kezelnünk.	Lásd a levélküldő program dokumentációját.
smtp	NULL	"unable to instantiate Net_SMTP object"	Hiba történt a példány létrehozása során.	Telepítsük újra/frissítsük a Net_SMTP csomagot.
smtp	NULL	"unable to connect to smtp server `host:port` "	Az SMTP szerverhez történő csatlakozás meghiúsult	Ellenőrizzük a `$param['port']` és a `$param['host']` elemeket a Mail::factory() függvény meghívásánál.
smtp	NULL	"unable to authenticate to smtp server"	A hitelesítés meghiúsult	Ellenőrizzük a `$param['auth']` , `$param['username']` és `$param['password']` elemeket a Mail::factory() függvény meghívásánál. Győződjünk meg róla, hogy a megfelelő hitelesítési módot használjuk az SMTP szerverhez.
smtp	NULL	"unable to identify smtp server"	Nem sikerült megkezdeni a kérés továbbítását az SMTP szerverhez	Ellenőrizzük, hogy az SMTP szerver megfelel-e az RFC előírásoknak.
smtp	NULL	"unable to set sender to `feladó` "	A feladó címének elküldése nem járt sikerrel.	Ellenőrizzük a feladó e-mail címének szabványosságát és a szerver csatlakozását.
smtp	NULL	"unable to add recipient `címzett` :`hibakód` "	A címzett címének hozzáadása nem járt sikerrel	Ellenőrizzük a címzett címének szabványosságát és a szerver csatlakozását.
smtp	NULL	"unable to send data"	Az e-mail tartalmát (szövegét) nem sikerült elküldeni.	Ellenőrizzük az e-mail tartalmának szabványosságát és a szerver csatlakozását.

Note

This function can not be called statically.

Example


<?php
include 'Mail.php';

$cimzettek = 'joe@example.com';

$fejlecek['From']    = 'richard@example.com';
$fejlecek['To']      = 'joe@example.com';
$fejlecek['Subject'] = 'Teszt &uuml;zenet';

$tartalom = 'Teszt &uuml;zenet';

$parameterek['sendmail_path'] = '/usr/lib/sendmail';

// Objektum l&eacute;trehoz&aacute;sa a Mail::factory() met&oacute;dus seg&iacute;ts&eacute;g&eacute;vel
$mail_objektum =& Mail::factory('sendmail', $parameterek);

$mail_objektum->send($cimzettek, $fejlecek, $tartalom);
?>

Ha Bcc:-ként is kívánunk címzetteket megadni, a cimzettek változónak asszociatív tömbnek kell lennie:


<?php
include('Mail.php');
 
$cimzettek = array('To' => 'joe@example.com',
                   'Bcc' => 'jane@example.com');
 
$fejlecek['From']    = 'richard@example.com';
$fejlecek['To']      = 'joe@example.com';
$fejlecek['Subject'] = 'Teszt &uuml;zenet';
 
$tartalom = 'Teszt &uuml;zenet';
 
$parameterek['sendmail_path'] = '/usr/lib/sendmail';
 
// Objektum l&eacute;trehoz&aacute;sa a Mail::factory() met&oacute;dus seg&iacute;ts&eacute;g&eacute;vel
$mail_objektum =& Mail::factory('sendmail', $parameterek);
 
$mail_objektum->send($cimzettek, $fejlecek, $tartalom);
?>

See

Mail::factory()

Mail::factory() (Previous) (Next) RFC822 - Introduction

Download Documentation	Last updated: Sun, 18 Oct 2009
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
Note by: undisclosed-recipients 2009-11-10 17:33 UTC If you are using smtp to send out the mail, and the To: field shows "undisclosed-recipients:", please remember to add $headers['To'] = "Recipient <recipient@host.com>" to your headers. Note by: burak a.t toruko d.o.t com 2008-04-26 02:33 UTC Just a correction for my previous message. These two lines: $From = "From: ".$from_name." <fromaddress@domain.com>"; $To = "To: ".$to_name." <toaddress@domain.com>"; should read: $From = $from_name." <fromaddress@domain.com>"; $To = $to_name." <toaddress@domain.com>"; Note by: burak a.t toruko d.o.t com 2008-04-20 07:37 UTC You can combine PEAR::Mail with mb_string functions to send valid Japanese(ISO-2022-JP) emails via SMTP connection: <?php $from_name = "黒沢　明"; // Japanese name $to_name = "三船　敏郎"; // Another Japanese name $subject = "日本語メールのテスト"; // Japanese subject $mailmsg = "これは日本語のメッセージです。文字化けのテストを行います。"; //Convert encodings of subject, sender, recipient and message body to ISO-20222-JP $from_name = mb_encode_mimeheader($from_name, "ISO-2022-JP", "Q"); $to_name = mb_encode_mimeheader($to_name, "ISO-2022-JP", "Q"); $subject = mb_encode_mimeheader($subject, "ISO-2022-JP", "Q"); $mailmsg = mb_convert_encoding($mailmsg, "ISO-2022-JP", "AUTO"); $From = "From: ".$from_name." <fromaddress@domain.com>"; $To = "To: ".$to_name." <toaddress@domain.com>"; $recipients = "toaddress@domain.com"; $headers["From"] = $From; $headers["To"] = $To; $headers["Subject"] = $subject; $headers["Reply-To"] = "reply@address.com"; $headers["Content-Type"] = "text/plain; charset=ISO-2022-JP"; $headers["Return-path"] = "returnpath@address.com"; $smtpinfo["host"] = "smtp.server.com"; $smtpinfo["port"] = "25"; $smtpinfo["auth"] = true; $smtpinfo["username"] = "smtp_user"; $smtpinfo["password"] = "smtp_password"; $mail_object =& Mail::factory("smtp", $smtpinfo); $mail_object->send($recipients, $headers, $mailmsg); ?> Tested the script and the E\email sent correctly to: Japanese Outlook Express, Outlook 2000/2003, Japanese Thunderbird, Becky, several Docomo mobiles, several Softbank mobiles. Note by: David Lidstone 2007-08-04 15:40 UTC Warning... Depending (I'm guessing) on your SMTP MTA some emails can be sent without dates and some with, unless you specify a date in the header. For example, my _locally_ delivered mail was ending up at the bottom of people's inboxes because it had a date of 1970. External mail was fine (header added by MTA?). Add this header to fix: 'Date' => date("r") Note by: arminfrey@gmail.com 2007-07-08 05:13 UTC In order to send e-mail to cc or bcc with smtp you have to list the cc e-mail address both as a recipient (which decides where the e-mail is sent) and in the cc header, which tells the mail client how to display it. Here is the code I use: $to = 'to@example.com'; $cc = 'cc@example.com'; $recipients = $to.", ".$cc; $headers['From'] = 'from@example.com'; $headers['To'] = $to; $headers['Subject'] = 'Test message'; $headers['Cc'] = 'cc@example.com'; $headers['Reply-To'] = 'from@example.com'; $send = $mail->send($recipients, $headers, $body); Note by: James Leckie 2007-06-24 11:24 UTC To handle errors when sending mail use the following. Great for checking if the SMTP server accepted all the addresses. $send = $mail->send($to, $headers, $body); if (PEAR::isError($send)) { print($send->getMessage());} Note by: Mike Soh 2007-06-08 10:20 UTC It is important to note that the mail->send() function will wait for the socket to close. Your script may sit for a long time waiting for sendmail/mail/etc to exit. You may prefer to store the mail information to be processed at a later time.