Laravel集成PHPMailer发送联系表单邮件报500服务器错误

问题核心原因 #

报错Call to undefined function PHPMailer\PHPMailer\escapeshellcmd()触发逻辑：
当前邮件驱动配置为mail，PHPMailer调用系统原生mail()函数发信时，会通过isShellSafe方法校验命令安全性，方法内依赖PHP内置函数escapeshellcmd()做转义。该函数未定义的唯一常见原因是被服务器PHP配置的disable_functions禁用列表拦截，和业务代码、表单提交逻辑本身无关。

可落地修复方案 #

按优先级选其一操作即可：

• 方案1：解除PHP函数禁用（适配现有配置）
  1. 定位站点当前使用PHP版本对应的php.ini配置文件，查找disable_functions配置项
  2. 从禁用列表中移除escapeshellcmd、escapeshellarg两个函数名，保存文件
  3. 重启对应PHP服务（php-fpm、Apache/Nginx服务）
  4. 可通过phpinfo探针确认函数恢复可用后，测试表单提交
• 方案2：更换邮件驱动为SMTP（推荐长期使用，不受主机安全配置限制）
  原生mail()驱动发信稳定性差、易进垃圾邮件箱，直接替换为SMTP驱动即可绕开shell函数调用逻辑。修改项目根目录.env文件的邮件配置段：

  MAIL_DRIVER=smtp
  MAIL_HOST=mail.****.com
  MAIL_PORT=587
  MAIL_USERNAME=contact@****.com
  MAIL_PASSWORD=*****
  MAIL_ENCRYPTION=tls
  MAIL_FROM_ADDRESS=contact@****.com
  MAIL_FROM_NAME="站点发件人名称"
  

  配置修改完成后，在项目根目录执行命令清除配置缓存：

  php artisan config:clear
  

  执行完成后直接测试表单提交即可，不需要改动任何业务代码。

注意：不要直接修改vendor目录下的PHPMailer源码绕过校验，后续执行composer update会自动覆盖修改，且直接绕过安全校验存在命令注入风险。

内容的提问来源于stack exchange，提问作者Yns Kzy