blob: 6b6084085f43c5f7ca94bd504f5adc5a130ed053 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
# PHP OpenStack SDK
[![Build Status](https://travis-ci.org/php-opencloud/openstack.svg?branch=master)](https://travis-ci.org/php-opencloud/openstack)
[![Coverage Status](https://coveralls.io/repos/github/php-opencloud/openstack/badge.svg?branch=master)](https://coveralls.io/github/php-opencloud/openstack?branch=master)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/php-opencloud/openstack/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/php-opencloud/openstack/?branch=master)
`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
* [Official documentation](https://php-openstack-sdk.readthedocs.io/en/latest/)
* [Reference documentation](http://refdocs.os.php-opencloud.com)
* [Contributing guide](/CONTRIBUTING.md)
* [Code of Conduct](/CODE_OF_CONDUCT.md)
## We need your help :smiley:
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 | :white_check_mark: |
|Red Hat OpenStack | Need sponsor! |
|OVH OpenStack | Need sponsor! |
|SUSE OpenStack | Need sponsor! |
|Canonical OpenStack | Need sponsor! |
|RackSpace OpenStack | Need sponsor! |
## Join the community
- Meet us on Slack: https://phpopencloud.slack.com ([Get your invitation](https://launchpass.com/phpopencloud))
- Report an issue: https://github.com/php-opencloud/openstack/issues
## Version Guidance
| Version | Status | PHP Version | Support until |
| --------- | --------------------------- | ------------- | ----------------------- |
| `^3.1` | Latest | `>=7.2.5` | Oct 2023 |
| `^3.0` | Bug fixed only | `>=7.0` | Oct 2020 |
| `^2.0` | EOL (Bug fixes only) | `>=7.0,<7.2` | March 2018 |
## Upgrade from 2.x to 3.x
Due to new [object typehint](https://wiki.php.net/rfc/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](https://github.com/php-opencloud/openstack/pull/184).
## Requirements
* PHP 7.0
* `ext-curl`
## How to install
```bash
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](CONTRIBUTING.md) 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](https://github.com/php-opencloud/openstack/issues/new) or
[contact us](https://developer.rackspace.com/support/). You don't need to be a PHP expert - all members of the
community are welcome!
|