|
1 | | -OpenStack PHP-Client |
2 | | -==================== |
| 1 | +This project is no longer maintained. |
3 | 2 |
|
4 | | -This package provides PHP OpenStack bindings. |
| 3 | +The contents of this repository are still available in the Git source code |
| 4 | +management system. To see the contents of this repository before it reached |
| 5 | +its end of life, please check out the previous commit with |
| 6 | +"git checkout HEAD^1". |
5 | 7 |
|
6 | | -You can use this library to: |
7 | | - |
8 | | -- Authenticate your application to OpenStack. |
9 | | -- Interact with Object Storage (aka Swift). |
10 | | - |
11 | | -Coming soon: |
12 | | - |
13 | | -- Intect with the Compute (Nova) manager. |
14 | | -- Interact with other OpenStack services |
15 | | - |
16 | | -Requirements |
17 | | ------------- |
18 | | - |
19 | | -- PHP 5.3 |
20 | | -- An active OpenStack account with the desired services. |
21 | | - |
22 | | -Suggestions |
23 | | -~~~~~~~~~~~ |
24 | | - |
25 | | -- Enable the cURL extension for full protocol support. |
26 | | - |
27 | | -We also have support for using PHP's native HTTP stream wrapper, but it |
28 | | -is not as reliable. We recommend cURL. |
29 | | - |
30 | | -Versioning |
31 | | ----------- |
32 | | - |
33 | | -We have a goal to be as consistent as possible with `Semantic |
34 | | -Versioning <http://semver.org/>`__. For released HP Cloud services this |
35 | | -is what you can expect. |
36 | | - |
37 | | -Installation |
38 | | ------------- |
39 | | - |
40 | | -There are currently two methods of installation. We've been considering |
41 | | -PEAR and Phar releases, but have currently limited to only Composer and |
42 | | -builds because these cover our needs. |
43 | | - |
44 | | -Method #1: |
45 | | -~~~~~~~~~~ |
46 | | - |
47 | | -Use `Composer <http://getcomposer.org>`__ to download and install the |
48 | | -latest version of OpenStack. |
49 | | - |
50 | | -Method #2: |
51 | | -~~~~~~~~~~ |
52 | | - |
53 | | -Download a tagged release and include it in your project. |
54 | | - |
55 | | -Features |
56 | | --------- |
57 | | - |
58 | | -Identity Services |
59 | | -~~~~~~~~~~~~~~~~~ |
60 | | - |
61 | | -Authenticate, authorize service usage, and retrieve account information. |
62 | | - |
63 | | -Object Storage |
64 | | -~~~~~~~~~~~~~~ |
65 | | - |
66 | | -Store files or other data objects in containers on your OpenStack object |
67 | | -storage instance. Create, modify and delete containers. Manage ACLs. |
68 | | -Read, write, and delete objects. Expose objects in your object storage |
69 | | -to other services. |
70 | | - |
71 | | -With full stream wrapper support, you can use built-in PHP functions |
72 | | -like ``file_get_contents()``, ``fopen()``, and ``stat()`` for reading |
73 | | -and writing files into object storage. |
74 | | - |
75 | | -Autoloading |
76 | | -^^^^^^^^^^^ |
77 | | - |
78 | | -OpenStack SDK for PHP is `PSR-4 |
79 | | -compliant <https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4.md>`__, |
80 | | -which means that it should work with any PSR-4 autoloader. However, it |
81 | | -also comes with its own autoloader for apps that don't yet make use of a |
82 | | -standard autoloader. |
83 | | - |
84 | | -Composer Support |
85 | | -^^^^^^^^^^^^^^^^ |
86 | | - |
87 | | -OpenStack PHP-Client is available as part of the Packagist archive, |
88 | | -which means you can use Composer to automatically download, install, and |
89 | | -manage revisions to OpenStack from within your project. |
90 | | - |
91 | | -We're big fans of `Composer <http://getcomposer.org>`__. |
92 | | - |
93 | | -More information |
94 | | ----------------- |
95 | | - |
96 | | -`OpenStack <http://OpenStack.org>`__ is a cloud computing platform that |
97 | | -provides many services, inlcuding compute installs, object and block |
98 | | -storage, and a host of hosted services. |
99 | | - |
100 | | -This library provides access to those services. |
101 | | - |
102 | | -The best source of documentation is the official API documentation, |
103 | | -which is available at http://FIXME |
0 commit comments