Embperl::Mail(3pm) - phpMan

Mail(3pm) User Contributed Perl Documentation Mail(3pm)

NAME
Embperl::Mail - Sends results from Embperl via E-Mail

SYNOPSIS
use Embperl::Mail ;

Embperl::Mail::Execute ({inputfile => 'template.epl',
subject => 'Test Embperl::Mail::Execute',
to => 'email AT foo.org'}) ;

DESCRIPTION
Embperl::Mail uses Embperl to process a page template and send the result out via EMail.
Currently only plain text mails are supported. A later version may add support for HTML
mails. Because of that fact, normal Embperl HTML processing is disabled per Default (see
options below).

Execute

The "Execute" function can handle all the parameter that "Embperl::Execute" does.
Addtionaly the following parameters are recognized:

from
gives the sender e-mail address

to gives the recipient address(es). Multiply addresses can either be separated by
semikolon or given as an array ref.

cc gives the recipient address(es) which should receive a carbon copy. Multiply addresses
can either be separated by semikolon or given as an array ref.

bcc gives the recipient address(es) which should receive a blind carbon copy. Multiply
addresses can either be separated by semikolon or given as an array ref.

subject
gives the subject line

reply-to
the given address is insert as reply address

mailheaders
Array ref of additional mail headers

headerencoding (2.0b9+)
Tells Embperl::Mail which charset definition to include in any header that contains
character code 128-255 and therfore needs encoding. Defaults to iso-8859-1. Pass
empty string to turn encoding of header fields of.

mailhost
Specifies which host to use as SMTP server. Default is localhost.

mailhelo
Specifies which host/domain to use in the HELO/EHLO command. A reasonable default is
normaly choosen by Net::SMTP, but depending on your installation it may neccessary to
set it manualy.

maildebug
Set to 1 to enable debugging of mail transfer.

options
If no "options" are given the following are used per default: optDisableHtmlScan,
optRawInput, optKeepSpaces, optReturnError

escmode
In contrast to normal Embperl escmode defaults to zero (no escape)

errors
As in "Embperl::Execute" you can specify an array ref, which returns all the error
messages from template processing. If you don't specify this parameter "Execute" will
die when an error occurs.

Configuration

Some default values could be setup via environement variables.

IMPORTANT: For now Embperl::Mail does not honour the Embperl configuration directives in
your httpd.conf. Only values set via the environment are accepted (e.g. via SetEnv or
PerlSetEnv).

EMBPERL_MAILHOST

Specifies which host to use as SMTP server. Default is localhost.

EMBPERL_MAILHELO

Specifies which host/domain to use in the HELO/EHLO command. A reasonable default is
normaly choosen by Net::SMTP, but depending on your installation it may neccessary to set
it manualy.

EMBPERL_MAILFROM

Specifies which the email address that is used as sender. Default is
www-server@server_name.

EMBPERL_MAILDEBUG

Debug setting for Net::SMTP. Default is 0.

Author
G. Richter (richter AT dev.de)