Mail

## 简介
mail() 函数可以发送邮件。

## 安装/配置

### 需求
为了使右键函数正常运行，PHP 必须在编译时访问你系统里的 sendmail 可执行文件。如果你使用了其他邮件程序，例如 qmail 或者 postfix，请确保它们使用了与 sendmail 适配的包装器。PHP 首先会在你的 PATH 变量里查找 sendmail，然后在下面的路径里查找： `/usr/bin:/usr/sbin:/usr/etc:/etc:/usr/ucblib:/usr/lib`。 强烈建议 sendmail 在您的 PATH 变量里。并且，运行编译后 PHP 程序的用户也必须有执行 sendmail 的权限。

### 安装
使用这些函数不需要安装，它们是 PHP 核心的一部分。

### 运行时配置
这些函数的行为受 `php.ini` 中的设置影响。

**Mail 配置选项**

| 名字                         | 默认          | 可修改范围          | 更新日志   |
|-----------------------------|-------------|-----------------------|--------|
| mail.add_x_header           | "0"         | INI_PERDIR            | &nbsp; |
| mail.log                    | NULL        | INI_SYSTEM&#124;INI_PERDIR | &nbsp; |
| mail.force_extra_parameters | NULL        | INI_SYSTEM&#124;INI_PERDIR | &nbsp; |
| SMTP                        | "localhost" | INI_ALL               | &nbsp; |
| smtp_port                   | "25"        | INI_ALL               | &nbsp; |
| sendmail_from               | NULL        | INI_ALL               | &nbsp; |
| sendmail_path               | NULL        | INI_SYSTEM            | &nbsp; |

有关 INI_* 样式的更多详情与定义，见 [配置可被设定范围](https://www.php.net/manual/zh/configuration.changes.modes.php "配置可被设定范围")。
这是配置指令的简短说明。

`mail.add_x_header` `bool`
添加 X-PHP-Originating-Script，将会包含脚本的 UID 以及文件名。

`mail.log` `string`
记录所有调用 mail() 的日志文件路径。日志条目包含脚本的完整路径、行号、To 地址和报头。

`mail.force_extra_parameters` `string`
强制添加指定参数作为额外参数传递给 sendmail 二进制文件。这些参数将始终代替 mail() 第五个参数的值。

`SMTP` `string`
仅用于 Windows：PHP 在 mail() 函数中用来发送邮件的 SMTP 服务器的主机名称或者 IP 地址。

`smtp_port` `int`
仅用于 Windows：使用 mail() 发送邮件时，连接到使用 SMTP 的指定服务器的端口号，默认为 25。

`sendmail_from` `string`
通过 STMP 直接用 PHP 发送邮件时的 "From:" 邮件地址的值（仅限 Windows）。该选项同时设置了 "Return-Path:" 头。

`sendmail_path` `string`
**sendmail** 程序的路径，通常为 /usr/sbin/sendmail 或 /usr/lib/sendmail。configure 脚本会尝试找到该程序并设定为默认值，但是如果失败的话，可以在这里设定。

不使用 **sendmail** 的系统应将此指令设定为其邮件系统提供的 sendmail 替代程序，如果有的话。例如，[» Qmail](http://cr.yp.to/qmail.html "» Qmail") 用户通常可以设为 /var/qmail/bin/sendmail 或 /var/qmail/bin/qmail-inject。

**qmail-inject** 不需要任何选项就能正确处理邮件。

此指令也可用于 Windows。如果设定，smtp，smtp_port 和 sendmail_from 都被忽略并运行指定的命令。

### 资源类型
此扩展没有定义资源类型。

## 预定义常量
此扩展没有定义常量。