beholdr / sendsay-laravel
为Laravel发送事务性邮件的不官方Sendsay.ru邮件传输工具。
v0.1.2
2024-03-25 08:00 UTC
Requires
- php: ^8.1
- illuminate/contracts: ^10.0 || ^11.0
- spatie/laravel-package-tools: ^1.14.0
Requires (Dev)
- laravel/pint: ^1.0
- nunomaduro/collision: ^7.8
- nunomaduro/larastan: ^2.0.1
- orchestra/testbench: ^8.8
- pestphp/pest: ^2.20
- pestphp/pest-plugin-arch: ^2.0
- pestphp/pest-plugin-laravel: ^2.0
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
README
为Laravel发送事务性邮件的不官方Sendsay.ru邮件传输工具。
支持
你喜欢 Sendsay Laravel 吗?请通过 Boosty 支持我。
安装
您可以通过composer安装此包
composer require beholdr/sendsay-laravel
您需要设置 .env 变量
MAIL_SENDSAY_ACCOUNT="root_account_name" MAIL_SENDSAY_KEY="YOUR_API_KEY"
并在 config/mail.php 中添加邮件传输配置
'mailers' => [ ... 'sendsay' => [ 'transport' => 'sendsay', ], ]
可选地,您可以使用以下命令发布配置文件:
php artisan vendor:publish --tag="sendsay-config"
用法
退订链接
为了更好的用户体验,您应该在邮件中提供退订链接。您可以使用特殊代码 #UNSUBSCRIBE_LINK# 在模板中添加此类链接,它将被替换为真实的URL。
例如,如果您正在使用markdown可邮寄的模板
- 发布laravel-mail组件
php artisan vendor:publish --tag=laravel-mail
- 将以下代码添加到HTML页脚模板中
@aware(['unsubscribe']) ... @if ($unsubscribe) <a style="font-size: 12px" href="{{ $unsubscribe }}">{{ __('Unsubscribe') }}</a> @endif
- 将以下代码添加到文本页脚模板中
@aware(['unsubscribe']) ... @if ($unsubscribe) {{ __('Unsubscribe') }}: {{ $unsubscribe }} @endif
- 将
unsubscribe属性传递给信件模板中的x-mail::message组件
<x-mail::message :unsubscribe="$mailer === 'sendsay' ? '#UNSUBSCRIBE_LINK#' : false"> ... </x-mail::message>
代理
如果您设置了 APP_LOCAL_PROXY 变量,您的Sendsay.ru请求将通过指定的代理进行代理。例如,在Docker内部的代理
APP_LOCAL_PROXY="socks5://host.docker.internal:8123"
测试
composer test
许可证
MIT许可证(MIT)。有关更多信息,请参阅 许可证文件。