Birthday Reminders for August

mail

Каждая строка должна быть отделена символом CRLF (\r\n). Строки не должны быть длиннее 70 символов.

(Только для Windows) Если PHP передаёт данные напрямую SMTP-серверу и в начале строки стоит точка, то она будет удалена. Чтобы избежать этого замените все такие точки на две.

Строка, которая будет дополнительно вставлена в конец отправляемых заголовков письма.

Обычно используется для добавления дополнительных заголовков (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.

Замечание:

Если сообщения не отправляются, попробуйте использовать только LF (\n). Некоторые агенты пересылки сообщений Unix (особенно » qmail) автоматически заменяют LF на CRLF (что приводит к двойному CR, если использовалось CRLF). Используйте эту меру в крайнем случае, так как это нарушает » RFC 2822.

Параметр additional_parameters может быть использован для передачи дополнительных флагов в виде аргументов командной строки для программы сконфигурированной для отправки писем, указанной директивой sendmail_path. Например, можно установить отправителя письма при использовании sendmail с помощью опции -f.

Параметр автоматически экранируется функцией escapeshellcmd() , чтобы не допустить выполнение команд. Но escapeshellcmd() позволяет добавлять дополнительные параметры. В целях безопасности рекомендуется проверять и очищать этот параметр.

Так как escapeshellcmd() применяется автоматически, то нельзя использовать некоторые символы, допустимые к использованию в email-адресах некоторыми RFC. mail() не допускает такие символы, поэтому в программах, в которых они требуются, рекомендуется использовать альтернативы для их отправки (например фреймворки или библиотеки).

Пользователь, под которым работает веб-сервер должен быть добавлен в список доверенных в конфигурации sendmail для того чтобы избежать добавления заголовка ‘X-Warning’ при указании отправителя с помощью опции (-f). Для пользователей sendmail — это файл /etc/mail/trusted-users .

Возвращаемые значения

Возвращает TRUE , если письмо было принято для передачи, иначе FALSE .

Важно заметить, что то что письмо было принято для передачи вовсе НЕ означает что оно достигло получателя.

Список изменений

Версия	Описание
4.2.3	Параметр additional_parameters отключен в режиме safe_mode и при его использовании функция mail() вызовет предупреждение и вернет FALSE .

Примеры

Пример #1 Отправка письма.

Использование функции mail() для отправки простого письма:

// Сообщение
$message = «Line 1\r\nLine 2\r\nLine 3» ;

// На случай если какая-то строка письма длиннее 70 символов мы используем wordwrap()
$message = wordwrap ( $message , 70 , «\r\n» );

// Отправляем
mail ( ‘caffeinated@example.com’ , ‘My Subject’ , $message );
?>

Пример #2 Отправка письма с дополнительными заголовками.

Добавление простых заголовков, сообщающих почтовому агенту адреса From и Reply-To:

$to = ‘nobody@example.com’ ;
$subject = ‘the subject’ ;
$message = ‘hello’ ;
$headers = ‘From: webmaster@example.com’ . «\r\n» .
‘Reply-To: webmaster@example.com’ . «\r\n» .
‘X-Mailer: PHP/’ . phpversion ();

mail ( $to , $subject , $message , $headers );
?>

Пример #3 Отправка письма с дополнительными аргументами командной строки.

Параметр additional_parameters может быть использован для передачи дополнительных параметров программе, используемой для отправки писем с помощью директивы sendmail_path.

Пример #4 Отправка HTML-сообщения

С помощью функции mail() также можно отправить и HTML-письмо.

// несколько получателей
$to = ‘aidan@example.com’ . ‘, ‘ ; // обратите внимание на запятую
$to .= ‘wez@example.com’ ;

// тема письма
$subject = ‘Birthday Reminders for August’ ;

// текст письма
$message = ‘

Here are the birthdays upcoming in August!

Person	Day	Month	Year
Joe	3rd	August	1970
Sally	17th	August	1973

‘ ;

// Для отправки HTML-письма должен быть установлен заголовок Content-type
$headers = ‘MIME-Version: 1.0’ . «\r\n» ;
$headers .= ‘Content-type: text/html; charset=iso-8859-1’ . «\r\n» ;

// Дополнительные заголовки
$headers .= ‘To: Mary , Kelly ‘ . «\r\n» ;
$headers .= ‘From: Birthday Reminder ‘ . «\r\n» ;
$headers .= ‘Cc: birthdayarchive@example.com’ . «\r\n» ;
$headers .= ‘Bcc: birthdaycheck@example.com’ . «\r\n» ;

// Отправляем
mail ( $to , $subject , $message , $headers );
?>

Замечание:

Для отправки HTML или других комплексных сообщений рекомендуется использовать PEAR-пакет » PEAR::Mail_Mime.

Примечания

Замечание:

Реализация функции mail() в Windows во многом отличается от реализации в Unix. Во-первых, она не использует локальную программу для составления писем, а работает непосредственно с сокетами, что означает что необходим почтовый агент (MTA), ожидающий соединений на сокете (может быть как на локальном так и на удаленном сервере).

Во-вторых, дополнительные заголовки вроде: From:, Cc:, Bcc: и Date: интерпретируются в первую очередь не, MTA, а PHP.

Поэтому параметр to не должен быть адресом вида «Something «. Команда mail может неправильно интерпретировать этот адрес во время передачи данных MTA.

Замечание:

Не следует использовать функцию mail() для отправки большого количества писем в цикле. Функция открывает и закрывает соединение с SMTP-сервером для каждого письма, что не очень эффективно.

Для отправки большого количества сообщений обратите внимание на пакеты » PEAR::Mail и » PEAR::Mail_Queue.

Смотрите также

Источник

How to Test and Fix the php mail() Function

The php mail() function allows you to send emails directly from a php script.
This tutorial shows you how to test if php mail is working correctly.

Test php mail() on your Web Server

1. Create a php test file using a text editor and save it e.g. as test.php:

$sender = ‘ someone@somedomain.tld ‘;
$recipient = ‘ you@yourdomain.tld’ ;

$subject = «php mail test»;
$message = «php test message»;
$headers = ‘From:’ . $sender;

if (mail($recipient, $subject, $message, $headers))
echo «Message accepted»;
>
else
echo «Error: Message not accepted»;
>
?>

2. Change the $sender and $recipient in the code.

3. Upload the php file to your webserver.

4. Open the uploaded php file in your browser to execute the php script.

5. The output show either «Message accepted» or «Error: Message not accepted».

chevron_right Message accepted:

Open your mail client to see if the message was delivered to the specified email address.
(also check your spam folder!)

If the message was delivered:

If the message was not delivered:

• Some provider don’t allow external recipients when using php mail. Change the recipient ($recipient) in the code to a local recipient. This means use an email address from the server’s domain, for example if your server domain is www.yourdomain.tld then the recipient’s email should be someone@yourdomain.tld.
• Upload the modified php file and retry.
• If it’s still not working: change the sender ($sender) to a local email (use the same email as used for recipient).
• Upload the modified php file and retry.
• Contact your provider if it still does not work.
  Tell your provider that the standard php «mail()» function returns TRUE, but not mail will be sent.
  It’s recommended to include the used php test script to show your provider, that the problem is not caused by the php script used.

chevron_right Error: Message not accepted

php mail might not be enabled:

• Login to your webserver configuration and check the php settings.
  Some php installations require that you setup a default sender in the php configuration first.

Some provider don’t allow external recipients when using php mail:

• Change the recipient ($recipient) in the code to a local recipient. This means use an email address from the server’s domain, for example if your server domain is www.yourdomain.tld then the recipient’s email should be someone@yourdomain.tld.
• Upload the modified php file and retry.
• If it’s still not working: change the sender ($sender) to a local email (use the same email as used for recipient).
• Upload the modified php file and retry.

If you have checked the php settings, tried a local recipient and it’s still not working:

• Contact your provider if you are unable to enable php mail().
  Tell your provider that the standard php «mail()» function returns FALSE.
  It’s recommended to include the used php test script to show your provider, that the problem is not caused by the php script used.

Disclaimer: The information on this page is provided «as is» without warranty of any kind. Further, Arclab Software OHG does not warrant, guarantee, or make any representations regarding the use, or the results of use, in terms of correctness, accuracy, reliability, currentness, or otherwise. See: License Agreement

• ©1997-2023 Arclab®. All other trademarks and brand names are the property of their respective owners.
• info_outline
• fingerprint Cookies & Privacy

Источник