php-opencloud / openstack

PHP SDK for OpenStack clouds
Apache License 2.0
223 stars 149 forks source link

PHP OpenStack SDK

Unit tests Integration Tests Documentation Status

php-opencloud/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

Join the community

Versioning

Openstack SDK follows Semantic Versioning.

Updating between minor versions will not require changes to PHP code or configuration and cause no breaking behavioural changes for consumers.

Version Status PHP Version Support until
^3.2 Latest >=7.2.5, >=8.0 Current
^3.1 Latest >=7.2.5 Current
^3.0 End of life >=7.0 Oct 2020
^2.0 End of life >=7.0,<7.2 March 2018

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

How to install

composer require php-opencloud/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. You don't need to be a PHP expert - all members of the community are welcome!