Class: Services_Amazon_S3

[line 126]
The main S3 class contains the credentials used for accessing the S3 service and is a starting point for accessing the storage service.

Sample usage:

 require_once 'Services/Amazon/S3.php';

 // Replace with your own credentials
 $accessKeyId = '0PN5J17HBGZHT7JJ3X82';
 $secretAccessKey = 'uV3F3YluFJax1cknvbcGwgjvx4QpvB+leU8dUj2o';
 $s3 = Services_Amazon_S3::getAccount($accessKeyId, $secretAccessKey);

The S3 account instance can now be used to list the buckets owned by this account. A bucket is a file container similar to a filesystem directory, except that it cannot contain subdirectories.

 foreach ($s3->getBuckets() as $bucket) {

     print '<li>' . htmlspecialchars($bucket->name) . '</li>';
 }

Get a specific bucket:

 $bucket = $s3->getBucket('foobar');

Iterate over the objects (files) in a bucket:

 foreach ($bucket->getObjects() as $object) {

     print '<li>' . htmlspecialchars($object->key) . '</li>';
 }

Fetch a specific object:

 $object = $bucket->getObject('foo.gif');

 $object->load();
 $img = imagecreatefromstring($object->data);

Save an object with public read access:

 require_once 'Services/Amazon/S3/AccessControlList.php';

 $object = $bucket->getObject('foo.txt');
 $object->acl = Services_Amazon_S3_AccessControlList::ACL_PUBLIC_READ;
 $object->data = 'lorem ipsum dolor sit amet';
 $object->save();

$accessKeyId =

[line 148]

Amazon Web Services Access Key ID.

$endpoint =  's3.amazonaws.com'

[line 185]

The hostname of the endpoint used for requests done by this class and requests for buckets done with REQUEST_STYLE_VIRTUAL_HOST and REQUEST_STYLE_PATH. This value may be specified per bucket using $bucket->endpoint.

$httpConfig = array('follow_redirects' => true)

[line 162]

Configuration parameters for HTTP_Request2, e.g. proxy server, timeout etc. NOTE: Some options may interfere with this service.

$maxKeys =  false

[line 202]

Maximum number of keys to fetch per request when iterating over the objects of a bucket. A low value will result in more requests to the serve. This value may be specified on the iterator using $iterator->maxKeys.

$maxRetries =  2

[line 209]

Maximum number of retries to make if a request fails with a 500 Internal server error, or if a transport-level error occurs.

$request =  null

[line 221]

Object used to make HTTP requests for the S3 REST API.

$requestStyle =  Services_Amazon_S3_Resource_Bucket::REQUEST_STYLE_VIRTUAL_HOST

[line 174]

The default method for accessing buckets. This value may be specified per bucket using $bucket->requestStyle.

$secretAccessKey =

[line 154]

Amazon Web Services Secret Access Key.

$useSSL =  false

[line 191]

Whether connections should be made using HTTPS.

getAccount   [line 269]

---

getAnonymousAccount   [line 287]

---

getBucket   [line 344]

---

getBuckets   [line 319]

---

getDOMXPath   [line 596]

---

getRequestSignature   [line 373]

---

getURL   [line 302]

---

sendRequest   [line 466]

---

setRequest   [line 247]

---

signString   [line 430]

---