PHP邮件发送失败可能因mail()函数配置缺失、SMTP未启用或参数错误；可用内置mail()函数（需配置sendmail路径及From头）、PHPMailer（支持SMTP认证与HTML）或Swift Mailer（支持多传输方式）。
如果您在PHP中尝试调用邮件发送函数但邮件未能成功发出，则可能是由于函数配置缺失、SMTP未启用或参数传递错误。以下是调用PHP邮件发送函数的具体操作说明：
一、使用内置mail()函数发送邮件
PHP内置的mail()函数依赖服务器本地MTA（如sendmail）进行投递，无需额外扩展，但要求运行环境已正确配置邮件传输代理。
1、确认php.ini中已启用mail函数：检查disable_functions配置项未包含mail。
2、设置正确的sendmail路径：在php.ini中查找sendmail_path，确保其值指向有效的sendmail可执行文件，例如/usr/sbin/sendmail -t -i。
立即学习“PHP免费学习笔记（深入）”；
3、编写调用代码：使用四个必需参数依次为收件人地址、主题、正文、头部信息，例如：mail("user@example.com", "测试邮件", "这是一封测试内容", "From: admin@domain.com\r\n");。
4、注意头部必须包含From字段，否则部分MTA将拒绝发送；换行符必须使用\r\n而非\n。
二、使用PHPMailer库发送邮件
PHPMailer通过SMTP协议直接连接邮件服务器，支持身份验证、附件和HTML邮件，不依赖系统MTA，适用于共享主机等无sendmail环境。
1、通过Composer安装PHPMailer：composer require phpmailer/phpmailer。
2、引入类文件并在脚本中实例化：使用use PHPMailer\PHPMailer\PHPMailer;及$mail = new PHPMailer(true);。
3、启用SMTP并配置服务器参数：调用$mail->isSMTP();，设置$mail->Host = 'smtp.gmail.com';、$mail->Port = 587;、$mail->SMTPAuth = true;。
4、设置登录凭证与邮件内容：使用$mail->Username和$mail->Password填入应用专用密码（非账户密码），再调用$mail->setFrom()、$mail->addAddress()、$mail->Body等方法赋值。
5、执行发送并捕获异常：调用$mail->send()，若失败则抛出PHPMailer\PHPMailer\Exception，需用try-catch包裹。
三、使用Swift Mailer库发送邮件
Swift Mailer是面向对象的邮件发送组件，强调灵活性与可扩展性，支持多种传输方式（SMTP、Sendmail、Mail、自定义Transport）。
1、通过Composer安装：composer require swiftmailer/swiftmailer。
2、创建SMTP传输实例：使用$transport = (new Swift_SmtpTransport('smtp.163.com', 465, 'ssl'))，并设置用户名密码：$transport->setUsername('user@163.com')->setPassword('<strong><font color="green">授权码而非登录密码</font></strong>');
3、构建邮件对象：调用$message = new Swift_Message();，随后设置主题、发件人、收件人、正文：$message->setSubject('通知')->setFrom(['user@163.com' => '发件人名称'])->setTo(['target@example.com'])->setBody('纯文本内容', 'text/plain');
4、创建Mailer实例并发送：$mailer = new Swift_Mailer($transport);，然后执行$result = $mailer->send($message);，返回值为成功发送的收件人数。
5、启用日志记录便于调试：在传输对象上调用$transport->setStreamOptions(['ssl' => ['verify_peer' => false]])可临时跳过SSL证书验证（仅限测试环境）。
