Вставка файлов в электронные сообщения средствами PHP

Дополнительные примеры и сценарии

1. Множественные вложения и вложение из строки в PHPMailer

require 'vendor/autoload.php';

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

$mail = new PHPMailer(true);
try {
    $mail->setFrom('from@example.com', 'Sender');
    $mail->addAddress('to@example.com');
    $mail->Subject = 'Несколько вложений';

    // Файл из файловой системы
    $mail->addAttachment('/files/report.pdf', 'report.pdf');
    // Вложение из строки (например, сгенерированный PDF)
    $pdfContent = file_get_contents('/files/invoice.pdf');
    $mail->addStringAttachment($pdfContent, 'invoice.pdf', 'base64', 'application/pdf');

    $mail->Body = 'Проверьте вложения.';
    $mail->send();
} catch (Exception $e) {
    echo $mail->ErrorInfo;
}

Письмо отправлено (истина)

2. Отправка через SMTP с шифрованием и авторизацией (PHPMailer)

require 'vendor/autoload.php';

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

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host       = 'smtp.gmail.com';
$mail->SMTPAuth   = true;
$mail->Username   = 'user@gmail.com';
$mail->Password   = 'app_password';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port       = 587;

$mail->setFrom('user@gmail.com', 'Gmail User');
$mail->addAddress('recipient@example.com');
$mail->Subject = 'SMTP тест с вложением';
$mail->addAttachment('/tmp/file.txt', 'file.txt');
$mail->Body = 'Это письмо отправлено через Gmail SMTP.';

if ($mail->send()) {
    echo 'Успешно';
} else {
    echo $mail->ErrorInfo;
}

Успешно

3. Ручное формирование письма с поддержкой кириллицы (mail())

$boundary = md5(uniqid(time()));
$subject = mb_encode_mimeheader('Вложение с русским именем', 'UTF-8');

$headers = "MIME-Version: 1.0\r\n";
$headers .= "Content-Type: multipart/mixed; boundary=\"{$boundary}\"\r\n";
$headers .= "From: from@example.com\r\n";

$textPart = "--{$boundary}\r\n";
$textPart .= "Content-Type: text/plain; charset=utf-8\r\n\r\n";
$textPart .= "Текст письма.\r\n\r\n";

$file = '/var/www/images/фото.jpg';
$filename = mb_encode_mimeheader(basename($file), 'UTF-8');
$content = chunk_split(base64_encode(file_get_contents($file)));

$attachPart = "--{$boundary}\r\n";
$attachPart .= "Content-Type: image/jpeg; name=\"{$filename}\"\r\n";
$attachPart .= "Content-Disposition: attachment; filename=\"{$filename}\"\r\n";
$attachPart .= "Content-Transfer-Encoding: base64\r\n\r\n";
$attachPart .= $content . "\r\n\r\n";
$attachPart .= "--{$boundary}--";

$message = $textPart . $attachPart;

mail('to@example.com', $subject, $message, $headers);

Письмо отправлено (true)

4. Проверка существования файла перед добавлением и обработка исключений

function safeAttach(PHPMailer $mail, string $filePath, string $displayName = ''): bool {
    if (!file_exists($filePath)) {
        throw new Exception("Файл не найден: {$filePath}");
    }
    if (!is_readable($filePath)) {
        throw new Exception("Нет прав на чтение: {$filePath}");
    }
    $mail->addAttachment($filePath, $displayName);
    return true;
}

$mail = new PHPMailer(true);
try {
    $mail->setFrom('from@example.com');
    $mail->addAddress('to@example.com');
    $mail->Subject = 'Тест';
    safeAttach($mail, '/tmp/data.xlsx', 'data.xlsx');
    $mail->send();
} catch (Exception $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

Ошибка: Файл не найден: /tmp/data.xlsx