Php mail error что это
Перейти к содержимому

Php mail error что это

  • автор:

Что делать если функция mail не отправляет письма в php?

Вот несколько рекомендаций по решению данной проблемы:

  1. В первую очередь нужно проверить настройки вашего сервера
  2. Проверить что вы используете правильный адрес почты для отправки писем
  3. Проверить настройки безопасности и правила доступа для вашего сервера. Если ваш сервер использует SMTP-аутентификацию, то вам нужно будет проверить правильность введенных данных
  4. Если Вы пользуетесь услугами обычного хостинга, то данная функция должна поставляться хостером. Вам нужно задать вопрос в техподдержку
  5. Проверить логи:
    • Найти файл mail в папке /var/log, в нем содержатся ошибки
    • Также можно посмотреть файл error.log, обычно лежит в /var/log/apache
    • И проверить в php.ini параметр sendmail_path

Отправка электронных писем с помощью библиотеки PHPMailer языка PHP

Несмотря на то, что PHPMailer — библиотека PHP с открытым исходным кодом — была создана в далёком 2001 году, она наряду со Swiftmailer остается одним из лучших программных средств для отправки электронных писем, по мнению большинства разработчиков. Расскажем о том, как применять PHPMailer вместо встроенной функции mail() , а также приведём несколько примеров использования этой библиотеки.

Является ли PHPMailer альтернативой встроенной функции mail() ?

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

Если PHPMailer поддерживает ООП, то функция mail() уже не применима при объектно-ориентированном подходе в программировании. Также PHP-разработчики не любят использовать строки $headers при отправке писем с помощью функции mail() , поскольку при этом приходится экранировать многие символы. Еще один недостаток стандартной функции отправки писем PHP – «грязный» код (экранирование, кодирование, форматирование) скрипта отправки вложений и писем на HTML. PHPMailer полностью лишён перечисленных недостатков.

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

Рассмотрим ещё несколько преимуществ использования PHPMailer:

  • отображение сообщений об ошибках отправки писем более чем на 40 различных языках;
  • наличие встроенной поддержки аутентификации через SSL и TSL;
  • возможность отправки обычной текстовой копии письма клиентам, не поддерживающим письма формата HTML;
  • активное сообщество разработчиков, обеспечивающих безопасность библиотеки и выпуск обновлений.

К слову, PHPMailer используют многие CMS, созданные на языке PHP: например, WordPress, Joomla! и Drupal.

Установка библиотеки PHPMailer

Для установки PHPMailer можно использовать менеджер пакетов (композер), выполнив следующую команду:

composer require phpmailer/phpmailer

Отправка электронных писем с локального сервера с помощью PHPMailer

Ниже представлен простой код для отправки электронного письма с локального сервера через библиотеку PHPMailer:

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

//PHPMailer Object« $mail = new PHPMailer(true); //Argument true in constructor enables exceptions`

//From email address and name
$mail->From = «from@yourdomain.com»;
$mail->FromName = «Full Name»;

//To address and name
$mail->addAddress(«recepient1@example.com», «Recepient Name»);
$mail->addAddress(«recepient1@example.com»); //Recipient name is optional

//Address to which recipient will reply
$mail->addReplyTo(«reply@yourdomain.com», «Reply»);

//CC and BCC
$mail->addCC(«cc@example.com»);
$mail->addBCC(«bcc@example.com»);

//Send HTML or Plain Text email
$mail->isHTML(true);

$mail->Subject = «Subject Text»;
$mail->Body = «Mail body in HTML«;
$mail->AltBody = «This is the plain text version of the email content»;

try <
⠀⠀⠀⠀ $mail->send();
⠀⠀⠀⠀ echo «Message has been sent successfully»;
> catch (Exception $e) <
⠀⠀⠀⠀ echo «Mailer Error: » . $mail->ErrorInfo;
>

Представленный код с комментариями наглядно демонстрирует все действия, которые нужно выполнить для отправки письма.

Отправка письма с вложениями

В приведённом ниже коде показано, как отправить письмо с вложениями с помощью PHPMailer:

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

$mail = new PHPMailer;

$mail->From = «from@yourdomain.com»;
$mail->FromName = «Full Name»;

$mail->addAddress(«recipient1@example.com», «Recipient Name»);

//Provide file path and name of the attachments
$mail->addAttachment(«file.txt», «File.txt»);
$mail->addAttachment(«images/profile.png»); //Filename is optional

