(Perl) Rename Email Attachments After Adding

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

Chilkat Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

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

$mailman = chilkat::CkMailMan->new();

$mailman->put_SmtpHost("smtp.my-mail-server.com");
$mailman->put_SmtpUsername("MY_SMTP_USERNAME");
$mailman->put_SmtpPassword("MY_SMTP_PASSWORD");
$mailman->put_SmtpSsl(1);
$mailman->put_SmtpPort(465);

$email = chilkat::CkEmail->new();

$email->put_Subject("This is a test");
$email->put_Body("This is a test");
$email->put_From('Chilkat Support <support@chilkatsoft.com>');
$success = $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.
$contentType = $email->addFileAttachment("qa_data/jpg/starfish.jpg");
if ($email->get_LastMethodSuccess() != 1) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

$contentType = $email->addFileAttachment("qa_data/pdf/fishing.pdf");
if ($email->get_LastMethodSuccess() != 1) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

# If we save the email to a .eml, we can examine in a text editor.
$success = $email->SaveEml("qa_output/e1.eml");
if ($success == 0) {
    print $email->lastErrorText() . "\r\n";
    print "Failed to save .eml" . "\r\n";
    exit;
}

# 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:
$success = $email->SetAttachmentFilename(0,"orange_starfish.jpg");
$success = $email->SetAttachmentFilename(1,"tuna_fishing.pdf");

# Look at the new MIME source of the email in a  text editor...
$success = $email->SaveEml("qa_output/e2.eml");
if ($success == 0) {
    print $email->lastErrorText() . "\r\n";
    print "Failed to save .eml" . "\r\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..
$success = $mailman->SendEmail($email);
if ($success != 1) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}

$success = $mailman->CloseSmtpConnection();
if ($success != 1) {
    print "Connection to SMTP server not closed cleanly." . "\r\n";
}

print "Mail with attachments sent!" . "\r\n";