bulldog/mailgun

Mailgun 的简单 PHP 客户端

v1.1.1 2019-05-31 13:30 UTC

This package is auto-updated.

Last update: 2024-08-29 04:54:33 UTC


README

Build Status

虽然 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。我们可以在以后解决其他所有问题。