messagecloud/

gateway-php

此软件包最新版本(v1.0.0)没有可用的许可证信息。

一个PHP库,帮助您集成MessageCloud网关。

v1.0.0 2016-04-29 00:00 UTC

README

MessageCloud Gateway PHP库适用于PHP 5.4+,同时也兼容PHP 7。

文档

如果您想从头开始构建基于网关API的项目,可以在MessageCloud网关文档中找到更多文档。

先决条件

此库已在Mac OS 10.11.4和Fedora 22上开发和测试。

以下README假设您正在使用以下PHP扩展

  • php-curl
  • php-mbstring

安装

使用Composer构建

使用Composer,您可以轻松下载和构建应用程序

$ composer require messagecloud/gateway-php

导入库

要开始使用,只需在您的脚本顶部添加以下行

require_once 'vendor/autoload.php';

要测试库是否正确工作,您可以运行以下命令

$objMessage = new SMSMessage(YOUR_COMPANY_NAME_HERE, YOUR_EKEY_HERE);
$objResult = $objMessage->msisdn('447528748500')->body('Hello, world!')->senderId('MessageCloud')->send();

if ($objResult->success()) {
    echo $objResult->getCallbackId();
} else {
    echo 'Error sending message! Code: ' . $objResult->getErrorCode() . ' (' . $objResult->getErrorMessage() . ')';
}

您将得到类似以下的结果

$ php test.php
123e4567-e89b-12d3-a456-426655440000

回调ID可用于接收您的请求的投递报告。每个投递报告都将包含一个包含由SMSMessage::getCallbackId()函数返回的ID的id参数。

您还可以在require_once()函数下包含以下行,以便快速访问SMSMessage对象

use MessageCloud\Gateway\SMSMessage as SMSMessage;

使用库

请查看如何使用此库的示例。它们位于examples/目录中。

测试

您可以使用以下命令测试库(仅限开发)

$ composer test