PHPTime

Отправка почты из PHP: mail(), PHPMailer и Symfony Mailer

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

Как устроена отправка письма из PHP

Скрипт формирует письмо и передаёт его почтовому транспорту. Тот принимает сообщение, ставит его в очередь или сразу пытается связаться с сервером получателя. Успешное завершение PHP-вызова означает, что транспорт принял сообщение на своём этапе. Дальше возможны задержка, отказ и фильтрация в спам.

СпособКуда передаёт письмоКогда выбирать
mail()Локальной почтовой программе, а на Windows обычно SMTP-серверу из php.iniНа хостинге уже настроена отправка и нужны простые уведомления
PHPMailerSMTP-серверу с аутентификацией и TLSСкрипту или приложению нужен SMTP, HTML или вложения
Symfony MailerТранспорту из конфигурации, например SMTPВ проекте уже есть Symfony или нужна единая конфигурация почты для разных сред

Запрос send php обычно сводится к одному из двух вызовов: у PHPMailer это $mail->send(), у Symfony Mailer — $mailer->send($email). В обоих случаях сначала задают транспорт, отправителя и получателя.

PHP mail(): отправка простого текстового письма

mail() принимает адрес получателя, тему, тело и дополнительные заголовки. Пример предполагает настроенную почту на сервере. Замените адреса на реальные, а в From укажите адрес, с которого ваш сервер или провайдер разрешает отправлять.

PHP
<?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.

Shell
composer require phpmailer/phpmailer
PHP
<?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 через внедрение зависимостей.

Shell
composer require symfony/mailer
PHP
<?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').

Чек-лист перед запуском отправки

  1. Выберите транспорт. Для готовой почты на хостинге и коротких уведомлений подойдёт mail(). Для внешнего SMTP используйте PHPMailer или Symfony Mailer.
  2. Задайте разрешённый From, храните секреты в конфигурации среды и проверьте пару «порт и режим TLS».
  3. Отправьте тест из того же процесса, который будет отправлять письма в продакшене. Проверьте тему с кириллицей, текстовую и HTML-части, если используете обе, и получение письма во внешнем ящике.
  4. Проверьте, что журнал различает отказ транспорта, постановку в очередь и дальнейший статус доставки. Для фоновых заданий ограничьте число повторов. При тайм-ауте после передачи письма результат может быть неизвестен, а повторная отправка может создать дубль.

Частые вопросы

Почему PHP mail() вернула true, а письмо не пришло?

Почтовая система приняла письмо к отправке. Проверьте её очередь и журнал, сообщения о недоставке и папку «Спам» у получателя.

Что выбрать для SMTP: PHPMailer или Symfony Mailer?

PHPMailer удобно подключить к отдельному скрипту и настроить напрямую. Symfony Mailer подходит для Symfony и проектов, где транспорт задаётся конфигурацией или отправка вынесена в Symfony Messenger.

Как отправить письмо с адресом посетителя в контактной форме?

Укажите разрешённый адрес вашего домена в From, а проверенный адрес посетителя передайте через Reply-To. Тогда ответ из почтового клиента уйдёт посетителю.

Справка по теме

Ещё в разделе «Справочник PHP»

Поиск в массиве PHP: in_array, array_search, array_filter

Как искать значения и ключи в массивах PHP 8.3–8.5: строгое сравнение, фильтрация, сохранение ключей и примеры с array_map и array_merge.

9 мин

Пространства имён и автозагрузка в PHP: namespace, use, PSR-4

Как работают namespace и use в PHP 8.3–8.5, как настроить автозагрузку Composer по PSR-4 и что проверить, если PHP сообщает, что класс не найден.

8 мин

Работа с файлами в PHP: чтение, запись, удаление

Как читать, записывать, копировать и удалять файлы в PHP 8.3–8.5. Рабочие примеры с file_get_contents, file_put_contents, fopen, filesize и unlink.

11 мин

Регулярные выражения в PHP: preg_match, preg_replace и шаблоны

Как составлять регулярные выражения в PHP, искать совпадения через preg_match, заменять текст через preg_replace и учитывать Unicode и различия PHP 8.3–8.5.

8 мин