How to Implement Amazon S3 API to Host Static Websites in PHP

Prerequisites

• Ensure that you have AWS SDK for PHP installed. This can be achieved using Composer by executing the following command:

composer require aws/aws-sdk-php

• Make sure you have your AWS credentials stored securely in your environment or in the AWS credentials file.

Configure Your S3 Bucket

• Create an S3 bucket to host your static website. Ensure that the bucket name is unique across AWS.

 

• Enable static website hosting in the bucket settings and set up necessary configurations like index and error documents (e.g., index.html and error.html).

 

• Set the right permissions to make your bucket content publicly accessible. Attach a bucket policy that allows public access:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PublicReadGetObject",
      "Effect": "Allow",
      "Principal": "*",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::your-bucket-name/*"
    }
  ]
}

Connect and Upload Files via PHP

• Initialize the AWS S3 client. Create a PHP script and include the AWS SDK:

require 'vendor/autoload.php';

use Aws\S3\S3Client;

// Instantiate the S3 client with your AWS credentials
$s3Client = new S3Client([
    'version' => 'latest',
    'region'  => 'us-west-2',  // Specify your bucket's region
]);

// Your bucket name
$bucket = 'your-bucket-name';

• Define a function to upload files to the S3 bucket. Make sure to set the appropriate ACL to make the files publicly accessible:

function uploadFileToS3($s3Client, $bucket, $keyName, $filePath)
{
    try {
        // Upload data
        $result = $s3Client->putObject([
            'Bucket' => $bucket,
            'Key'    => $keyName,
            'SourceFile' => $filePath,
            'ACL'    => 'public-read',
        ]);
        return $result->get('ObjectURL');
    } catch (Aws\Exception\S3Exception $e) {
        echo $e->getMessage();
        return false;
    }
}

• Use the function to upload your static website files:

$filePath = '/path/to/your/index.html';
$keyName = 'index.html';

$url = uploadFileToS3($s3Client, $bucket, $keyName, $filePath);

if ($url) {
    echo "File uploaded successfully: $url";
}

Test Your Website

• Navigate to the S3 static website endpoint to access your hosted site. The URL format is typically `http://your-bucket-name.s3-website.region.amazonaws.com`.

 

• Ensure that your website loads properly and all resources are accessible. Use your browser's developer tools to troubleshoot any missing assets or permissions issues.

Maintaining and Updating Your Host

• Whenever your static assets are updated, rerun the PHP upload script to refresh files on S3.

 

• Consider using versioning on your S3 bucket to manage changes and maintain a history of uploaded files.