function MailFormatHelper::wrapMailLine

Wraps words on a single line.

Callback for array_walk() within \Drupal\Core\Mail\MailFormatHelper::wrapMail().

Note that we are skipping MIME content header lines, because attached files, especially applications, could have long MIME types or long filenames which result in line length longer than the 77 characters limit and wrapping that line will break the email format. For instance, the attached file hello_drupal.docx will produce the following Content-Type:

Content-Type:
application/vnd.openxmlformats-officedocument.wordprocessingml.document;
name="hello_drupal.docx"

File

core/lib/Drupal/Core/Mail/MailFormatHelper.php, line 296

Class

MailFormatHelper

Defines a class containing utility methods for formatting mail messages.

Namespace

Code

protected static function wrapMailLine(&$line, $key, $values) {
    $line_is_mime_header = FALSE;
    $mime_headers = [
        'Content-Type',
        'Content-Transfer-Encoding',
        'Content-Disposition',
        'Content-Description',
    ];
    // Do not break MIME headers which could be longer than 77 characters.
    foreach ($mime_headers as $header) {
        if (str_starts_with($line, $header . ': ')) {
            $line_is_mime_header = TRUE;
            break;
        }
    }
    if (!$line_is_mime_header) {
        // Use soft-breaks only for purely quoted or un-indented text.
        $line = wordwrap($line, 77 - $values['length'], $values['soft'] ? "  \n" : "\n");
    }
    // Break really long words at the maximum width allowed.
    $line = wordwrap($line, 996 - $values['length'], $values['soft'] ? " \n" : "\n", TRUE);
}