112 lines
5.9 KiB
PHP
112 lines
5.9 KiB
PHP
|
<?php
|
|||
|
|
/*
|
|||
|
|
mail(
|
|||
|
|
string $to,
|
|||
|
|
string $subject,
|
|||
|
|
string $message,
|
|||
|
|
array|string $additional_headers = [],
|
|||
|
|
string $additional_params = ""
|
|||
|
|
): bool
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
/*
|
|||
|
|
to
|
|||
|
|
Получатель, или получатели письма.
|
|||
|
|
Формат этого параметра должен соответствовать 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
|
|||
|
|
Тема отправляемого письма.
|
|||
|
|
Предостережение
|
|||
|
|
Тема должна соответствовать RFC 2047.
|
|||
|
|
|
|||
|
|
message
|
|||
|
|
Отправляемое сообщение.
|
|||
|
|
Каждая строка должна быть отделена символом CRLF (\r\n).
|
|||
|
|
Строки не должны быть длиннее 70 символов.
|
|||
|
|
additional_headers (необязательный)
|
|||
|
|
Строка или массив, которые будут вставлены в конец отправляемых заголовков письма.
|
|||
|
|
Обычно используется для добавления дополнительных заголовков (From, Cc, and Bcc).
|
|||
|
|
Несколько дополнительных заголовков должны быть разделены CRLF (\r\n).
|
|||
|
|
Если для составления этого заголовка используются внешние данные,
|
|||
|
|
то они должны быть проверены для избежания инъекций нежелательных заголовков.
|
|||
|
|
Если передан массив, то его ключи будут именами заголовка, а значения значениями.
|
|||
|
|
additional_params (необязательный)
|
|||
|
|
Параметр additional_params может быть использован для передачи дополнительных флагов
|
|||
|
|
в виде аргументов командной строки для программы сконфигурированной для отправки писем,
|
|||
|
|
указанной директивой sendmail_path. Например, можно установить отправителя письма
|
|||
|
|
при использовании sendmail с помощью опции -f.
|
|||
|
|
Параметр автоматически экранируется функцией escapeshellcmd(),
|
|||
|
|
чтобы не допустить выполнение команд. Но escapeshellcmd()
|
|||
|
|
позволяет добавлять дополнительные параметры. В целях безопасности рекомендуется проверять
|
|||
|
|
и очищать этот параметр.
|
|||
|
|
Так как escapeshellcmd() применяется автоматически, то нельзя использовать некоторые символы,
|
|||
|
|
допустимые к использованию в email-адресах некоторыми RFC. mail() не допускает такие символы,
|
|||
|
|
поэтому в программах, в которых они требуются, рекомендуется использовать альтернативы
|
|||
|
|
для их отправки (например фреймворки или библиотеки).
|
|||
|
|
Пользователь, под которым работает веб-сервер должен быть добавлен в список доверенных
|
|||
|
|
в конфигурации sendmail для того чтобы избежать добавления заголовка 'X-Warning'
|
|||
|
|
при указании отправителя с помощью опции (-f). Для пользователей sendmail
|
|||
|
|
- это файл /etc/mail/trusted-users.
|
|||
|
|
|
|||
|
|
Возвращает true, если письмо было принято для передачи, иначе false.
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
$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);
|
|||
|
|
|
|||
|
|
|
|||
|
|
/* Пример: Отправка HTML-сообщения */
|
|||
|
|
|
|||
|
|
// несколько получателей
|
|||
|
|
$to = 'johny@example.com, sally@example.com'; // обратите внимание на запятую
|
|||
|
|
|
|||
|
|
// тема письма
|
|||
|
|
$subject = 'Birthday Reminders for August';
|
|||
|
|
|
|||
|
|
// текст письма
|
|||
|
|
$message = '
|
|||
|
|
<html>
|
|||
|
|
<head>
|
|||
|
|
<title>Birthday Reminders for August</title>
|
|||
|
|
</head>
|
|||
|
|
<body>
|
|||
|
|
<p>Here are the birthdays upcoming in August!</p>
|
|||
|
|
<table>
|
|||
|
|
<tr>
|
|||
|
|
<th>Person</th><th>Day</th><th>Month</th><th>Year</th>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>Johny</td><td>10th</td><td>August</td><td>1970</td>
|
|||
|
|
</tr>
|
|||
|
|
<tr>
|
|||
|
|
<td>Sally</td><td>17th</td><td>August</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>';
|
|||
|
|
$headers[] = 'From: Birthday Reminder <birthday@example.com>';
|
|||
|
|
$headers[] = 'Cc: birthdayarchive@example.com';
|
|||
|
|
$headers[] = 'Bcc: birthdaycheck@example.com';
|
|||
|
|
|
|||
|
|
// Отправляем
|
|||
|
|
mail($to, $subject, $message, implode("\r\n", $headers));
|
|||
|
|
?>
|