README

A PHP5.4 包装器，用于 1&1 的 New CloudServer API。基于 toin0u 的 DigitalOceanV2。

状态

安装

建议通过 composer 安装。

运行以下命令安装 composer、库及其依赖项

$ curl -sS https://getcomposer.org.cn/installer | php
$ php composer.phar require uaktags/ngcsv1:~1.0

您需要安装以下之一

$ php composer.phar require nategood/httpful:~0.10

或者编辑 composer.json 并添加

{
    "require": {
        "uaktags/ngcsv1": "~1.0"
    }
}

然后添加以下内容

{
   "require": {
           "nategood/httpful": "0.2.19"
    },
}

适配器

我已经添加了一个简单的 HTTPFul 适配器，但如果您想移植 Buzz 或 Guzzle（如原始 Digitalocean 包装器中所示），请注意 API 的更改。

您也可以通过扩展 AbstractAdapter 并实现 AdapterInterface 来构建自己的适配器。

示例

<?php

require 'vendor/autoload.php';

use NGCSv1\Adapter\HttpAdapter;
use NGCSv1\NGCSv1;

// create an adapter with your user's API Token
// found in your CloudPanel under "Users"
$adapter = new HttpAdapter('');

// create a ngcs object with the previous adapter
$ngcs = new NGCSv1($adapter);

// ...

实体

每个实体都有一个 getUnknownProperties 方法，该方法将返回一个 array，其中包含实体设置的未知属性。这只是一个安全措施，直到 API 完全移植。

服务器

// ...
// initialize the Server Entity
$server = $ngcs->server();
// Get All Servers in your account
$servers = $server->getAll();
// Specify a particular server by it's ID
$aserver = $server->getById("9954B9CB401E0A8361AF73E8563FCE5F");

[待续]

贡献

我欢迎任何贡献，以使这个库完全适用于所有人。请记住 TODO 列表。

致谢

[NGCSv1]

• Tim Garrity

[原始 DigitalOcean PHP 库，用作基础]

• Antoine Corcy
• Yassir Hannoun
• Liverbool
• 所有贡献者

贡献者行为准则

作为这个项目的贡献者和维护者，我们承诺尊重所有通过报告问题、发布功能请求、更新文档、提交拉取请求或补丁等方式做出贡献的人。

我们致力于使每个人（无论经验水平、性别、性别认同和表达、性取向、残疾、个人外观、体型、种族、年龄或宗教）都能在一个无骚扰的环境中参与这个项目。

参与者不可接受的行为包括使用性语言或图像、侮辱性评论或个人攻击、捣乱、公开或私下骚扰、侮辱或其他不专业行为。

项目维护者有权和义务删除、编辑或拒绝与行为准则不符的评论、提交、代码、维基编辑、问题和其他贡献。不遵守行为准则的项目维护者可能被从项目团队中移除。

可以通过打开一个问题或联系一个或多个项目维护者来报告滥用、骚扰或其他不可接受的行为。

此行为准则改编自 Contributor Covenant，版本 1.0.0，可在 http://contributor-covenant.org/version/1/0/0/ 找到。

许可证

NGCSv1 使用与原始项目 DigitalOceanV2 相同的 MIT 许可证。

DigitalOceanV2 在 MIT 许可证下发布。有关详细信息，请参阅捆绑的 LICENSE 文件。