CodeIgniter 4中Composer安装PHPMailer后类找不到问题排查

出现“Class 'PHPMailer\PHPMailer\PHPMailer' not found”错误，通常是自动加载、安装或命名空间配置环节出了问题，以下是具体排查方向：

1. 确认Composer自动加载器已正确引入 #

CodeIgniter 4 默认会加载项目根目录下的vendor/autoload.php，但如果该文件不存在或加载路径错误，就会导致第三方类无法被找到：

• 检查项目根目录是否存在vendor文件夹，以及其中的autoload.php文件。如果没有，说明Composer安装未完成，重新执行composer install或composer require phpmailer/phpmailer。
• 确认app/Config/Autoload.php中的$psr4数组未覆盖默认的Composer自动加载配置，CI4默认已配置$psr4[''] = APPPATH . 'ThirdParty';，确保该配置未被删除或修改。

2. 检查命名空间引入是否正确 #

PHPMailer的命名空间严格区分大小写，确保控制器中的引入语句无拼写错误：

// 正确的引入方式
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

若只引入部分命名空间，或出现大小写错误（比如小写的phpmailer），会导致类无法被识别。

3. 重新执行Composer安装，确保依赖完整 #

可能因网络中断或缓存问题导致PHPMailer文件缺失：

• 删除项目根目录下的vendor文件夹和composer.lock文件。
• 执行composer clear-cache清除Composer缓存。
• 重新运行composer require phpmailer/phpmailer，安装完成后检查vendor/phpmailer/phpmailer目录是否存在且文件完整。

4. 清除CodeIgniter 4的缓存 #

CI4的类缓存或OPcache可能导致旧的类映射未更新：

• 删除writable/cache目录下的所有缓存文件。
• 若开启了OPcache，临时在php.ini中设置opcache.enable=0，重启PHP服务后测试，问题解决后再重新开启。

5. 确认Composer命令执行路径正确 #

确保你是在项目根目录下执行的Composer命令，而非子目录。若在子目录执行，vendor文件夹会生成在子目录中，CI4无法找到对应的类文件。

内容的提问来源于stack exchange，提问作者Lidia K.