Skip to content

[Email] Add attachment functionality #10374

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
CamilleBeau wants to merge 2 commits into
base: main
Choose a base branch
from
Open

[Email] Add attachment functionality #10374

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3873cbf
[Email] Add attachment functionality
CamilleBeau Feb 18, 2026
72c1b3c
Dave's comments
CamilleBeau Mar 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 67 additions & 11 deletions php/libraries/Email.class.inc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,14 +35,15 @@ class Email
* Every template MUST BEGIN with "Subject: subject text". Put new
* templates in the subfolder "email" of the Smarty templates folder.
*
* @param string $to email address to send email to
* @param string $template template to use for email content
* @param array $tpl_data template's data for smarty binding
* @param string $reply_to optional email header
* @param string $from optional email header
* @param string $cc optional email header
* @param string $bcc optional email header
* @param string $type optional defaults to plain text
* @param string $to email address to send email to
* @param string $template template to use for email content
* @param array $tpl_data template's data for smarty binding
* @param string $reply_to optional email header
* @param string $from optional email header
* @param string $cc optional email header
* @param string $bcc optional email header
* @param string $type optional defaults to plain text
* @param array $attachments optional files to attach
*
* @return bool The result of PHP mail().
* @access public
Expand All @@ -55,7 +56,8 @@ class Email
string $from = '',
string $cc = '',
string $bcc = '',
string $type="text/plain"
string $type="text/plain",
array $attachments = []
): bool {
$config =& NDB_Config::singleton();
$defaults = $config->getSetting('mail');
Expand All @@ -69,7 +71,6 @@ class Email
}
// build header
$headers = "MIME-Version: 1.0\n";
$headers .= "Content-type: $type; charset = UTF-8\n";
$headers .= "Reply-to: $reply_to\n";
$headers .= "From: $from\n";
$headers .= "Return-Path: $from\n";
Expand Down Expand Up @@ -105,11 +106,66 @@ class Email
// get rid of the subject from the message body
$message = preg_replace('/^Subject: .*/', '', $message);

// Set attachment settings in body if there are any
if (!empty($attachments)) {

// boundary to seaprate MIME parts
$boundary = bin2hex(random_bytes(16));

// For attachments, use multipart
$headers .= "Content-Type: multipart/mixed; boundary=\"$boundary\"\r\n";

// In first part add charset / encoding since content-type in header
// is indicating multi-part
$body = "--$boundary\r\n";
$body .= "Content-Type: $type; charset=UTF-8\r\n";
$body .= "Content-Transfer-Encoding: 8bit\r\n\r\n";

// Add email message
$body .= $message . "\r\n";

foreach ($attachments as $file) {
if (!$file instanceof \SplFileInfo) {
throw new \Exception(
"Invalid attachment provided. " .
"Expected instance of SplFileInfo."
);
}
$filePath = $file->getRealPath();
$filename = $file->getFilename();
$filetype = mime_content_type($filePath);

if (!file_exists($filePath)) {
throw new \Exception(
"Email attachment file not found: {$filePath}"
);
}

// Use chunk_split for proper line length
$fileContent = chunk_split(
base64_encode(file_get_contents($filePath))
);

// Add part for each file attachment
$body .= "--$boundary\r\n";
$body .= "Content-Type: $filetype; name=\"$filename\"\r\n";
$body .=
"Content-Disposition: attachment; filename=\"$filename\"\r\n";
$body .= "Content-Transfer-Encoding: base64\r\n\r\n";
$body .= $fileContent . "\r\n";
}

$body .= "--$boundary--";
} else {
$headers .= "Content-type: $type; charset=UTF-8\r\n";
$body = $message;
}

// send the email
return mail(
$to,
$match[1],
preg_replace("/(?<!\r)\n/s", "\n", $message),
preg_replace("/(?<!\r)\n/s", "\n", $body),
$headers
);
}
Expand Down
Loading