iagofelicio/laravel-gmail-oauth2

使用 Gmail OAuth2 凭据发送电子邮件,而不是 SMTP 默认访问信息

2.0.5 2024-04-15 19:01 UTC

This package is auto-updated.

Last update: 2024-09-16 13:00:31 UTC


README

Latest Version on Packagist Total Downloads

此 Laravel 扩展包允许您使用 Gmail OAuth2 凭据安全地发送电子邮件,无需在应用程序配置中存储敏感信息,如用户名和密码。

支持我们

此包正在积极维护且免费使用。如果您觉得它有帮助,请考虑以下方式回馈:

  • 通过 GitHub 问题报告任何问题或提出改进建议。
  • 通过拉取请求提交代码或文档更改。
  • 在存储库上留下星星以表达您的感谢。您的支持有助于保持此项目的活力和繁荣!
  • 在 Ko-fi 上支持我

ko-fi

安装

您可以通过 composer 安装此包

对于 PHP 8 和 Laravel 9

composer require iagofelicio/laravel-gmail-oauth2

对于 PHP 7 和 Laravel 7/8

composer require iagofelicio/laravel-gmail-oauth2:1.0.4

Gmail 凭据

要获取 Gmail OAuth2 刷新令牌,您可以参考 PHPMailer 包在 GitHub 上提供的说明 https://github.com/PHPMailer

有关生成 Gmail OAuth2 刷新令牌的详细说明,我们建议您遵循 Coding Yet 提供的优秀教程 https://www.codingyet.com/how-to-use-phpmailer-with-xoauth2/

本教程将逐步引导您完成整个过程,确保您能够顺利设置安全的电子邮件发送。

使用方法

(步骤 1) 对于 PHP 7 和 Laravel 7/8

编辑 config/mail.php 添加以下行

return [

    'driver' => 'gmail',
    
    // Default code ...
];

(步骤 1) 对于 PHP 8 和 Laravel 9

编辑 config/mail.php 添加以下邮件发送者

return [

    'mailers' => [
        
        // Default code ...

        'gmail' => [
            'transport' => 'gmail',
        ],
    ]    
];

编辑 .env 文件中的 MAIL_MAILER

MAIL_MAILER=gmail

(步骤 2) 对于 Laravel 7、8 和 9

.env 文件中添加您的 Gmail 凭据

GMAIL_API_CLIENT_ID="your-api-client-id"
GMAIL_API_CLIENT_SECRET="your-api-client-secret"
GMAIL_API_CLIENT_REFRESH_TOKEN="your-api-client-refresh-token"
GMAIL_API_CLIENT_MAIL="your-api-client-email"

# Suggested default settings to include
MAIL_FROM_ADDRESS="from@mail.com"
MAIL_FROM_NAME="${APP_NAME}"

测试

开发中。

composer test

变更日志

有关最近更改的更多信息,请参阅 CHANGELOG

致谢

许可

MIT 许可证 (MIT)。有关更多信息,请参阅 许可文件