(PHP Extension) Create S3 Bucket in a Region

See more Amazon S3 Examples

Demonstrates how to create an S3 bucket in a specified region. This example will create a bucket in the eu-west-2 region.

For more information, see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html

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.

$rest = new CkRest();

// Connect to the Amazon AWS REST server.
$bTls = true;
$port = 443;
$bAutoReconnect = true;
$success = $rest->Connect('s3.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');
$success = $rest->SetAuthAws($authAws);

// We'll send a PUT request having an XML body such as this:
// <CreateBucketConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
//   <LocationConstraint>BucketRegion</LocationConstraint> 
//   </CreateBucketConfiguration>

// Create the XML body specifying the region as "eu-west-2"
$bucketRegion = 'eu-west-2';
$sbBucketRegion = new CkStringBuilder();
$sbBucketRegion->Append($bucketRegion);

// We only need to specify the LocationConstraint if the bucket's region is NOT us-east-1
$xml = new CkXml();
if (!$sbBucketRegion->ContentsEqual('us-east-1')) {
    $xml->put_Tag('CreateBucketConfiguration');
    $xml->AddAttribute('xmlns','http://s3.amazonaws.com/doc/2006-03-01/');
    $xml->UpdateChildContent('LocationConstraint','eu-west-2');
}

// --------------------------------------------------------------
// IMPORTANT: To create a bucket in the default us-east-1 region,
// do not add the LocationConstraint.  Adding a LocationConstraint of "us-east-1"
// causes an error "The specified location-constraint is not valid."
// By default, the bucket is created in us-east-1 by sending a PUT with an empty body.
// --------------------------------------------------------------

// Set the bucket name via the HOST header.
// In this case, the bucket name is "chilkateuwest2".
$rest->put_Host('chilkateuwest2.s3.amazonaws.com');

// Make the call to create the bucket.

if (!$sbBucketRegion->ContentsEqual('us-east-1')) {
    $responseStr = $rest->fullRequestString('PUT','/',$xml->getXml());
}
else {
    // If the bucket is to be created in the us-east-1 region (the default region)
    // just send a PUT with no body.
    $responseStr = $rest->fullRequestNoBody('PUT','/');
}

if ($rest->get_LastMethodSuccess() != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

if ($rest->get_ResponseStatusCode() != 200) {
    print 'status code = ' . $rest->get_ResponseStatusCode() . "\n";
    $responseXml = new CkXml();
    $responseXml->LoadXml($responseStr);
    print $responseXml->getXml() . "\n";
    print 'Failed.' . "\n";
    exit;
}

print 'Bucket in the eu-west-2 region created.' . "\n";

?>