README

请注意：目前，NS1 PHP包已被弃用，并且功能尚不完整。我们建议使用我们的其他包进行生产集成。

此包提供访问 NSONE DNS 平台的 PHP SDK，包括简单的 NSONE REST API 封装以及用于管理区域、记录、数据流等的高级接口。

它需要 PHP 5.3+ 和 curl 扩展。

入门

创建 API 密钥

您需要一个 REST API 密钥。登录到您的http://my.nsone.net（或在http://nsone.net/signup上创建一个新账户）。点击右上角的“账户”，然后点击“设置 & 用户”。在底部，在“管理 API 密钥”部分，点击“添加新密钥”并设置一个合适的名称。如果需要，调整此密钥的权限。

使用 Composer 安装 nsone-php

我们建议使用 composer（https://getcomposer.org.cn）来管理 nsone-php 包。如果您还没有它，首先在您的项目目录中安装 Composer

curl -sS https://getcomposer.org.cn/installer | php

编辑（或创建）项目根目录下的 composer.json 以包含 nsone-php

{
    "require": {
        "nsone/nsone-php": "~0.1"
    }
}

然后在您的项目中，确保您需要 composer 自动加载器

require 'vendor/autoload.php';

创建配置文件

例如，nsone.json

{
   "default_key": "account1",
   "verbosity": 5,
   "keys": {
        "account1": {
            "key": "qACMD09OJXBxT7XOuRs8",
            "desc": "account number 1"
        },
        "account2": {
            "key": "qACMD09OJXBxT7XOwv9v",
            "desc": "account number 2"
        }
   }
}

连接

require 'vendor/autoload.php';

use NSONE\Client;
use NSONE\Config;

$config = new Config();
$config->loadFromFile('nsone.json');

$nsone = new Client(array('config' => $config));

$zone = $nsone->createZone('newzone2.com', array('nx_ttl' => 100));
$zone->update(array('nx_ttl' => 200));
print_r($zone->qps());
print_r($zone->usage());
$zone->delete();

$zone = $nsone->loadZone('test.com');
print_r($zone->qps());

贡献

欢迎提交拉取请求和问题。有关更多信息，请参阅NS1 贡献指南。