Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Community-driven add-ons and extensions for the AWS SDK for PHP.
branch: master

This branch is 51 commits ahead of mcasto:master

Failed to load latest commit information.
_compatibility_test Pushing the 1.2 release. See the CHANGELOG for a complete list of cha…
_docs Pushing the 1.2 release. See the CHANGELOG for a complete list of cha…
_samples Pushing the 1.2 release. See the CHANGELOG for a complete list of cha…
_tests/pas Attempted to clean up the broken merge.
extensions Added classes for Google Storage and Eucalyptus Community Cloud.
lib Pushing the 1.2 release. See the CHANGELOG for a complete list of cha…
services
utilities Pushing the 1.2 release. See the CHANGELOG for a complete list of cha…
.gitignore Fixed more more merge issues.
README.md Updated the version number in the README to 3.2.
config-sample.inc.php Merge branch 'master' of git://github.com/amazonwebservices/aws-sdk-f…
package.xml Pushing the 1.0.1 release. See the release notes for high-level chang…
sdk.class.php Pushing the 1.2 release. See the CHANGELOG for a complete list of cha…

README.md

CloudFusion 3.2

CloudFusion is the AWS SDK for PHP, plus some other stuff.

When Amazon Web Services forked CloudFusion to create the AWS SDK for PHP, they effectively took over the primary development of all infrastructure-related services. The Amazon services that are not related to infrastructure (e.g. Amazon Product Advertising API), as well as support for third-party API-compatible services (e.g. Eucalyptus, Google Storage) are maintained by the community as part of CloudFusion.

Most of the improvements will come from Amazon in the form of updates to the AWS SDK for PHP. Additions that are specific to CloudFusion will be updated as needed, but won't be very often. Mostly, we'll simply pull in the latest changes from the AWS GitHub account.

You Should Prefer the AWS SDK for PHP over CloudFusion

Unless you're explicitly using the extra classes that CloudFusion provides, I would highly encourage you to watch/fork the official SDK repository instead of CloudFusion. Let's show our support for the Amazon SDK team.

CloudFusion does not make any changes to the AWS SDK for PHP -- we only add a few classes, and a few CloudFusion-specific entries to the configuration file. If you're only using AWS infrastructure services, you gain nothing by using CloudFusion over the AWS SDK for PHP.

Enabling CloudFusion Extensions

If you're extending CloudFusion or the AWS SDK for PHP with a class prefixed with Amazon or CF, you can add it to the services or utilities directory, respectively.

For classes that don't follow this pattern (e.g., GoogleStorage()) you'll need to add them to the extensions directory, then explicitly enable the AWS_ENABLE_EXTENSIONS option in your configuration file. It is not enabled by default.

NOTE: The AWS_ENABLE_EXTENSIONS configuration option is very greedy autoloader and will attempt a catch-all. If enabled, make sure that sdk.class.php is loaded last to avoid clobbering any other autoloaders. Alternatively, you can leave the AWS_ENABLE_EXTENSIONS disabled by manually including the new class in your project.

Which is Which?

The code that is part of the AWS SDK for PHP vs. CloudFusion is broken up like so.

CloudFusion

Service Location
Amazon Product Advertising API services/pas.class.php
Google Storage extensions/googlestorage.class.php
Eucalyptus extensions/eucalyptus.class.php
Walrus extensions/walrus.class.php

Everything else is part of the AWS SDK for PHP.

Getting Help

Anything that is related to the AWS SDK for PHP should be directed to the PHP Development Forum.

For anything related to the Amazon Product Advertising API, Google Storage, Eucalyptus, or support for other non-Amazon services in CloudFusion, feel free to ask your question on the CloudFusion Google Group.

Contributions

Again, there are Amazon classes and CloudFusion classes. Contributions to AWS SDK for PHP code needs to go through Amazon's contribution process. Contributions to the CloudFusion code can be made very simply in the form of a GitHub pull request.

Something went wrong with that request. Please try again.