README

一个非常简单易用的短信发送类，用于aspsms.com网关。

安装

推荐通过Composer进行安装。

composer require nadar/aspsms

用法

<?php

use Aspsms\Aspsms;

// create object class with originator option
$aspsms = new Aspsms('<YOUR_KEY>', '<YOUR_PASSWORD>', array(
    'Originator' => '<MY_SENDER_NAME>'
));

// set message and recipients with tracking their individual tracking numbers.
// attention: verify your tracking numbers first with $aspsms->verifyTrackingNumber(..);
$send = $aspsms->sendTextSms('<YOUR_SMS_MESSAGE>', array(
    '<TRACKING_NR1>' => '<MOBILE_PHONE_NR1>',
    '<TRACKING_NR2>' => '<MOBILE_PHONE_NR2>',
    '<TRACKING_NR3>' => '<MOBILE_PHONE_NR3>'
));

// the message was rejected by aspsms or your authentication credentials where wrong.
if (!$send) {
    echo "[ASPSMS] Error while sending text message: " . $aspsms->getSendStatus();
}

// aspsms takes a little time to delivery your message. You can also send the message and
// store the tracking numbers in a database, so you could retrieve the delivery status later.
sleep(10);

// get deliver status response
$status1 = $aspsms->deliveryStatus('<TRACKING_NR1>');
$status2 = $aspsms->deliveryStatus('<TRACKING_NR2>');
$status3 = $aspsms->deliveryStatus('<TRACKING_NR3>');

var_dump($status1, $status2, $status3);

贡献

快速指南

• 复制仓库。
• 安装依赖： composer install。
• 进行修改。
• 如果你添加了功能或修复了错误 - 请添加单元测试！
• 确保遵循编码标准。

单元测试

为了运行测试套件，请安装开发依赖

composer install

将phpunit.xml.dist文件重命名为phpunit.xml，然后取消以下行的注释，并添加你的常量值

<php>
    <!--<const name="USER_KEY" value="" />-->
    <!--<const name="USER_PASS" value="" />-->
    <!--<const name="SMS_NUMBER" value="" />-->
    <!--<const name="SMS_TRACKING" value="" />-->
</php>

使用以下命令测试你的代码

./vendor/bin/phpunit

在发送新的pull request之前，运行编码标准修复器。

./vendor/bin/php-cs-fixer fix src/

完成了。谢谢！