Отправляйте электронные письма в PHP: от простого к сложному

PHPMailer: вложения и встраивание изображений

Пример: отправка письма с PDF-вложением и встроенной картинкой (не attachment). Код:

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->SMTPAuth = true;
$mail->Username = 'user@gmail.com';
$mail->Password = 'пароль_приложения';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port = 587;

$mail->setFrom('user@gmail.com', 'Администратор');
$mail->addAddress('client@example.com');
$mail->addCC('manager@example.com');

// Вложение файла
$mail->addAttachment('/path/to/file.pdf', 'документ.pdf');

// Встраивание изображения (cid)
$mail->addEmbeddedImage('/path/to/logo.png', 'logo');
$mail->isHTML(true);
$mail->Subject = 'Заказ №123';
$mail->Body = '<h1>Спасибо за заказ!</h1><img src="cid:logo" alt="Логотип">';
$mail->AltBody = 'Спасибо за заказ! Логотип не отображается в текстовой версии.';

if ($mail->send()) {
    echo 'Письмо с вложением отправлено';
}

Результат: на почте получателя откроется HTML-письмо с картинкой внутри и прикреплённым PDF.

SwiftMailer (альтернатива PHPMailer)

Компонент SwiftMailer стабилен, поддерживает очереди и работу с несколькими серверами. Установка:

composer require swiftmailer/swiftmailer

Пример отправки через SMTP:

<?php
require 'vendor/autoload.php';

$transport = new Swift_SmtpTransport('smtp.mail.ru', 465, 'ssl');
$transport->setUsername('login@mail.ru')
          ->setPassword('пароль');

$mailer = new Swift_Mailer($transport);

$message = (new Swift_Message('Тема'))
    ->setFrom(['login@mail.ru' => 'Отправитель'])
    ->setTo(['recipient@example.com' => 'Получатель'])
    ->setBody('<h1>HTML контент</h1>', 'text/html')
    ->addPart('Текстовая версия', 'text/plain')
    ->attach(Swift_Attachment::fromPath('/path/file.pdf'));

$result = $mailer->send($message);
if ($result > 0) {
    echo 'Успешно отправлено ' . $result . ' писем';
} else {
    echo 'Ошибка отправки';
}

Результат: письмо отправлено с теми же возможностями, что и PHPMailer.

Отправка через SendGrid API с использованием Guzzle

SendGrid предоставляет простой REST API. Установка:

composer require guzzlehttp/guzzle

Пример:

<?php
require 'vendor/autoload.php';

$client = new \GuzzleHttp\Client();

$response = $client->post('https://api.sendgrid.com/v3/mail/send', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_SENDGRID_API_KEY',
        'Content-Type' => 'application/json',
    ],
    'json' => [
        'personalizations' => [
            ['to' => [['email' => 'recipient@example.com']]]
        ],
        'from' => ['email' => 'sender@example.com'],
        'subject' => 'Тест SendGrid',
        'content' => [
            ['type' => 'text/plain', 'value' => 'Текст']
        ]
    ]
]);

if ($response->getStatusCode() == 202) {
    echo 'Письмо принято в очередь';
} else {
    echo 'Ошибка: ' . $response->getBody();
}

Результат: API возвращает 202 Accepted, письмо доставляется из облака SendGrid.

Пакетная отправка с разными получателями (phpmailer + цикл)

Для массовой рассылки лучше создавать одно письмо и использовать addBCC, либо новый экземпляр для каждого получателя. Пример:

<?php
use PHPMailer\PHPMailer\PHPMailer;
$mail = new PHPMailer(true);
$mail->isSMTP();
// ... настройки SMTP ...

$recipients = ['user1@example.com', 'user2@example.com'];
foreach ($recipients as $email) {
    $mail->clearAddresses();
    $mail->addAddress($email);
    $mail->Subject = 'Новости для ' . $email;
    $mail->Body = '<p>Персонализированное письмо</p>';
    try {
        $mail->send();
        echo 'Отправлено: ' . $email . PHP_EOL;
    } catch (Exception $e) {
        echo 'Ошибка для ' . $email . ': ' . $mail->ErrorInfo . PHP_EOL;
    }
}

Результат: каждое письмо отправляется отдельно, возможна персонализация и обработка ошибок построчно.