Upload Files to Amazon S3 Bucket using PHP-2026

Uploading Files to Amazon S3 Using PHP

Uploading files to Amazon S3 (Simple Storage Service) bucket using PHP is a common task in web development, especially when dealing with file storage and retrieval. Amazon S3 is a scalable cloud storage solution provided by Amazon Web Services (AWS), allowing developers to store and retrieve files of any size with ease. In this article, we will explore how to upload files to an Amazon S3 bucket using PHP, step by step.

Prerequisites for Uploading Files to Amazon S3

Before we dive into the code, there are a few prerequisites we need to address. Firstly, you will need an AWS account and access to the AWS Management Console. Secondly, you should have the AWS SDK for PHP installed in your project, since this SDK handles all the low-level communication needed for uploading files to Amazon S3.

You can install it using Composer, the PHP package manager, by running the following command:

composer require aws/aws-sdk-php

Configuring the AWS SDK with Your Credentials

Once you have the AWS SDK for PHP installed, you need to configure the SDK with your AWS credentials. The AWS SDK uses these credentials to authenticate your requests to the S3 service — without them, every attempt at uploading files to Amazon S3 will fail with an authentication error.

You can set the credentials by creating a new instance of the Aws\Sdk class and passing in an array of configuration options. Here’s an example of how you can set the credentials:

require 'vendor/autoload.php';

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

$credentials = [
    'key' => 'YOUR_AWS_ACCESS_KEY_ID',
    'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',
    'region' => 'us-west-2', // Replace with your desired AWS region
];

$s3Client = new S3Client([
    'version' => 'latest',
    'credentials' => $credentials,
]);

Replace 'YOUR_AWS_ACCESS_KEY_ID' and 'YOUR_AWS_SECRET_ACCESS_KEY' with your actual AWS access key ID and secret access key. Also, make sure to set the 'region' option to your desired AWS region. You can find a list of available regions in the AWS documentation.

Writing the Code for Uploading Files to Amazon S3

Now that we have the AWS SDK for PHP configured, we can proceed with the file upload process. To upload a file to an S3 bucket, we need to specify the bucket name, the key (i.e., the desired file name in the bucket), and the path to the file on the local filesystem. Here’s an example of how you can complete the process of uploading files to Amazon S3:

$bucketName = 'your-bucket-name';
$key = 'path/to/your/file.txt';
$filePath = '/path/to/local/file.txt';

try {
    $result = $s3Client->putObject([
        'Bucket' => $bucketName,
        'Key' => $key,
        'Body' => fopen($filePath, 'r'),
    ]);

    echo "File uploaded successfully!";
} catch (AwsException $e) {
    echo "Error uploading file: " . $e->getMessage();
}

In the above code, replace 'your-bucket-name' with the actual name of your S3 bucket. Specify the desired file name (including any desired path) in the $key variable. Set the $filePath variable to the path of the file on your local filesystem.

Understanding the putObject() Method

The putObject() method is used to upload the file and is the core function behind uploading files to Amazon S3 with this SDK. It takes an array of parameters, including the 'Bucket', 'Key', and 'Body' parameters.

• 'Bucket' — specifies the name of the S3 bucket you’re uploading to.
• 'Key' — specifies the path and file name under which the file will be stored inside the bucket.
• 'Body' — accepts a stream or a string of data to upload. In this example, we use fopen() to open the file on the local filesystem as a readable stream, which is memory-efficient even for larger files.

Handling Errors Gracefully

Notice the try/catch block wrapping the upload call. Any issue during uploading files to Amazon S3 — such as invalid credentials, a missing bucket, or insufficient permissions — throws an AwsException, which you can catch and log or display to the user. Always wrap S3 operations in error handling like this in production code, since network calls to an external service can fail for reasons outside your application’s control.