skymailbr / plesk-xml-api
PHP object-oriented library for Plesk API-RPC. forked >> plesk/api-php-lib
Requires
- php: >=7.1
- ext-curl: *
- ext-simplexml: *
- ext-xml: *
- squizlabs/php_codesniffer: ~3.0
Requires (Dev)
- phpunit/phpunit: ^8.0
This package is auto-updated.
Last update: 2024-10-14 08:50:39 UTC
README
PHP object-oriented library for Plesk XML-RPC API.
Install Via Composer
Composer is a preferable way to install the library:
composer require plesk/api-php-lib
Usage Examples
Here is an example on how to use the library and create a customer with desired properties:
$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', ]);
It is possible to use a secret key instead of password for authentication.
$client = new \PleskX\Api\Client($host); $client->setSecretKey($secretKey)
In case of Plesk extension creation one can use an internal mechanism to access XML-RPC API. It does not require to pass authentication because the extension works in the context of Plesk.
$client = new \PleskX\Api\InternalClient(); $protocols = $client->server()->getProtos();
For additional examples see tests/ directory.
How to Run Unit Tests
One the possible ways to become familiar with the library is to check the unit tests.
To run the unit tests use the following command:
REMOTE_HOST=your-plesk-host.dom REMOTE_PASSWORD=password ./vendor/bin/phpunit
To use custom port one can provide a URL (e.g. for Docker container):
REMOTE_URL=https://your-plesk-host.dom:port REMOTE_PASSWORD=password ./vendor/bin/phpunit
One more way to run tests is to use Docker:
docker-compose run tests
Using Grunt for Continuous Testing
- Install Node.js
- Install dependencies via
npm install
command - Run
REMOTE_HOST=your-plesk-host.dom REMOTE_PASSWORD=password grunt watch:test