txtnation/txtnation-gateway-php

此包已被废弃,不再维护。作者建议使用 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可以在接收请求的投递报告时使用。每个投递报告都将包含一个 id 参数,该参数包含SMSMessage::getCallbackId()函数返回的ID。

您也可以在 require_once() 函数下方添加以下行,作为SMSMessage对象的快捷方式

use MessageCloud\Gateway\SMSMessage as SMSMessage;

使用库

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

测试

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

$ composer test