Release: AWS SDK for PHP 1.2.4

Amazon S3 Website Support

You can now host your static websites entirely out of Amazon S3. To host your website in Amazon S3, you create a bucket, upload all your files to the bucket, and configure it as a website. Once your bucket has been configured as a website, you can access all your content via the Amazon S3 website endpoint. For more information on how to host a website on Amazon S3, see: http://docs.amazonwebservices.com/AmazonS3/latest/dev/WebsiteHosting.html.

Configuring an Amazon S3 bucket to serve a static website is easy with the AWS SDK for PHP.

$s3 = new AmazonS3();

/*
  A bucket's website configuration allows you to specify the index document
  and an optional error page. When you request the root of your bucket, or a subdirectory
  in your bucket, the index.html relative to that subdirectory will be returned.
  If you request a resource that doesn't exist, the optional error page
  you specified will be returned instead.
*/
$response = $s3->create_website_config($bucket, array(
    'indexDocument' => 'index.html',
    'errorDocument' => 'error.html'
));

// Handle errors
if (!$response->isOK()) exit('There was an error.');

/*
  You can now access your Amazon S3 contents as a website using the region specific S3
  website endpoint, for example, in the `us-east-1` region:
*/
$my_website_url = sprintf('http://%s.s3-website-us-east-1.amazonaws.com', $bucket);

IAM User sign-in support for the AWS Management Console and AWS Developer Forums

Users created through IAM can now take advantage of AWS features such as the AWS Management Console and the developer forums. An AWS Account owner can create all the credentials Users need to sign in, and Users can access the AWS Management Console and AWS Developer Forums.

This release of the SDK also adds support for the new account alias operations used with the sign-in feature.

Documentation Improvements

The source code of the AWS SDK for PHP now uses the more common PHPDoc format. This enables a greater number of tools to take advantage of the SDK documentation.

We've also rolled out a major update to the SDK API Reference. This update includes:

• A visual design and information architecture refresh based on feedback from users.
• Serialized PHP joins XML and JSON as alternate formats for class documentation.
• Additional information such as related methods, informational links, and documentation of backwards-incompatible changes have been added.
• Tighter integration with PHP.net for classes that extend PHP's built-in classes (e.g., CFArray and CFSimpleXML).

2GB limit for 32-bit stacks

Because PHP's integer type is signed and many platforms use 32-bit integers, the AWS SDK for PHP does not correctly handle files larger than 2GB on a 32-bit stack (whereby "stack" includes CPU, OS, web server, and PHP binary). This is a well-known PHP issue.

For more information, please see: PHP filesize: Return values. A workaround is suggested in AmazonS3::create_mpu_object() with files bigger than 2GB.

1.2.x

Simply replace the existing SDK package with the current release.

1.0–1.1

If you are using the AmazonCloudWatch class:

• Replace the existing SDK package with the current release.

• Update any calls to get_metric_statistics() with the new function signature.

If you are not using the AmazonCloudWatch class, simply replace the existing SDK package with the current release.

CloudFusion 2.5

A migration guide for customers wishing to upgrade from CloudFusion 2.5 to the AWS SDK for PHP 1.0 is located at http://aws.amazon.com/articles/4263