mailgun-php/README.md

78 lines
3.0 KiB
Markdown
Raw Normal View History

2013-08-03 02:26:11 +04:00
Mailgun-PHP
2013-07-18 07:12:41 +04:00
===========
2013-08-03 02:22:14 +04:00
[![Build Status](https://travis-ci.org/travelton/Mailgun-PHP.png?branch=master)](https://travis-ci.org/travelton/Mailgun-PHP)
2013-07-26 03:18:32 +04:00
2013-08-13 23:26:34 +04:00
This is the Mailgun PHP SDK. This SDK contains methods for easily interacting with the Mailgun API.
Below are examples to get you started. For additional examples, please see our official documentation
at http://documentation.mailgun.com
2013-07-25 10:35:12 +04:00
2013-08-03 05:15:41 +04:00
Current Release: 0.4-Beta
2013-07-25 10:35:12 +04:00
Installation
2013-08-03 02:34:18 +04:00
------------
2013-08-13 23:26:34 +04:00
To install the SDK, you will need to be using [Composer](http://getcomposer.org/) in your project.
If you aren't using Composer yet, it's really simple! Here's how to install composer and the Mailgun SDK.
2013-07-25 10:35:12 +04:00
```PHP
# Install Composer
curl -sS https://getcomposer.org/installer | php
# Add Mailgun as a dependency
2013-07-29 03:08:16 +04:00
php composer.phar require mailgun/mailgun-php-sdk:~0.1
2013-07-25 10:35:12 +04:00
```
2013-08-04 01:58:35 +04:00
2013-08-02 23:43:50 +04:00
For shared hosts with SSH access, you might need to run this instead (contact your shared host for assistance):
```
php -d detect_unicode=Off -r "eval('?>'.file_get_contents('https://getcomposer.org/installer'));"
```
2013-07-25 10:35:12 +04:00
2013-08-04 01:58:35 +04:00
Next, require Composer's autoloader, in your application, to automatically load the Mailgun SDK in your project:
```PHP
require 'vendor/autoload.php';
2013-08-08 21:39:44 +04:00
use Mailgun\Mailgun;
2013-08-04 01:58:35 +04:00
```
2013-07-25 10:35:12 +04:00
Usage
-----
2013-08-13 23:26:34 +04:00
Here's how to send a message using the SDK:
2013-07-25 10:35:12 +04:00
```php
2013-08-08 21:39:44 +04:00
# First, instantiate the SDK with your API credentials and define your domain.
$mg = new Mailgun("key-example");
$domain = "example.com";
# Now, compose and send your message.
2013-08-14 01:35:22 +04:00
$mg->sendMessage($domain, array('from' => 'bob@example.com',
'to' => 'sally@example.com',
'subject' => 'The PHP SDK is awesome!',
'text' => 'It is so simple to send a message.'));
2013-08-13 23:26:34 +04:00
```
Or obtain the last 25 log items:
```php
# First, instantiate the SDK with your API credentials and define your domain.
$mg = new Mailgun("key-example");
$domain = "example.com";
# Now, issue a GET against the Logs endpoint.
$mg->get("$domain/log", array('limit' => 25,
'skip' => 0);
2013-07-25 10:35:12 +04:00
```
2013-08-08 21:39:44 +04:00
For usage examples on each API endpoint, head over to our official documentation pages.
This SDK includes a [Message Builder](src/Mailgun/Messages/README.md) and [Batch Message](src/Mailgun/Messages/README.md) component.
2013-08-03 02:38:08 +04:00
2013-08-13 23:26:34 +04:00
Message Builder allows you to quickly create the array of parameters, required to send a message, by calling a methods for each parameter.
Batch Message is an extension of Message Builder, and allows you to easily send a batch message job within a few seconds. The complexity of
batch messaging is eliminated!
2013-08-03 02:34:18 +04:00
Support and Feedback
--------------------
2013-08-03 02:34:18 +04:00
Be sure to visit the Mailgun official [documentation website](http://documentation.mailgun.com/) for additional information about our API.
2013-08-03 02:34:18 +04:00
If you find a bug, please submit the issue in Github directly. [Mailgun-PHP Issues](https://github.com/mailgun/Mailgun-PHP/issues)
2013-08-03 05:15:41 +04:00
As always, if you need additional assistance, drop us a note at [support@mailgun.com](mailto:support@mailgun.com).