Yii2框架安装PhpSpreadsheet后出现PHPMailerAutoload重复声明错误

嘿，作为Yii2新手遇到这种依赖冲突确实挺头疼的，我来帮你理清问题根源并给出解决办法！

问题原因分析 #

你手动通过require_once('../vendor/phpmailer/PHPMailerAutoload.php');引入的PHPMailer自动加载文件，和Composer安装的PhpSpreadsheet自带的PHPMailer版本发生了冲突——两者都定义了PHPMailerAutoload()函数，导致PHP报错“Cannot redeclare PHPMailerAutoload()”。

具体解决步骤 #

• 第一步：移除手动引入的PHPMailer文件
  直接删掉代码里的require_once('../vendor/phpmailer/PHPMailerAutoload.php');这行。Composer会自动管理所有依赖的自动加载逻辑，手动引入只会造成重复加载。

• 第二步：用Composer统一管理PHPMailer依赖
  如果你的项目还需要单独使用PHPMailer发送邮件，直接通过Composer安装官方包：

  composer require phpmailer/phpmailer
  

  这样Composer会自动处理版本兼容问题，确保PhpSpreadsheet和你的项目使用同一套PHPMailer，且所有自动加载都由Composer的autoload.php统一管理，不用再手动引入任何文件。

• 第三步：改用Yii2原生邮件组件（更推荐）
  Yii2本身提供了成熟的邮件组件，完全可以替代手动调用PHPMailer的方式。打开项目的config/web.php或config/main.php，在components节点下添加/修改邮件配置：

  'mailer' => [
      'class' => 'yii\swiftmailer\Mailer',
      // 若偏好原生PHPMailer，可安装codemix/yii2phpmailer扩展后改用下面的配置
      // 'class' => 'codemix\yii2phpmailer\Mailer',
      'useFileTransport' => false, // 关闭本地文件存储，改为实际发送邮件
      'transport' => [
          'class' => 'Swift_SmtpTransport',
          'host' => '你的SMTP服务器地址',
          'username' => '你的邮箱账号',
          'password' => '你的邮箱密码/授权码',
          'port' => 587,
          'encryption' => 'tls',
      ],
  ],
  

  之后就可以通过Yii2的组件方式调用邮件功能，比如：

  Yii::$app->mailer->compose()
      ->setTo('收件人邮箱')
      ->setSubject('邮件主题')
      ->setTextBody('邮件内容')
      ->send();
  

• 第四步：刷新Composer自动加载缓存
  执行以下命令确保所有依赖的自动加载规则生效：

  composer dump-autoload
  

完成以上步骤后，重启你的Yii2应用，登录后应该就不会再出现重复声明函数的错误了。

内容的提问来源于stack exchange，提问作者Prasad Patel