Welcome to php-opencloud!
=========================

Installation
------------

Once you have installed the library, you will need to load the autoloader
(which registers all the required namespaces). To do this, place the following
line of PHP code at the top of your application's PHP files:

.. code-block:: php

  require 'Opencloud/autoload.php';

Read the :doc:`getting-started-with-openstack` or
:doc:`getting-started-with-rackspace` to help you get started with basic
Compute operations.

.. note::

  If you are running PHP 5.3, please see our :doc:`using-php-5.3` guide.

Services
--------

.. toctree::
  :glob:
  :maxdepth: 1

  services/**/index

Usage tips
----------

.. toctree::
  :maxdepth: 1

  debugging
  caching-creds
  iterators
  regions
  url-types
  logging
  http-clients
  auth

Help and support
----------------

If you have specific problems or bugs with this SDK, please file an issue on
our official `Github <https://github.com/rackspace/php-opencloud>`_. We also
have a `mailing list <https://groups.google.com/forum/#!forum/php-opencloud>`_,
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 to the project, or require help running the
unit/acceptance tests, please view the `contributing guidelines
<https://github.com/rackspace/php-opencloud/blob/master/CONTRIBUTING.md>`_.
