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@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 normally chosen by Net::SMTP, but
depending on your installation it may necessary 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 environment 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 normally chosen by
Net::SMTP, but depending on your
installation it may necessary 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 embperl dot org)
See Also¶
perl(1), Embperl, Net::SMTP