(PHP Extension) S3 - Working with Buckets in a Region

Demonstrates how to work with S3 buckets located in a particular region.

Chilkat PHP Downloads PHP Extension for Windows, Linux, MacOS, Alpine Linux, Solaris

<?php

// The version number (9_5_0) should match version of the Chilkat extension used, omitting the micro-version number.
// For example, if using Chilkat v9.5.0.48, then include as shown here:
include("chilkat_9_5_0.php");

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// When usig the REST class to access an S3 bucket that has been created in a particular region,
// there are three important things to remember:
// 
// 1) Connect to the domain that includes the region.  For example, instead of connecting to
//    "s3.amazonaws.com", connect to "s3.eu-central-1.amazonaws.com" if your bucket is in the EU Frankfurt region.
//    See http://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region   for a list of S3 region domains (endpoints)
// 
// 2) Set the AuthAws.Region property equal to the region, such as "eu-central-1".
// 
// 3) Include the region in request's Host header.
// 

// This example will upload to a bucket in the eu-central-1 region.
// 
$rest = new CkRest();

// Connect to the Amazon AWS REST server.
$bTls = true;
$port = 443;
$bAutoReconnect = true;
$success = $rest->Connect('s3.eu-central-1.amazonaws.com',$port,$bTls,$bAutoReconnect);

// Provide AWS credentials for the REST call.
$authAws = new CkAuthAws();
$authAws->put_AccessKey('AWS_ACCESS_KEY');
$authAws->put_SecretKey('AWS_SECRET_KEY');
$authAws->put_ServiceName('s3');
$authAws->put_Region('eu-central-1');
$success = $rest->SetAuthAws($authAws);

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkateufrankfurt" (which was created in the eu-central-1 region)
$rest->put_Host('chilkateufrankfurt.s3.eu-central-1.amazonaws.com');

$fileData = new CkBinData();
$success = $fileData->LoadFile('qa_data/jpg/starfish.jpg');

// Upload the file to Amazon S3.
$responseBody = new CkStringBuilder();
$success = $rest->FullRequestBd('PUT','/starfish.jpg',$fileData,$responseBody);
if ($success != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

// Did we get a 200 response indicating success?
$statusCode = $rest->get_ResponseStatusCode();
if ($statusCode != 200) {
    print 'Error response: ' . $responseBody->getAsString() . "\n";
    print 'Status code: ' . $statusCode . ', Status text: ' . $rest->responseStatusText() . "\n";
    exit;
}

print 'File successfully uploaded.' . "\n";

?>