$mail->Subject = «Subject Text»;
$mail->Body = «Mail body in HTML«;
$mail->AltBody = «This is the plain text version of the email content»;

try <
⠀⠀⠀⠀ $mail->send();
⠀⠀⠀⠀ echo «Message has been sent successfully»;
> catch (Exception $e) <
⠀⠀⠀⠀ echo «Mailer Error: » . $mail->ErrorInfo;
>

К письму были прикреплены два файла: file.txt , расположенный в папке со скриптом, и images/profile.png , который находится в папке images .

Чтобы прикрепить файлы к письму, необходимо вызвать метод addAttachment объекта PHPMailer, который в качестве аргумента принимает строку с адресом файла. Для прикрепления нескольких файлов нужно вызвать этот метод соответствующее число раз.

Устранение проблем в коде

Для отладки кода был использован класс Exception библиотеки PHPMailer, который способен отследить все возможные ошибки. В конструктор объекта PHPMailer был передан аргумент true , который указывает на необходимость отображения полной информации об исключениях.

В зависимости от типа системы, наиболее распространенной ошибкой при использовании встроенной функции mail() в фоновом режиме является следующая:

Mailer Error: Could not instantiate mail function.

Если нужно получить больше сведений о возникшей ошибке, можно добавить следующий код в блок catch<> :

Как правило, ошибки использования функции mail() связаны с тем, что почтовый сервер не был сконфигурирован. В этом случае функция error_get_last вернёт следующее:

