PHP Classes

StormOnDemand API: Manage hosting services using Storm On Demand API

Recommend this page to a friend!
  Info   View files View files (5)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2024-01-09 (4 days ago) RSS 2.0 feedNot yet rated by the usersTotal: 142 All time: 9,157 This week: 257Up
Version License PHP version Categories
storm-api 1.0GNU General Publi...5.0PHP 5, Web services, Hosting
Description 

Author

This class can manage hosting services using Storm On Demand API.

It can send HTTP requests to Liquid Web's API Web server to perform any operations to manage hosting services supported by the API.

Picture of Jason Gillman Jr.
  Performance   Level  
Name: Jason Gillman Jr. <contact>
Classes: 1 package by
Country: United States United States

Details

php-stormondemand ============ php-stormondemand provides the PHP programmer a library to interact with Liquid Web's Storm API via the **_StormAPI_** class. ### Platforms Supported ### Regardless of whether you are using Liquid Web Storm Servers or Storm on Demand, the API, and subsequently this library, will work. ### API Versions Supported ### The php-stormondemand library will work with any current or future version of the Storm API. Currently, the two versions are: * v1 * bleed ### Requirements ### The php-stormondemand library requires that cURL support be enabled in PHP (see http://www.php.net/manual/en/book.curl.php for more information). ### Basic Usage ### The following is an example script (located in the examples/ directory) that shows basic use: ```php <?php require_once('../StormAPI.class.php'); $apiUser = "api_user"; $apiPass = "api_pass"; $apiMethod = "storm/server/list"; $paramsArray = FALSE; $apiVersion = "v1"; $storm = new \LiquidWeb\StormAPI($apiUser, $apiPass, $apiMethod, $paramsArray, $apiVersion); $storm->addParam("page_size", 999); $results = $storm->request(); foreach($results['items'] as $item) { echo $item['domain'] . " || " . $item['uniq_id'] . "\n"; } ?> ``` Alternatively, the parameter(s) can be passed upon instantiation as so: ```php <?php require_once('../StormAPI.class.php'); $apiUser = "api_user"; $apiPass = "api_pass"; $apiMethod = "storm/server/list"; $paramsArray = array('page_size' => 999); $apiVersion = "v1"; $storm = new \LiquidWeb\StormAPI($apiUser, $apiPass, $apiMethod, $paramsArray, $apiVersion); $results = $storm->request(); foreach($results['items'] as $item) { echo $item['domain'] . " || " . $item['uniq_id'] . "\n"; } ?> ``` PHPDoc blocks are utilized so that code hinting can be used if your IDE supports it. ### Instantiated Method Summary ### The following is just a quick summary of methods that the library provides when a StormAPI object is instatiated, their function, and their parameters. **__construct($apiUser, $apiPass, $apiMethod, $paramsArray = FALSE, $apiVersion = "v1")** The magic constructor method that is called upon instantiation of a **_StormAPI_** object. If you want to pass along a specific version of the API, but don't want to (or can't) pass along parameters upon construction, specify a boolean (I prefer _FALSE_) for _$paramsArray_. **bulkParams($paramsArray)** Allows the passing of multiple parameters via an associative array. **addParam($parameter, $value)** Adds specifies the parameter and its value to be passed along with the API request. **removeParam($parameter)** Removes the specified parameter from being passed along with the API request. **listParams()** Lists any parameters that are currently set. **listMethodParams()** Parses the API documentation and provides parameters associated with the method that is currently being used. Additionally, it shows the optionality of the parameter. **clearParams()** Clears out all of the parameters that may be currently set. **newMethod($apiMethod, $clearparams = TRUE)** Changes the API method to call. Also clears out the parameters by default unless overridden. **listMethods()** Returns a listing of all the API methods available for the version of the API that is being used. **debugInfo()** More of a convenience method that outputs some information that might be useful for debugging purposes. **request($displayFriendly = FALSE)** The method that makes the actual request. When passed with $displayFriendly being _FALSE_, an associative array is returned from the decoded JSON output from the API. When $displayFriendly is _TRUE_, the return is an array consisting of two keys, _'raw'_ and _'display'_. The "display friendly" version of the output is good when a quick glance at the data is needed, as it is displayed in a format with breadcrumbs so you can easilly tell where the data is at. **storeRequest($key)** This method stores the results of an API request by the supplied key. **returnRequests($key, $displayFriendly)** This method returns all of the stored requests if $key is not supplied, or the request for a particular supplied key. The $displayFriendly argument functions just like its counterpart in the request() method. **listRequestKeys()** This method lists they keys for stored requests. **removeRequest($key)** This method removes the stored request for the key given. ### Static Method Summary ### The following are static methods that don't require an instantiated object to run. They have equivalent wrapper methods for instantiated objects to take currently set values as well. **listMethodParamsStatic($apiMethod, $apiVersion = 'v1')** Parses the API documentation and provides parameters associated with the method and version that is passed in. Additionally, it shows the optionality of the parameter. **listMethodsStatic($apiVersion = 'v1')** Returns a listing of all the API methods available for the version of the API that is passed in.

  Files folder image Files  
File Role Description
Files folder imageexamples (2 files)
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation
Plain text file StormAPI.class.php Class StormOnDemand API Class

  Files folder image Files  /  examples  
File Role Description
  Accessible without login Plain text file serverlisting.php Example Example script
  Accessible without login Plain text file StormInteractive.php Appl. Application script

 Version Control Unique User Downloads Download Rankings  
 100%
Total:142
This week:0
All time:9,157
This week:257Up