Upload Files to Amazon S3 Bucket 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.

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. You can install it using Composer, the PHP package manager, by running the following command:

composer require aws/aws-sdk-php

Once you have the AWS SDK for PHP installed, you need to configure the SDK with your AWS credentials. The AWS SDK uses the credentials to authenticate your requests to the S3 service. 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.

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 upload a file to an S3 bucket:

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

The putObject() method is used to upload the file. It takes an array of parameters, including the ‘Bucket’, ‘Key’, and ‘Body’ parameters. The ‘Bucket’ parameter specifies the name of the S3 bucket. The ‘Key’ parameter specifies the key under which the file will be stored in the bucket. The ‘Body’ parameter 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.