AWS SDK for PHP

The AWS SDK for PHP has several official and community integrations for popular PHP frameworks and tools:

• Framework Integrations:
  • AWS Service Provider for Laravel
  • AWS SDK Bundle for Symfony
  • AWS SDK ZF2 Module
  • AWS Service Provider for Silex
• Other Tools:
  • Amazon SNS Message Validator for PHP: Validates SNS messages without requiring the full SDK.
  • Guzzle Version 7: The underlying PHP HTTP client used by the SDK.
  • Serverless LAMP stack guide: A guide for building and deploying serverless PHP applications on AWS.

The SDK provides several high-level features for working with AWS:

• HTTP Clients: Built on Guzzle, supporting persistent connections and asynchronous requests.
• Pagination & Waiters: Easy result pagination via Paginators and service state monitoring via Waiters.
• S3 Multipart Uploader: A tool for Amazon S3 and Amazon Glacier that supports pausing and resuming.
• S3 Stream Wrapper: Allows using native PHP file functions (fopen, etc.) to interact with S3 buckets like a local filesystem.
• S3 Encryption Client: For creating and interacting with encrypted objects in S3.
• DynamoDB Session Handler: For scaling sessions using DynamoDB.
• IAM Instance Profile Credentials: Automatically uses credentials from configured Amazon EC2 instances.

The Amazon S3 Encryption Client for PHP receives regular updates including support for new APIs, features, enhancements, bug fixes, security patches, and documentation. Updates also address changes in dependencies, language runtimes, and operating systems.

It is recommended to stay up-to-date with the latest releases to ensure access to security updates and the latest features. Using unsupported versions is done at the user's discretion.

The V3 encryption client supports reading encrypted objects created with previous versions using extra configuration. It also supports writing objects using non-legacy algorithms.

Migration Guides:

• For migrating from 2.x to 3.x: View Guide
• For migrating from 1.x to 2.x: View Guide

Version 2.3 defaults to the 2012-08-10 Amazon DynamoDB API. To use the 2011-12-05 API, specify the version in the DynamoDbClient factory or in your Aws\ Common\\Aws configuration file.

use Aws\\DynamoDb\\DynamoDbClient;

$client = DynamoDbClient::factory(array(
    'key'     => '<aws access key>',
    'secret'  => '<aws secret key>',
    'region'  => '<region name>',
    'version' => '2011-12-05'
));

If you need assistance, use the following community resources:

• StackOverflow: Tag questions with aws-php-sdk.
• Gitter: Join the AWS SDK for PHP community chat.
• AWS Support: Open a support ticket via the AWS Console.
• GitHub Issues: Use for tracking bugs and feature requests (search existing issues first).
• Amazon Web Services Discussion Forums: For general questions regarding AWS services and limitations.

Version 2.8 is backward-compatible with 2.7, except for the AWS Lambda service which underwent significant API changes. If you need to continue using the 2014-11-11 preview API, specify the version when instantiating the LambdaClient.

use Aws\
Lambda\\LambdaClient;

$client = LambdaClient::factory(array(
    'version' => '2014-11-11',
    // ...
));

The S3EncryptionClientV3 provides an S3 client that supports client-side encryption.

Requirements:

• PHP version: >= 8.1
• PHP extension: openssl

To use it, instantiate a standard Aws\S3\S3Client first, then pass that client into the Aws\S3\Crypto\S3EncryptionClientV3 constructor.

<?php
// Require the Composer autoloader.
require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\S3\Crypto\S3EncryptionClientV3;

// Instantiate an Amazon S3 client.
$s3 = new S3Client([
    'version' => 'latest',
    'region'  => 'us-west-2'
]);

// Instantiate an Amazon S3 Encryption Client V3.
$client = new S3EncryptionClientV3($s3);

The recommended way to install the AWS SDK for PHP is using Composer. Run the following command in your project's base directory to add aws/aws-sdk-php as a dependency.

Minimum Requirements:

• PHP >= 8.1
• cURL extension (highly recommended)
• cURL 7.16.2+ compiled with a TLS backend (e.g., NSS or OpenSSL)

composer require aws/aws-sdk-php

In Version 2.5, the LaunchConfiguration.MonitoringEnabled parameter for the RequestSpotInstances operation was changed to a nested structure: LaunchConfiguration.Monitoring.Enabled. If you use this parameter, you must update your request structure.

// The NEW way
$result = $ec2->requestSpotInstances(array(
    // ...
    'LaunchSpecification' => array(
        // ...
        'Monitoring' => array(
            'Enabled' => true,
        ),
        // ...
    ),
    // ...
));