README

netsons/openstack is an SDK which allows PHP developers to easily connect to OpenStack APIs in a simple and idiomatic way. This binding is specifically designed for OpenStack APIs, but other provider SDKs are available. Multiple OpenStack services, and versions of services, are supported.

Links

• Official documentation
• Reference documentation
• Contributing guide
• Code of Conduct

We need your help 😃

We invest a large amount of work to ensure this SDK works with many OpenStack distributions via running end-to-end integration tests with a real cluster.

If you or your organization are in a position that can help us access popular distributions as listed below, do reach out by open an issue in github.

Distribution
OpenStack RDO MicroStack Openstack	Sponsored by
Red Hat OpenStack	Need sponsor!
OVH OpenStack	Need sponsor!
SUSE OpenStack	Need sponsor!
RackSpace OpenStack	Need sponsor!

Join the community

• Meet us on Slack: https://phpopencloud.slack.com (Get your invitation)
• Report an issue: https://github.com/php-opencloud/openstack/issues

Version Guidance

Upgrade from 2.x to 3.x

Due to new object typehint since PHP 7.2, Object is a reserved keyword thus class OpenStack\ObjectStore\v1\Models\Object had to be renamed to OpenStack\ObjectStore\v1\Models\StorageObject.

This change was introduced in #184.

Requirements

• PHP 7.0
• ext-curl

How to install

composer require netsons/openstack

Contributing

Engaging the community and lowering barriers for contributors is something we care a lot about. For this reason, we've taken the time to write a contributing guide for folks interested in getting involved in our project. If you're not sure how you can get involved, feel free to submit an issue or contact us. You don't need to be a PHP expert - all members of the community are welcome!