Поща

(PHP4, PHP5)

mail - изпращане на поща

Описание

bool mail ( string $to, string $subject, string $message [, string $additional_headers [, string $additional_parameters]] )

Параметри

Получател или получатели на писмото.

Форматът на този параметър трябва да отговаря на » RFC 2822. Ето някои примери:

user@example.com
user@example.com, anotheruser@example.com
User <user@example.com>
User <user@example.com>, Another User <anotheruser@example.com>

subject

Тема на писмото.

Забележка: този параметър не може да съдържа символи за нов ред, в противен случай писмото няма да бъде изпрането коректно.

message

Съобщението, което ще бъде изпратено.

Всеки ред трябва да бъде разделен с LF (\n). Редовете не могат да бъдат по дълки от 70 симвора.

Забележка: (Единствено за Windows) При контакта на PHP с SMTP съсвър е възможно да се случи преждевременно прекратяване на съобщението ако в началото на реда бъде открито ".\n" (точка последвана от символ за нов ред - по този начин в SMTP протокола се отбелязва край на предаването). За да се избегне това е хубаво точката да се замени с двуеточие.

<?php
$text = str_replace("\n." , "\n.." , $text);
?>

additional_headers (не е задължително)

Текст, който да бъде добавен в края на заглавната част.

Обикновено се използва за разширение на заглавната част (From, Cc, and Bcc). Повече от едно разширения трябва да бъдат разделени с CRLF (\r\n).

Бележка: Когато се изпраща писмо, то задължително трябва да съдържа From (От) заглавна част. Тя може да бъде посочена или чрез additional_headers или да бъде зададена подразбираща се такава в php.ini.

Ако горното не бъде направено, резултатът ще бъде грешка подобна на: Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing. From заглавната част задава също Return-Path в Windows.

additional_parameters (не е задължително)

Този параметър може да бъде използван, за да се добавят допълнителни параметри за програмата конфигурирана да функционира, когата изпращането използва sendmail_path настройките.

Върната стойност

True, когато писмото успешно е прието за доставка и false в противен случай.

Важно е да се отбележи, че това, че писмото е прието за доставка още не означава, че е достигнало предназначението си.

Примери

	Използване на mail() за изпращане на писмо:
	<?php //Съобщението $message = "Line 1\nLine 2\nLine3"; // В случай, че някой от редовете е по дъпък от 70 символа, трябва да използвме wordwrap() $message = wordwrap($message,70); // Изпращане mail('caffinated@example.com','My Subject', $message); ?>

Възможно е също да се изпраща HTML поща чрез mail()

<?php
// много получатели
$to = 'aidan@example.com' .', ';
$to .= 'wez@example.com';

//отностно
$subject = 'Birthday Reminders for August';

//съобщение
$message = '
<html>
<head>
<title>Подсетки за рождени дни през Август</title>
</head>
<body>
<p>Следват рождените дни през август!</p>
<table>
    <tr>
     <th>На кой</th><th>Ден</th><th>Месец</th><th>Година</th>
    </tr>
    <tr>
      <td>Joe</td><td>3rd</td><td>Август</td><td>1970</td>
    </tr>
    <tr>
      <td>Sally</td><td>17th</td><td>Августt</td><td>1973</td>
    </tr>
</table>
</body>
</html>
';

//За да се изпрати HTML писмо, Content-type заглавната част трябвада бъде зададена
$headers = 'MIME-Version: 1.0' . "\r\n";
$headers .= 'Content-type: text/html; charset=iso-8859-1' . "\r\n";

//Допълнителни заглавни части
$headers .= 'To: Mary <mary@example.com>, Kelly <kelly@example.com>' . "\r\n";
$headers .= 'From: Birthday Reminder <birthday@example.com>' . "\r\n";
$headers .= 'Cc: birthdayarchive@example.com' . "\r\n";
$headers .= 'Bcc: birthdaycheck@example.com' . "\r\n";

// Изпраща се
mail($to, $subject, $message, $headers);

коментари

добави коментар