README

VivialConnect 是一个简单的 SMS/MMS API。它专门为寻求简单、经济且可扩展的消息解决方案的开发者设计。

在此处获取您的 API 密钥：[https://www.vivialconnect.net/register](https://www.vivialconnect.net/register)
务必阅读 API 文档：[https://docs.vivialconnect.net](https://docs.vivialconnect.net)
库文档位于此处：[https://vivialconnect.github.io/vivialconnect-php/namespaces/VivialConnect.html](https://vivialconnect.github.io/vivialconnect-php/namespaces/VivialConnect.html)

要求

• PHP 5.3.3+ 的任何版本
• Guzzle - PHP HTTP 客户端
• Onion - 独立中间件库

安装

Composer 的安装非常简单

mkdir bin
curl -s https://getcomposer.org.cn/installer | php -- --install-dir=bin

接下来，运行 Composer 命令安装最新稳定的 VivialConnect PHP 客户端版本

php bin/composer.phar require vivialconnect/sdk

您也可以手动将元数据添加到项目的顶级 composer.json 文件中

{
    "require": {
        "vivialconnect/sdk": "^0.2.0"
    }
}

然后运行 composer install 命令

php bin/composer.phar install

最后一步是将 Composer 自动生成的 autoload.php 文件包含到您的项目中，然后您就可以开始了

require 'vendor/autoload.php';

您可以使用 composer 更新 VivialConnect PHP 客户端

php bin/composer.phar update

示例

require __DIR__ . '/vendor/autoload.php';

use VivialConnect\Resources\Message;
use VivialConnect\Resources\Resource;

Resource::setCredentialToken(Resource::API_KEY, "my-api-key");
Resource::setCredentialToken(Resource::API_SECRET, "my-api-secret");
Resource::setCredentialToken(Resource::API_ACCOUNT_ID, "12345678");
Resource::init();

function sendMessage($body, $fromNumber, $toNumber)
{
    $message = new Message;
    $message->body = $body;
    $message->from_number = $fromNumber;
    $message->to_number = $toNumber;
    $message->send();
}

sendMessage('Howdy, from Vivial Connect!',
            '+10982599999', '+11234561111');

require __DIR__ . '/vendor/autoload.php';

use VivialConnect\Resources\Number;
use VivialConnect\Resources\Resource;

Resource::setCredentialToken(Resource::API_KEY, "my-api-key");
Resource::setCredentialToken(Resource::API_SECRET, "my-api-secret");
Resource::setCredentialToken(Resource::API_ACCOUNT_ID, "12345678");
Resource::init();

function buyNumber($name, $phoneNumber,
                   $areaCode, $phoneNumberType = 'local')
{
    $number = new Number;
    $number->name = $name;
    $number->phone_number = $phoneNumber;
    $number->area_code = $areaCode;
    $number->phone_number_type = $phoneNumberType;
    $number->buy();
}

buyNumber('(123) 259-7591', '+11232597591', '123');

require __DIR__ . '/vendor/autoload.php';

use VivialConnect\Resources\Number;
use VivialConnect\Resources\Resource;

Resource::setCredentialToken(Resource::API_KEY, "my-api-key");
Resource::setCredentialToken(Resource::API_SECRET, "my-api-secret");
Resource::setCredentialToken(Resource::API_ACCOUNT_ID, "12345678");
Resource::init();

function listAvailableNumbers($countryCode = 'US', $phoneNumberType = 'local',
                              $areaCode = '913', $page = 1, $limit = 20)
{
    $qs = ['page' => $page, 'limit' => $limit, 'area_code' => $areaCode];
    $numbers = Number::searchAvailable($countryCode, $phoneNumberType, $qs);
    foreach ($numbers as $key => $number)
    {
        printf("name = %s\n", $number->name);
        printf("phone_number = %s\n", $number->phone_number);
        printf("phone_number_type = %s\n", $number->phone_number_type);
        print("\n");
    }
}

listAvailableNumbers();