todreacher / api-php-lib
PHP面向对象的Plesk XML-RPC API库
v1.0.6
2019-06-29 16:00 UTC
Requires
- php: ^5.6 || ^7.0
- ext-curl: *
- ext-simplexml: *
- ext-xml: *
Requires (Dev)
- phpunit/phpunit: ^7.0
README
PHP面向对象的Plesk XML-RPC API库。
通过Composer安装
Composer 是安装此库的首选方式
composer require todreacher/api-php-lib
使用示例
以下是一个如何使用此库并创建具有所需属性的客户的示例
$client = new \PleskX\Api\Client($host); $client->setCredentials($login, $password); $client->customer()->create([ 'cname' => 'Plesk', 'pname' => 'John Smith', 'login' => 'john', 'passwd' => 'secret', 'email' => 'john@smith.com', ]);
可以使用密钥而不是密码进行身份验证。
$client = new \PleskX\Api\Client($host); $client->setSecretKey($secretKey)
在创建Plesk扩展时,可以使用内部机制来访问XML-RPC API。由于扩展在Plesk上下文中工作,因此不需要传递身份验证。
$client = new \PleskX\Api\InternalClient(); $protocols = $client->server()->getProtos();
更多示例请参阅tests/目录。
如何运行单元测试
熟悉库的一种可能方式是检查单元测试。
要运行单元测试,请使用以下命令
REMOTE_HOST=你的Plesk主机域名 REMOTE_PASSWORD=密码 composer test
要使用自定义端口,可以提供一个URL(例如Docker容器)
REMOTE_URL=https://你的Plesk主机域名:端口 REMOTE_PASSWORD=密码 composer test
运行测试的另一种方式是使用Docker
docker-compose run tests
持续测试
在积极开发期间,以连续方式运行测试可能更方便。以下是实现此目的的方法
REMOTE_URL=https://你的Plesk主机域名:端口 REMOTE_PASSWORD=密码 composer test:watch