Introduction
The mail() function allows you to send mail.
Requirements
No external libraries are needed to build this extension.
Installation
There is no installation needed to use these
functions; they are part of the PHP core.
Runtime Configuration
The behaviour of these functions is affected by settings in php.ini.
Table 1. Mail configuration options
| Name | Default | Changeable |
|---|
| SMTP | "localhost" | PHP_INI_ALL |
| smtp_port | "25" | PHP_INI_ALL |
| sendmail_from | NULL | PHP_INI_ALL |
| sendmail_path | DEFAULT_SENDMAIL_PATH | PHP_INI_SYSTEM |
For further details and definition of the PHP_INI_* constants see
ini_set().
Here is a short explanation of the configuration directives.
- SMTP
string
Used under Windows only: DNS name or IP address of the SMTP server PHP
should use for mail sent with the mail() function.
- SMTP
int
Used under Windows only: Number of the port to connect to the server
specified with the SMTP setting when sending mail
with mail(); defaults to 25. Only available since
PHP 4.3.0.
- sendmail_from
string
Which "From:" mail address should be used in mail sent from
PHP under Windows.
- sendmail_path
string
Where the sendmail program can be found,
usually /usr/sbin/sendmail or
/usr/lib/sendmail.
configure does an honest attempt of
locating this one for you and set a default, but if it fails,
you can set it here.
Systems not using sendmail should set this directive to the
sendmail wrapper/replacement their mail system offers, if any.
For example, Qmail
users can normally set it to
/var/qmail/bin/sendmail or
/var/qmail/bin/qmail-inject.
qmail-inject does not require any option to
process mail correctly.
Resource Types
This extension has no resource types defined.
Predefined Constants
This extension has no constants defined.
