PHP

Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending. Chilkat2 PHP

<?php

use Chilkat2\Email;
use Chilkat2\MailMan;

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

$mailman = new MailMan();

$mailman->SmtpHost = 'smtp.my-mail-server.com';
$mailman->SmtpUsername = 'MY_SMTP_USERNAME';
$mailman->SmtpPassword = 'MY_SMTP_PASSWORD';
$mailman->SmtpSsl = true;
$mailman->SmtpPort = 465;

$email = new Email();

$email->Subject = 'This is a test';
$email->Body = 'This is a test';
$email->From = 'Chilkat Support <support@chilkatsoft.com>';
$email->AddTo('Chilkat Admin', 'admin@chilkatsoft.com');
// To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

// Add some attachments.
// The AddFileAttachment method returns the value of the content-type it chose for the attachment.
try {
    $contentType = $email->AddFileAttachment('qa_data/jpg/starfish.jpg');

    $contentType = $email->AddFileAttachment('qa_data/pdf/fishing.pdf');
} catch (\Chilkat2\Exception $e) {
    echo $e->getMessage(), "\n";
    exit;
}

// If we save the email to a .eml, we can examine in a text editor.
try {
    $email->SaveEml('qa_output/e1.eml');

    // We see the following in the e1.eml
    // Notice that Chilkat replaced the full path with just the filename.
    // The full local path is not part of the email that gets sent..

    // ...
    // --------------020807050607070004010609
    // Content-Type: image/jpeg; name="starfish.jpg"
    // Content-Transfer-Encoding: base64
    // Content-Disposition: attachment; filename="starfish.jpg"
    //
    // ...
    // --------------020807050607070004010609
    // Content-Type: application/pdf; name="fishing.pdf"
    // Content-Transfer-Encoding: base64
    // Content-Disposition: attachment; filename="fishing.pdf"
    // ...

    // Before sending, each filename can be changed within the email object.
    // For example:
    $email->SetAttachmentFilename(0, 'orange_starfish.jpg');
    $email->SetAttachmentFilename(1, 'tuna_fishing.pdf');

    // Look at the new MIME source of the email in a  text editor...
    $email->SaveEml('qa_output/e2.eml');
} catch (\Chilkat2\Exception $e) {
    echo $e->getMessage(), "\n";
    echo "Failed to save .eml\n";
    exit;
}

// You'll see this:

// ...
// --------------020807050607070004010609
// Content-Type: image/jpeg; name="orange_starfish.jpg"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="orange_starfish.jpg"
//
// ...
// --------------020807050607070004010609
// Content-Type: application/pdf; name="tuna_fishing.pdf"
// Content-Transfer-Encoding: base64
// Content-Disposition: attachment; filename="tuna_fishing.pdf"
// ...

// Send the email with the updated filenames..
try {
    $mailman->SendEmail($email);
} catch (\Chilkat2\Exception $e) {
    echo $e->getMessage(), "\n";
    exit;
}

try {
    $mailman->CloseSmtpConnection();
} catch (\Chilkat2\Exception $e) {
    echo "Connection to SMTP server not closed cleanly.\n";
}

echo "Mail with attachments sent!\n";