php-opencloud

PHP SDK for OpenStack/Rackspace APIs

For SDKs in different languages, see http://developer.rackspace.com.

The PHP SDK should work with most OpenStack-based cloud deployments, though it specifically targets the Rackspace public cloud. In general, whenever a Rackspace deployment is substantially different than a pure OpenStack one, a separate Rackspace subclass is provided so that you can still use the SDK with a pure OpenStack instance (for example, see the OpenStack class (for OpenStack) and the Rackspace subclass).

Requirements

• PHP >=5.3.3
• cURL extension for PHP

Installation

You must install this library through Composer:

# Install Composer
curl -sS https://getcomposer.org/installer | php

# Require php-opencloud as a dependency
php composer.phar require rackspace/php-opencloud:dev-master

Once you have installed the library, you will need to load Composer's autoloader (which registers all the required namespaces):

require 'vendor/autoload.php';

And you're ready to go!

---

Alternatively, if you would like to fork or clone the repository into a directory (to work and submit pull requests), you will need to execute:

php composer.phar install

Instead of the require command. You can also specify the --no-dev option if you do not want to install phpDocumentor (which has lots of vendor folders).

Support and Feedback

Your feedback is appreciated! If you have specific problems or bugs with this SDK, please file an issue on Github. We also have a mailing list, so feel free to join to keep up to date with all the latest changes and announcements to the library.

For general feedback and support requests, send an email to sdk-support@rackspace.com.

You can also find assistance via IRC on #rackspace at freenode.net.

Contributing

If you'd like to contribute, see the Contributing guide and the TODO list.

Further Reading

The file docs/quickref.md contains a Quick Reference guide to the php-opencloud library.

The samples/ directory has a collection of tested, working sample code. Note that these may create objects in your cloud for which you could be charged.

If you'd like to contribute to the project, or require help running the unit/acceptance tests, please view the contributing guidelines.