Отправка почты из PHP: mail(), PHPMailer и Symfony Mailer
PHP может передать письмо почтовой системе через встроенную функцию mail() или подключиться к SMTP-серверу через библиотеку. Ниже показано, как отправить письмо каждым способом и выяснить, где оно задержалось, если получатель его не увидел.
Как устроена отправка письма из PHP
Скрипт формирует письмо и передаёт его почтовому транспорту. Тот принимает сообщение, ставит его в очередь или сразу пытается связаться с сервером получателя. Успешное завершение PHP-вызова означает, что транспорт принял сообщение на своём этапе. Дальше возможны задержка, отказ и фильтрация в спам.
| Способ | Куда передаёт письмо | Когда выбирать |
|---|---|---|
mail() | Локальной почтовой программе, а на Windows обычно SMTP-серверу из php.ini | На хостинге уже настроена отправка и нужны простые уведомления |
| PHPMailer | SMTP-серверу с аутентификацией и TLS | Скрипту или приложению нужен SMTP, HTML или вложения |
| Symfony Mailer | Транспорту из конфигурации, например SMTP | В проекте уже есть Symfony или нужна единая конфигурация почты для разных сред |
Запрос send php обычно сводится к одному из двух вызовов: у PHPMailer это $mail->send(), у Symfony Mailer — $mailer->send($email). В обоих случаях сначала задают транспорт, отправителя и получателя.
PHP mail(): отправка простого текстового письма
mail() принимает адрес получателя, тему, тело и дополнительные заголовки. Пример предполагает настроенную почту на сервере. Замените адреса на реальные, а в From укажите адрес, с которого ваш сервер или провайдер разрешает отправлять.
<?php
declare(strict_types=1);
$to = 'reader@example.net';
$from = 'notify@example.com';
$subject = 'Заявка принята';
$body = "Здравствуйте!\r\nМы получили вашу заявку.\r\n";
// Кодируем короткую тему и тело по правилам MIME.
$encodedSubject = '=?UTF-8?B?' . base64_encode($subject) . '?=';
$headers = [
'From' => $from,
'MIME-Version' => '1.0',
'Content-Type' => 'text/plain; charset=UTF-8',
'Content-Transfer-Encoding' => 'quoted-printable',
];
if (!mail($to, $encodedSubject, quoted_printable_encode($body), $headers)) {
throw new RuntimeException('Почтовый транспорт не принял письмо');
}Ручное кодирование темы здесь рассчитано на короткую фиксированную строку. Длинные темы требуют корректного разбиения MIME-заголовка. Для произвольных тем, HTML, вложений и нескольких представлений письма удобнее библиотека. Она собирает MIME-структуру и кодирует заголовки сама.
Где PHP берёт настройки почты
- На Linux и других Unix-подобных системах
sendmail_pathзадаёт команду передачи письма. Эту команду может предоставлять локальный почтовый сервер или программа, которая пересылает сообщения на внешний релей. - На Windows встроенный SMTP-режим использует параметры
SMTPиsmtp_port. Для SMTP с логином, паролем и TLS используйте библиотеку. - PHP из командной строки, PHP-FPM и Apache могут читать разные настройки. Если скрипт работает в терминале, а веб-форма падает, проверьте загруженный
php.iniименно в веб-процессе.
У mail() результат true означает, что письмо принято к дальнейшей отправке. При false проверьте журнал ошибок PHP и настройки транспорта. Если результат true, ищите письмо в очереди и журнале почтового сервера. Не подавляйте предупреждения оператором @: они помогают найти ошибку конфигурации.
PHPMailer: отправка через SMTP с TLS
Установите пакет Composer и подключите автозагрузчик. Для самостоятельного скрипта ниже файл лежит в корне проекта рядом с каталогом vendor. Перед запуском передайте процессу переменные окружения SMTP_HOST, SMTP_USER и SMTP_PASSWORD.
composer require phpmailer/phpmailer<?php
declare(strict_types=1);
use PHPMailer\PHPMailer\PHPMailer;
require __DIR__ . '/vendor/autoload.php';
$host = getenv('SMTP_HOST');
$user = getenv('SMTP_USER');
$password = getenv('SMTP_PASSWORD');
if (!$host || !$user || $password === false || $password === '') {
throw new RuntimeException('Заполните настройки SMTP');
}
// Включаем исключения для ошибок сборки и отправки.
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = $host;
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = $user;
$mail->Password = $password;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->CharSet = PHPMailer::CHARSET_UTF8;
$mail->setFrom('notify@example.com', 'Уведомления');
$mail->addAddress('reader@example.net');
$mail->Subject = 'Заявка принята';
$mail->isHTML(true);
$mail->Body = '<p>Мы получили вашу заявку.</p>';
$mail->AltBody = 'Мы получили вашу заявку.';
$mail->send();Порт 587 с ENCRYPTION_STARTTLS начинает обычный SMTP-сеанс и переводит его на TLS. Если провайдер требует TLS с самого подключения, обычно используют порт 465 и PHPMailer::ENCRYPTION_SMTPS. Меняйте порт и режим вместе по настройкам провайдера. При ошибке сертификата проверьте имя сервера, системное время и доверенные корневые сертификаты. Оставьте проверку сертификата включённой.
Для вложения вызовите $mail->addAttachment($path, 'receipt.pdf') до отправки. Путь должен указывать на доступный файл, выбранный приложением. Если файл загрузил пользователь, сначала проверьте загрузку, размер и допустимый тип. При обработке исключения PHPMailer запишите детали в закрытый журнал и покажите пользователю короткое сообщение об ошибке.
Symfony Mailer: отправка письма через транспорт из конфигурации
Компонент работает и вне Symfony Framework. В самостоятельном скрипте передайте MAILER_DSN через окружение процесса. Для SMTP в строке конфигурации указываются схема, учётные данные, сервер и порт. Схема smtps задаёт TLS с начала соединения. При сборке DSN кодируйте логин и пароль функцией rawurlencode() по отдельности, чтобы спецсимволы не воспринимались как разделители. В приложении Symfony эту конфигурацию обычно читает фреймворк, а сервис получает MailerInterface через внедрение зависимостей.
composer require symfony/mailer<?php
declare(strict_types=1);
use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
use Symfony\Component\Mailer\Mailer;
use Symfony\Component\Mailer\Transport;
use Symfony\Component\Mime\Email;
require __DIR__ . '/vendor/autoload.php';
$dsn = getenv('MAILER_DSN');
if ($dsn === false || $dsn === '') {
throw new RuntimeException('Задайте MAILER_DSN');
}
$mailer = new Mailer(Transport::fromDsn($dsn));
$email = (new Email())
->from('notify@example.com')
->to('reader@example.net')
->subject('Заявка принята')
->text('Мы получили вашу заявку.')
->html('<p>Мы получили вашу заявку.</p>');
try {
$mailer->send($email);
} catch (TransportExceptionInterface $error) {
// Записываем диагностику в закрытый журнал приложения.
error_log($error->getMessage());
throw new RuntimeException('Ошибка отправки письма', 0, $error);
}Пример отправляет письмо синхронно. Если в приложении включена асинхронная маршрутизация писем через Symfony Messenger, вызов может лишь поставить задание в очередь. Тогда проверьте работу воркера и журнал неудачных заданий: SMTP-ошибка возникнет при обработке сообщения.
Что учитывать в PHP 8.3–8.5
- Сигнатура
mail()и массив заголовков из примера подходят для PHP 8.3, 8.4 и 8.5.declare(strict_types=1)помогает обнаруживать неверные типы при вызове типизированных функций. Формат адреса и содержимое заголовка проверяются отдельно. - В PHP 8.4 появился параметр
mail.mixed_lf_and_crlf. Он возвращает прежнее смешанное поведение с переводами строк для совместимости с отдельными почтовыми системами. Если сбой появился после перехода с 8.3 на 8.4 или 8.5, проверьте требования локального транспорта к окончаниям строк перед изменением параметра. - Совместимость библиотек зависит от их ветки и версии PHP, которой Composer разрешает зависимости. Если Composer запускается на PHP 8.5, а приложение работает на 8.3, разрешайте зависимости под 8.3 и проверяйте зафиксированные версии на целевых средах.
composer check-platform-reqsпроверяет реальный PHP и расширения в среде запуска команды.
Типичные ошибки при отправке и доставке
- Тайм-аут или отказ в соединении. Проверьте доступность SMTP-хоста и порта с сервера или из контейнера приложения. Локальная машина и продакшен могут иметь разные сетевые ограничения. Ошибка TLS сразу после подключения часто указывает на несовпадение порта и режима шифрования.
- SMTP отвечает 535. Сервер отклонил аутентификацию. Проверьте логин, пароль приложения, если он нужен, и разрешение SMTP-доступа для этой учётной записи. После смены секретов проверьте окружение процесса, который реально отправляет письма.
- SMTP отвечает 550. Прочитайте полный ответ и найдите этап отказа. Ошибка на
MAIL FROMможет означать, что учётной записи запрещён адрес отправителя, а наRCPT TO— что сервер отказался принимать указанного получателя. Для ответов4xxпредусмотрите ограниченные повторы с задержкой. При5xxсначала устраните причину отказа. - Письмо приняли, но его нет во входящих. Проверьте очередь, сообщения о недоставке и папку «Спам». Для домена отправителя проверьте SPF, DKIM и DMARC. DMARC требует, чтобы домен, прошедший проверку SPF или DKIM, был согласован с доменом видимого
From. - Кириллица отображается некорректно. Сохраните исходник и шаблоны в UTF-8. Для
mail()отдельно проверьте кодирование темы,charsetтела и егоContent-Transfer-Encoding. В PHPMailer установитеCharSetперед сборкой сообщения.
Адрес из формы и защита заголовков
Для контактной формы держите From и адрес получателя в конфигурации приложения. Проверенный адрес посетителя передавайте через Reply-To, чтобы оператор мог ответить из почтового клиента. Проверяйте адрес функцией filter_var($address, FILTER_VALIDATE_EMAIL) и отклоняйте символы CR и LF во входных значениях заголовков. Передавайте адрес библиотеке отдельным аргументом. Пользовательский текст для HTML-части экранируйте через htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8').
Чек-лист перед запуском отправки
- Выберите транспорт. Для готовой почты на хостинге и коротких уведомлений подойдёт
mail(). Для внешнего SMTP используйте PHPMailer или Symfony Mailer. - Задайте разрешённый
From, храните секреты в конфигурации среды и проверьте пару «порт и режим TLS». - Отправьте тест из того же процесса, который будет отправлять письма в продакшене. Проверьте тему с кириллицей, текстовую и HTML-части, если используете обе, и получение письма во внешнем ящике.
- Проверьте, что журнал различает отказ транспорта, постановку в очередь и дальнейший статус доставки. Для фоновых заданий ограничьте число повторов. При тайм-ауте после передачи письма результат может быть неизвестен, а повторная отправка может создать дубль.
Частые вопросы
Почему PHP mail() вернула true, а письмо не пришло?
Почтовая система приняла письмо к отправке. Проверьте её очередь и журнал, сообщения о недоставке и папку «Спам» у получателя.
Что выбрать для SMTP: PHPMailer или Symfony Mailer?
PHPMailer удобно подключить к отдельному скрипту и настроить напрямую. Symfony Mailer подходит для Symfony и проектов, где транспорт задаётся конфигурацией или отправка вынесена в Symfony Messenger.
Как отправить письмо с адресом посетителя в контактной форме?
Укажите разрешённый адрес вашего домена в From, а проверенный адрес посетителя передайте через Reply-To. Тогда ответ из почтового клиента уйдёт посетителю.