bulldog / mailgun
Mailgun 的简单 PHP 客户端
v1.1.1
2019-05-31 13:30 UTC
Requires
- php: >=5.5.38
- ext-curl: *
Requires (Dev)
- phpunit/phpunit: 3.7.*
This package is auto-updated.
Last update: 2024-08-29 04:54:33 UTC
README
虽然 Mailgun 在实现适配器模式、面向接口编程、使用 PSR 等方面做得很好,但这个包并没有。这个包的唯一要求是 cURL 扩展。
我在使用 PHP 时,经常需要快速简单地发送电子邮件。我非常喜欢 Mailgun,但总觉得他们的 PHP 客户端包含了我不需要的太多功能。因此,我编写了一个非常有限的 API 客户端,它只做一件事,而且做得很好。
安装
composer require bulldog/mailgun
使用方法
基本使用
<?php use Bulldog\Mailgun; $mg = new Mailgun('mg.your-domain.com', 'key-tops3cretk3y'); $mg->send('to.someone@example.com', 'from.someone@example.com', 'Important Subject', 'Your message.');
高级使用
发送方法的第五个参数接受一个数组。在这个数组中,你可以添加 Mailgun 文档 中列出的任何参数。所以如果你想 cc 一个人,你会这样做
<?php use Bulldog\Mailgun; $mg = new Mailgun('mg.your-domain.com', 'key-tops3cretk3y'); $mg->send('to.someone@example.com', 'from.someone@example.com', 'Important Subject', 'Your message.', [ 'cc' => 'copy.someone@example.com', ]);
或者,如果你想发送一封电子邮件,你可以这样做
<?php use Bulldog\Mailgun; $mg = new Mailgun('mg.your-domain.com', 'key-tops3cretk3y'); $mg->send('to.someone@example.com', 'from.someone@example.com', 'Important Subject', 'Your message.', [ 'html' => '<html><head></head><body><h1>Hi there</h1></body></html>', ]);
你可以添加你需要的任何额外参数。
<?php use Bulldog\Mailgun; $mg = new Mailgun('mg.your-domain.com', 'key-tops3cretk3y'); $mg->send('to.someone@example.com', 'from.someone@example.com', 'Important Subject', 'Your message.', [ 'cc' => 'copy.someone@example.com', 'v:important' => 'true', 'o:tag' => 'client_x_email', ]);
https://documentation.mailgun.com/en/latest/api-sending.html#sending
兼容性
此包将与以下 PHP 版本一起工作,并已在这些版本上进行了测试
- 5.5
- 5.6
- 7.0
- 7.1
- 7.2
- 7.3
你必须安装 cURL 扩展才能使用此包。
贡献
我们始终欢迎!请保持简单。首先提出一个讨论问题,然后分支仓库,创建一个主题分支,并提交一个 pull request。我们可以在以后解决其他所有问题。