Release: AWS SDK for PHP 1.2.4

Release Notes>PHP>Release: AWS SDK for PHP 1.2.4
This release adds support for Amazon S3 Website Configuration, IAM User sign-in support for the AWS Management Console and AWS Developer Forums, and an improved documentation experience.

Details

Submitted By: RyanP
Release Date: February 18, 2011 12:08 AM GMT
Latest Version: 1.2.4
Created On: February 18, 2011 12:08 AM GMT
Last Updated: February 18, 2011 12:08 AM GMT

Download

Download the AWS SDK for PHP

New Features

Change Description

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).

Known Issues

Issue Description

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.

Supported API Versions

The AWS SDK for PHP supports the following services and API versions:

Service API Version
Amazon CloudFront 2010-11-01
Amazon CloudWatch 2009-05-15
Amazon Elastic Compute Cloud (Amazon EC2) with Amazon Virtual Private Cloud (Amazon VPC) 2010-08-31
Amazon Elastic MapReduce (Amazon EMR) 2009-03-31
Amazon Relational Database Service (Amazon RDS) 2010-07-28
Amazon Simple Storage Service (Amazon S3) 2006-03-01
Amazon SimpleDB 2009-04-15
Amazon Simple Email Service 2010-12-01
Amazon Simple Notification Service (Amazon SNS) 2010-03-31
Amazon Simple Queue Service (Amazon SQS) 2009-02-01
Auto Scaling 2010-08-01
AWS Elastic Beanstalk 2010-12-01
AWS Identity and Access Management 2010-05-08
AWS Import/Export 2010-06-01
Elastic Load Balancing (ELB) 2010-07-01

Migration Guide

From Release Notes

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

©2017, Amazon Web Services, Inc. or its affiliates. All rights reserved.