upmind / provision-provider-generic-api
This provision category contains common functions which should cover the lifecycle of the majority of provisionable online services. Ships with a custom function definition which can be used for additional flexibility.
Package info
github.com/upmind/provision-provider-generic-api
pkg:composer/upmind/provision-provider-generic-api
Requires
- upmind/provision-provider-base: ^3.7 || ^4.0
Requires (Dev)
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^9.6 || ^10.5 || ^11.0 || ^12.0
- psy/psysh: ^0.12.22
README
This provision category contains common functions which should cover the lifecycle of the majority of provisionable online services. Ships with a custom function definition which can be used for additional flexibility.
Installation
composer require upmind/provision-provider-generic-api
Usage
This library makes use of upmind/provision-provider-base primitives which we suggest you familiarize yourself with by reading the usage section in the README.
Quick-start
The easiest way to see this provision category in action and to develop/test changes is to install it in upmind/provision-workbench.
Alternatively you can start using it for your business immediately with Upmind.com - the ultimate web hosting billing and management solution.
If you wish to develop a new Provider, please refer to the WORKFLOW guide.
Local Docker Development
See DEVELOPMENT.md for full setup and usage instructions.
Supported Providers
The following providers are currently implemented:
Functions
| Function | Parameters | Return Data | Description |
|---|---|---|---|
| create() | CreateParams | ServiceInfo | Creates a new service and returns service information |
| getInfo() | ServiceIdentifierParams | ServiceInfo | Retrieves information about a service |
| suspend() | ServiceIdentifierParams | ServiceInfo | Suspends an active service |
| unsuspend() | ServiceIdentifierParams | ServiceInfo | Unsuspends a suspended service |
| terminate() | ServiceIdentifierParams | Empty Result | Terminates a service |
| changePackage() | ChangePackageParams | ServiceInfo | Changes the package of a service |
| customFunction() | CustomFunctionParams | ServiceInfo | Executes a custom function with custom parameters and returns a mixed result |
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Credits
License
GNU General Public License version 3 (GPLv3). Please see License File for more information.
Upmind
Sell, manage and support web hosting, domain names, ssl certificates, website builders and more with Upmind.com.