Array (
⠀⠀⠀⠀ [type] => 2
⠀⠀⠀⠀ [message] => mail(): Failed to connect to mailserver at «localhost» port 25, verify your «SMTP» and «smtp_port» setting in php.ini or use ini_set()
⠀⠀⠀⠀ [file] => OUR_PATH \vendor\phpmailer\phpmailer\src\PHPMailer.php
⠀⠀⠀⠀ [line] => 863
`)

Чтобы избежать этой весьма распространённой проблемы, рекомендуется использовать протокол SMTP.

Отображение сообщений об ошибках на требуемом языке

Свойство $ mail-> ErrorInfo отображает сведения о возникающих ошибках на 43 различных языках. Для этого нужно скопировать каталог с языками из исходного кода библиотеки PHPMailer в каталог проекта. Например, чтобы сообщения об ошибках отображались на русском языке, нужно установить соответствующий язык объекта PHPMailer с помощью метода setLanguage() с аргументом “ru” как показано ниже:

В папку language также можно добавить любой другой язык из 43 доступных.

Использование протокола SMTP

Для отправки электронных писем можно использовать почтовый сервер другого хоста, но сперва необходимо пройти аутентификацию. То есть для отправки писем через почтовый сервер Gmail необходимо иметь учётную запись в этом сервисе.

SMTP – протокол запроса на отправку электронного письма, используемый почтовыми клиентами. После того, как почтовый сервер проверит электронное письмо, он отправит его на указанный почтовый сервер.

Ниже приведен пример отправки письма через почтовый сервер Gmail с клиентского домена. Поскольку мы используем SMTP-протокол, локальный почтовый сервер не требуется:

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

$mail = new PHPMailer(true);

//Enable SMTP debugging.
$mail->SMTPDebug = 3;
//Set PHPMailer to use SMTP.
$mail->isSMTP();
//Set SMTP host name
$mail->Host = «smtp.gmail.com»;
//Set this to true if SMTP host requires authentication to send email
$mail->SMTPAuth = true;
//Provide username and password
$mail->Username = «name@gmail.com»;
$mail->Password = «super_secret_password»;
//If SMTP requires TLS encryption then set it
$mail->SMTPSecure = «tls»;
//Set TCP port to connect to
$mail->Port = 587;

$mail->From = «name@gmail.com»;
$mail->FromName = «Full Name»;

$mail->addAddress(«name@example.com», «Recepient Name»);

$mail->Subject = «Subject Text»;
$mail->Body = «Mail body in HTML«;
$mail->AltBody = «This is the plain text version of the email content»;

try <
⠀⠀⠀⠀ $mail->send();
⠀⠀⠀⠀ echo «Message has been sent successfully»;
> catch (Exception $e) <
⠀⠀⠀⠀ echo «Mailer Error: » . $mail->ErrorInfo;
>

Сервер Gmail использует TSL-шифрование поверх SMTP, поэтому в коде было установлено соответствующее значение для свойства объекта PHPMailer. Перед отправкой по протоколу SMTP необходимо указать имя хоста, номер порта, тип шифрования и пройти аутентификацию, а также предоставить имя пользователя и пароль. Если в Gmail была включена функция двухфакторной аутентификации, доступ к SMTP через имя пользователя и пароль будет закрыт. Для получения доступа необходимо внести дополнительные настройки.

Одно из преимуществ использования удалённого SMTP в сравнении с локальным почтовым сервером состоит в том, что при отправке электронной почты функцией mail() с любым адресом отправителя ( from ), кроме имени локального домена (имени сервера), сервер-получатель пометит письмо как спам. Например, если письмо будет отправлено с сервера с именем хоста example.com , используя адрес отправителя name@gmail.com , на адрес name@yahoo.com , почтовый сервер Yahoo пометит письмо как спам или отобразит уведомление с предупреждением. Так как имя сервера, с которого было отправлено письмо – example.com . Адрес name@gmail.com принадлежит этому же пользователю, но Yahoo никак не сможет это проверить.

Извлечение писем через протокол POP3

Библиотека PHPMailer поддерживает отправку писем по методу аутентификации POP перед SMTP. Иначе говоря, вы сможете пройти аутентификацию через POP и отправлять почту через SMTP. К сожалению, в PHPMailer реализована только возможность отправки электронных писем, поэтому получать почту по протоколу POP3 с использованием библиотеки не получится.

Заключение

Если вы являетесь PHP-разработчиком, вы будете часто сталкиваться с необходимостью программной отправки электронных писем. Конечно, можно использовать сторонние сервисы (Mandrill или SendGrid) или написать свою собственную библиотеку, но лучшим инструментом для решения этой задачи пока по-прежнему остаётся PHPMailer.

mail

Тема должна удовлетворять правилам стандарта » RFC 2047.

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

Предостережение

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

$text = str_replace ( «\n.» , «\n..» , $text );

additional_headers (необязательный)

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

Чаще этим пользуются, чтобы добавить дополнительные заголовки (From, Cc, и 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 при прямой отправке через SMTP-сервер (только Windows).

Замечание:

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

additional_params (необязательный)

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

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

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

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

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

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

То, что письмо было принято для передачи, не значит, что оно достигнет получателя.

phpmailer ошибка

При отправке данных на почту получаю: Ошибка: SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting В логах получаю: 2022-06-19 15:56:54 Connection: opening to ssl://smtp.mail.ru:587, timeout=300, options=array() 2022-06-19 15:56:54 Connection failed. Error #2: stream_socket_client(): SSL operation failed with code 1. OpenSSL Error messages:error:140770FC:SSL routines:SSL23_GET_SERVER_HELLO:unknown protocol [D:\progs\OpenServer\OpenServer\domains\dist\phpmailer\SMTP.php line 394] 2022-06-19 15:56:54 Connection failed. Error #2: stream_socket_client(): Failed to enable crypto [D:\progs\OpenServer\OpenServer\domains\dist\phpmailer\SMTP.php line 394] 2022-06-19 15:56:54 Connection failed. Error #2: stream_socket_client(): unable to connect to ssl://smtp.mail.ru:587 (Unknown error) [D:\progs\OpenServer\OpenServer\domains\dist\phpmailer\SMTP.php line 394] 2022-06-19 15:56:54 SMTP ERROR: Failed to connect to server: (0) SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting Ошибка: SMTP connect() failed. https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting php код:

isSMTP(); // Отправка через SMTP $mail->Host = 'smtp.mail.ru'; // Адрес SMTP сервера $mail->SMTPAuth = true; // Enable SMTP authentication $mail->Username = '[email protected]'; $mail->Password = 'prizrak'; // ваш пароль $mail->SMTPSecure = 'ssl'; // шифрование ssl $mail->Port = 587; $mail->SMTPDebug = 4; // порт подключения $mail->setFrom('[email protected]', 'Иван Иванов'); // от кого $mail->addAddress('[email protected]', 'Вася Петров'); // кому $mail->Subject = 'Тест'; $mail->msgHTML(" 

Здравствуйте!

Это тестовое письмо.

"); // Отправляем if ($mail->send()) < echo 'Письмо отправлено!'; >else < echo 'Ошибка: ' . $mail->ErrorInfo; > ?>

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *