This is a brief summary of code that I've found to send UTF-8 Unicode e-mails that can be sent through SMTP servers that only support 7-bit encoding.
Creating UTF-8 Formatted E-mail Using MIME::Entity
Many SMTP servers will not permit 8-bit characters. UTF-8 encoding requires 8-bit support because the high bit of the first byte is used to indicate successive bytes forming part of the same character.
Assume you have some text containing unicode. For example:
my $data = "Goodbye in Japanese is \x{3055}\x{3088}\x{306A}\x{3089}.";
When creating an e-mail use the "quoted-printable" form of encoding for the data which will correctly encode the UTF-8 characters into 7-bit form. E-mail headers, however, must be encoded in the "MIME-Header" form if they contain any UTF-8 characters (which would often be in the case of foreign language subject headings).
The 7-bit version of the e-mail is obtained using the stringify function.
use Encode;
use MIME::Entity;
my $entity = MIME::Entity->build(
Type => "text/plain",
Charset => "UTF-8",
Encoding => "quoted-printable",
Data => Encode::encode( "UTF-8", $data ),
From => Encode::encode(
"MIME-Header", $sender
),
To => Encode::encode(
"MIME-Header", $recipient
),
Subject => Encode::encode(
"MIME-Header", $subject
),
);
Sending the Encoded Message Using Net::SMTP
Next, it is a relatively trivial matter of sending the appropriately coded message to a SMTP server (using Net::SMTP):
use Net::SMTP;
my $smtp = Net::SMTP->new(
"localhost",
Hello => 'localhost.localdomain',
Timeout => 15,
Debug => 1,
);
$smtp->mail( $sender );
if ( $smtp->recipient( $recipient ) ) {
$smtp->data();
my $msg = $entity->stringify;
while ( $msg =~ m/([^\r\n]*)(\r\n|\n\r|\r|\n)?/g ) {
my $line = ( defined($1) ? $1 : "" ) . "\r\n";
$smtp->datasend( $line );
}
if ( $smtp->dataend() ) {
print( STDERR, "Message sent!\n" );
} else {
print( STDERR, "Failure sending data.\n" );
}
} else {
print( STDERR, "Rejected recipient.\n" );
}
$smtp->quit();
See Also
Update: corrected formatting.
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.