<ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA[

Zend Framework: Zend_Service_Rackspace_File Component Proposal

Table of Contents

1. Overview

Zend_Service_Rackspace_File is a class to manage the Cloud Files service of Rackspace.
The Cloud Files is a service to store any files in a cloud environment. A user can store an unlimited quantity of
files and each file can be as large as 5 gigabytes. The files can be private or public. The private files can be accessed using the API of Rackspace. The public files are accessed using a CDN (Content Delivery Network).
Rackspace exposes a REST API to manage the Cloud Files.
Using the API features of Cloud Files you can:

• Upload files programmatically for tight integration with your application
• Enable Cloud Files CDN integration on any container for public distribution
• Create Containers programmatically
• Retrieve lists of containers and files

The Zend_Service_Rackspace_File component will manage all these features.
The current version of the Cloud Files API is 1.0.

2. References

• Cloud Files API
• PHP API for the Cloud Files

3. Component Requirements, Constraints, and Acceptance Criteria

• This component will require a valid Rackspace account.
• This component will implement full Cloud Files REST API.
• This component will throw an Exception in case of a response error.

4. Dependencies on Other Framework Components

• Zend\Http\Client

5. Theory of Operation

Because we would like to implement, in the future, other cloud services of Rackspace (Cloud Servers, Cloud Load Balancers) we propose to write an abstract class (Zend\Service\Rackspace\Rackspace) to share methods and properties common to all the future Rackspace services.
For instance, the authentication request of the Rackspace API is shared between all the cloud services and can be implemented in the abstract class.
Each subclass of Zend\Service\Rackspace will implement a specific service. This proposal is about the Zend\Service\Rackspace\File service.

6. Milestones / Tasks

• Milestone 1: Complete the proposal
• Milestone 2: Prototype of the Zend\Service\Rackspace\File
• Milestone 3: Provide examples and Unit tests (into my zf2 git branch account)
• Milestone 4: Write the documentation

7. Class Index

• Zend\Service\Rackspace\Rackspace
• Zend\Service\Rackspace\Exception
• Zend\Service\Rackspace\File
• Zend\Service\Rackspace\File\Objects
• Zend\Service\Rackspace\File\Containers

8. Use Cases

9. Class Skeletons