|
|
Show all
Featured Wiki Pages:
ExtendingClasses GettingStarted PlannedChanges SupportedServices TechnicalOverview
ExtendingClasses GettingStarted PlannedChanges SupportedServices TechnicalOverview
Summary
Tarzan is a collection of PHP5 classes for working with AWS, specifically S3, EC2, AAWS/ECS, SQS, and SimpleDB.
Developer Description
Tarzan is an object-oriented PHP5 API for working with some of Amazon's web services. Tarzan has a consistent API across classes, is fully object-oriented with little-to-no code duplication across the API, has complete API documentation, and is developed by a commercial entity that uses AWS in pretty hardcore ways. This means that that there will be long-term continued support as well as enhancements and helpers that make the API as useful as possible. The API is fully documented, and support is provided primarily by users, for users. Read and contribute to the documentation wiki.
Current Status (13 July 2008)
- Tarzan is under active development but should be considered a usable beta.
- S3, SQS, and SimpleDB classes are mature. AAWS and EC2 classes are usable but incomplete.
- No official releases have happened yet, but the SVN trunk generally stays pretty stable. (I generally run the latest trunk builds in a production environment. Dogfood, baby!)
- I've begun providing stable trunk snapshots on the downloads page.
- We now have an HTML-based API Reference! It's still missing code samples, so I want to get those in-place ASAP.
Recent Updates (15 July 2008)
- Support for lots of S3 stuff like virtual hosts, "HTTP Condtional Get" for get_object(), bucket logging, query string authentication, BitTorrent URL support, and adjusting the request timestamp (r100, r101).
- Moved the unit tests to the SimpleTest framework (r98, r99).
- Added the ability to get/set access control settings in AmazonS3 (r81).
- Finally added HTML reference documentation (r77).
- Added ability to override and extend core Tarzan classes with custom functionality (r67).
- Moved MultiCURL support into TarzanHTTPRequest and more deeply integrated MultiCURL support throughout AmazonS3 and AmazonSDB (r64, r65).
- Implemented support for copying, moving, and renaming both buckets and objects in AmazonS3 (r61, r63, r65).
- Replaced PEAR HTTP_Request and PEAR Crypt_HMAC classes with the new cURL-based TarzanHTTPRequest and PHP 5.1.2's native hash_hmac() function (r44, r50).
Important Documentation
- API Reference -- Documentation automatically generated from code comments. Kept up-to-date with the latest build.
- Getting Started -- An overview of what you need to do to get rolling on Tarzan.
- Technical Overview -- An overview about the design decisions that were made when building Tarzan, and some of the guts.
- Supported Services -- The list of AWS services we support, and notes on their maturity.
- Planned Changes -- What are some of the changes/enhancements that I already know I'm going to make?
- Alternative Packages -- Looking to use something other than Tarzan? That's fine. Here are the alternative (e.g. competing) packages we're aware of.

