beholdr/sendsay-laravel

为Laravel发送事务性邮件的不官方Sendsay.ru邮件传输工具。

v0.1.2 2024-03-25 08:00 UTC

This package is auto-updated.

Last update: 2024-09-25 09:00:10 UTC


README

Latest Version on Packagist

为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可邮寄的模板

  1. 发布laravel-mail组件
php artisan vendor:publish --tag=laravel-mail
  1. 将以下代码添加到HTML页脚模板中
@aware(['unsubscribe'])

...

@if ($unsubscribe)
<a style="font-size: 12px" href="{{ $unsubscribe }}">{{ __('Unsubscribe') }}</a>
@endif
  1. 将以下代码添加到文本页脚模板中
@aware(['unsubscribe'])

...

@if ($unsubscribe)
{{ __('Unsubscribe') }}: {{ $unsubscribe }}
@endif
  1. 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)。有关更多信息,请参阅 许可证文件