---
name: "HTML::Embperl::Mail"
section: "3pm"
platform: "linux"
package: "libhtml-embperl-perl"
version: "1.3.6-3"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::Embperl::Mail"
---

# HTML::Embperl::Mail(3pm)

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

```
 use HTML::Embperl::Mail ;
```

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

*HTML::Embperl::Mail* uses *HTML::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 `"HTML::Embperl::Execute"` does. Addtionaly the following parameters are recognized: gives the sender e-mail address gives the recipient address(es). Multiply addresses can either be separated by semikolon or given as an array ref. 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. 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. gives the subject line the given address is insert as reply address Array ref of additional mail headers Specifies which host to use as SMTP server. Default is **localhost**. 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. Set to 1 to enable debugging of mail transfer. If no `"options"` are given the following are used per default:  **optDisableHtmlScan**, **optRawInput**, **optKeepSpaces**, **optReturnError** In contrast to normal *Embperl* escmode defaults to zero (no escape) As in `"HTML::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\
 **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. G. Richter (richter@dev.ecos.de) [*perl*(1)](/perl/1.md), HTML::Embperl, Net::SMTP