Download the PHP package vultr/vultr-php without Composer
On this page you can find all versions of the php package vultr/vultr-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package vultr-php
Vultr API PHP Client.
Getting Started
Must have a PSR7, PSR17, and PSR18 Compatible HTTP Client. View all PSR's This client will act on those interfaces which allow for dependancy injection. See Usage for more info. https://packagist.org/providers/psr/http-client-implementation
Installation
Usage
Initializing the client
Once decided on what HTTP client implementation that will be used to initiate the client. If the client implementation you chose is a wider used client, it may be possible to be auto detected. This is because this client uses PHP-Http/Discovery.
The above code example would try and initialize the client using the HTTP Discovery method. If you wanna customize your http client, or the Discovery Method does not find it, the VultrClient will allow to pass in the PSR18 client along with a PSR17 HTTP Factory.
Using the client
This client implements all the service endpoints in the current iteration of the version 2 api of vultr. Which can be found here.
For more detailed examples view the examples folder.
Pagination
The client uses a linked list to paginate between your cursors. Each list call returns a ListOptions passed by reference which you can manipulate with each subsequent call and thus the function manipulates it as well. This allows you to choose previous and or next cursor links to navigate.
ModelOptions Usage
ModelOptions are objects that allow the user to pass in many arguments that don't neccessarily belong to a Model object. These are attributes that are specific to creation and update functions throughout the client library. Usage of these objects are quite simple. The idea was to reduce code complexity but also give the flexibility to deprecate certain methods when/if attributes are removed from responses.
Lets take InstanceCreate for example. This object has many properties in it, that are all underscore_cased. These property names are than used to generate a request to the api.
To keep the uniformity between the camelCased functions in this client library. ModelOptions makes use of php's __call
magic method. In order to set these protected properties you can use variation of with functions example: withYourLovelyPropName('hello_world') or set functions example: setYourLovelyPropName('hello_world').
These functions will set your attributes that will be used to generate the request of our underscored_props that will be sent to the api.
With the addition of with and set type functions. There are also get functions that can be used as well. They follow the same camcelCased layout as the with and set functions.
Example usage of these object functions.
Exception Usage
All exceptions are children of VultrException.
Exception tree
- VultrException
- VultrClientException
- VultrServiceException
- AccountException
- ApplicationException
- BackupException
- BareMetalException
- BillingException
- BlockStorageException
- DNSException
- FirewallException
- InstanceException
- ISOException
- KubernetesException
- LoadBalancerException
- ObjectStorageException
- OperatingSystemException
- PlanException
- RegionException
- ReservedIPException
- SnapshotException
- SSHKeyException
- StartupScriptException
- UserException
- VPCException
Documentation
See our documentation for detailed information about API v2.
View our code-coverage for a detailed look https://vultr.github.io/vultr-php/code-coverage/index.html
To view the specific library documentation please view https://vultr.github.io/vultr-php/docs/index.html
Versioning
This project follows SemVer for versioning. For the versions available, see the tags on this repository or for stable releases
Contribute
Feel free to send pull requests our way! Please see the contributing guidelines.
License
This project is licensed under the MIT License - see the LICENSE file for details.
All versions of vultr-php with dependencies
ext-json Version *
json-mapper/json-mapper Version ^2.14
psr/http-client Version ^1.0
psr/http-message Version ^1.0
psr/http-factory Version ^1.0
php-http/discovery Version ^1.14