proficlos/vestacp-api

VestaCP PHP API

v1.0.0 2019-11-07 21:21 UTC

Requires

• php: >=7.1
• guzzlehttp/guzzle: ^6.3@dev
• nette/utils: >=2.4

Requires (Dev)

• phpunit/phpunit: 7.5.x-dev
• roave/security-advisories: dev-master
• tracy/tracy: ^3.0@dev

MIT

• PROFI CLOUD SERVICES

README

VestaCP PHP API

How to use

1. Installation

   $ composer require proficlos/vestacp-api

2. Create Client

   a) Easy way

   use ProfiCloS\VestaCP\Client;
   
   // easy way to create Client
   $client = Client::simpleFactory('https://someHost', 'someUser', 'somePass');

   b) For some reasons (more hosts, etc) you may need create objects alone

   use ProfiCloS\VestaCP\Client;
   use ProfiCloS\VestaCP\Authorization\Credentials;
   use ProfiCloS\VestaCP\Authorization\Host;
   
   $credentials = new Credentials('someUser', 'somePassword');
   $host = new Host('https://someHost', $credentials);
   $client = new Client($host);

3. Usage

   // verify login
   $client->testAuthorization(); // bool

   You can simply send one of prepared commands (or you can write own command - must implements \ProfiCloS\VestaCP\Command\ICommand )

   $command = new SomeCommand(); 
   $response = $client->send( $command );
   
   echo $response->getResponseText();

   Or you can use prepared modules

   a) user module

   $userModule = $client->getModuleUser();
   
   $userModule->list(); // returns all users with data
   $userModule->detail('admin'); // returns selected user with data
   $userModule->changePassword('admin', 'otherPa$$word');
   $userModule->add('other_user', 'pa$$word', '[e-mail]');
   $userModule->delete('other_user');
   // ... etc

   b) web module

   $webModule = $client->getModuleWeb('admin'); // web module needs user
   
   $webModule->listDomains();
   $webModule->addDomain('domain.com');
   $webModule->addDomainLetsEncrypt('domain.com', 'www.domain.com'); // needs longer timeout
   $webModule->deleteDomainLetsEncrypt('domain.com');
   $webModule->addDomainFtp('domain.com', 'test', 'pa$$word');
   $webModule->changeDomainFtpPassword('domain.com', 'admin_test', 'otherPa$$word');
   $webModule->changeDomainFtpPath('domain.com', 'admin_test', 'path/other');
   $webModule->deleteDomainFtp('domain.com', 'admin_test');
   $webModule->deleteDomain('domain.com');
   // ... etc

   c) mail module

   $mailModule = $client->getModuleMail('admin'); // mail module needs user
   
   $mailModule->listDomains(); // returns mail domains from selected user
   $mailModule->addDomain('domain.com'); // add domain
   $mailModule->listAccounts('domain.com'); // returns accounts from selected user and domain
   $mailModule->listDomainDkim('domain.com'); 
   $mailModule->listDomainDkimDns('domain.com');
   $mailModule->addAccount('domain.com', 'info', 'pa$$word'); // add [e-mail] account
   $mailModule->changeAccountPassword('domain.com', 'info', 'otherPa$$word'); // change [e-mail] password
   $mailModule->deleteAccount('domain.com', 'info');
   $mailModule->deleteDomain('domain.com');
   // ... etc

   d) db module

   // modules
   $dbModule = $client->getModuleDb(); 
   
   // todo
   // ... etc

   e) cron module

   $cronModule = $client->getModuleCron(); 
   
   // todo
   // ... etc

   f) backup module

   $backupModule = $client->getModuleBackup(); 
   
   // todo
   // ... etc

Buy us a coffee <3

Donate us <3

ETH: 0x7D771A56735500f76af15F589155BDC91613D4aB
UBIQ: 0xAC08C7B9F06EFb42a603d7222c359e0fF54e0a13