CloudStack PHP Client

PHP client library for the CloudStack API v4.8 (reference)

This project was originally forked from the following projects:

• qpleple/cloudstack-client-generator
• qpleple/cloudstack-php-client

This project combines these two tools into one project. The code generation is no longer done via scraping of the HTML documentation. We now use the provided listApis call in the CloudStack API to generate the libraries.

The code generated is tagged for phpdoc.

Code Generation

A quick example:

$generator = new \MyENA\CloudStackClientGenerator\Generator(new \MyENA\CloudStackClientGenerator\Configuration(
    [
        'api_key'      => '',               // YOUR_API_KEY (required)
        'secret_key'   => '',               // YOUR_SECRET_KEY (required)
        'host'         => 'localhost',      // Your CloudStack host (required)
        'scheme'       => 'http',           // http or https (defaults to http)
        'port'         => 8080,             // api port (defaults to 8080)
        'path_prefix'  => 'client',         // url prefix (defaults to 'client')
        'api_path'     => 'api',            // admin api path (defaults to 'api')
        'console_path' => 'console',        // console api path (defaults to 'console')
        'output_dir'   => '',               // Where you'd like the generated files to go (defaults to ./output)
        'namespace'    => '',               // The namespace that will be used in the generated files (optional)
        'http_client'  => null,             // GuzzleHttp\ClientInterface compatible client
    ]
));

$generator->generate();

If you do not specify anything for output_dir, all generated files will be placed under output

There are 3 directories of files created by this generated process, however you will only directly interact with 3:

• composer.json : This will be in the root of the output_dir, and should be edited for your specific implementation
• src/CloudStackClient.php : This is the class that you will execute all api calls from
• src/CloudStackConfiguration.php : This is the configuration class that is required when constructing a Client class

PHP Library Usage

Initialization

    $configuration = new CloudStackConfiguration([
        'api_key'      => '',               // YOUR_API_KEY (required)
        'secret_key'   => '',               // YOUR_SECRET_KEY (required)
        'host'         => 'localhost',      // Your CloudStack host (required)
        'scheme'       => 'http',           // http or https (defaults to http)
        'port'         => 8080,             // api port (defaults to 8080)
        'path_prefix'  => 'client',         // url prefix (defaults to 'client')
        'api_path'     => 'api',            // admin api path (defaults to 'api')
        'console_path' => 'console',        // console api path (defaults to 'console')
        'http_client'  => null,             // GuzzleHttp\ClientInterface compatible client
    ]);
    
    $client = new CloudStackClient($config);

Lists

    $vms = $client->listVirtualMachines();
    foreach ($vms as $vm) {
        printf("%s : %s %s", $vm->id, $vm->name, $vm->state);
    }

Asynchronous tasks

    $job = $client->deployVirtualMachine(1, 259, 1);
    printf("VM being deployed. Job id = %s", $job->jobid);

    print "All jobs";

    foreach ($client->listAsyncJobs() as $job) {
        printf("%s : %s, status = %s", $job->jobid, $job->cmd, $job->jobstatus);
    }

You may also optionally wait for a job to finish:

    $result = $client->waitForAsync($job);

Code Generation

Required arguments are enumerated in the function definition and all optional arguments should be passed as an associative array.

Here is an example of a method generated that has one required ($id) and one optional ($forced) argument:

    /**
     * Stops a virtual machine.
     *
     * @param string $id The ID of the virtual machine
     * @param array $optArgs {
     *     @type string $forced Force stop the VM (vm is marked as Stopped even when command fails to be send to the backend).  The caller knows the VM is stopped.
     * }
     * @return \ENA\CloudStack\CloudStackResponse\AsyncJobStartResponse
     */
    public function stopVirtualMachine($id, array $optArgs = []) {
        return $this->doRequest(new CloudStackRequest\StopVirtualMachineRequest(
            $id,
            $optArgs
        ));
    }