Service/Amazon/S3.php

Show:

inherited

Classes
- \Zend_Service_Amazon_S3

Table of Contents

Zend Framework

LICENSE This source file is subject to the new BSD license that is bundled with this package in the file LICENSE.txt. It is also available through the world-wide-web at this URL: http://framework.zend.com/license/new-bsd If you did not receive a copy of the license and are unable to obtain it through the world-wide-web, please send an email to license@zend.com so we can send you a copy immediately.

Category: Zend
Copyright: Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License
Package: Zend_Service
Subpackage: Amazon_S3
Version: $Id$

\Zend_Service_Amazon_S3
jump to top

Package: Zend_Service\Amazon_S3

Amazon S3 PHP connection class

Parent(s): \Zend_Service_Amazon_Abstract < \Zend_Service_Abstract
See
Category: Zend
Copyright: Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
License: New BSD License

Constants

 
                S3_ENDPOINT
                = 's3.amazonaws.com'

 
                S3_ACL_PRIVATE
                = 'private'

 
                S3_ACL_PUBLIC_READ
                = 'public-read'

 
                S3_ACL_PUBLIC_WRITE
                = 'public-read-write'

 
                S3_ACL_AUTH_READ
                = 'authenticated-read'

 
                S3_REQUESTPAY_HEADER
                = 'x-amz-request-payer'

 
                S3_ACL_HEADER
                = 'x-amz-acl'

 
                S3_CONTENT_TYPE_HEADER
                = 'Content-Type'

Properties

\Zend_Uri_Http $_endpoint

Endpoint for the service

Details

Type: \Zend_Uri_Http

array $_wrapperClients = array()

static

Store for stream wrapper clients

Default valuearray()Details

Type: array

Methods

__construct(string $accessKey = null, string $secretKey = null, string $region = null) : void

Constructor

Parameters

Name	Type	Description
$accessKey	string
$secretKey	string
$region	string

_fixupObjectName(string $object) : string

Make sure the object name is valid

Parameters

Name	Type	Description
$object	string

Returns

Type	Description
string

_makeRequest(string $method, string $path = '', array $params = null, array $headers = array(), string | resource $data = null) : \Zend_Http_Response

Make a request to Amazon S3

Parameters

Name	Type	Description
$method	string	Request method
$path	string	Path to requested object
$params	array	Request parameters
$headers	array	HTTP headers
$data	string \| resource	Request data

Returns

Type	Description
\Zend_Http_Response

_validBucketName(string $bucket) : boolean

Verify if the bucket name is valid

Parameters

Name	Type	Description
$bucket	string

Returns

Type	Description
boolean

addSignature(string $method, string $path, $headers) : string

Add the S3 Authorization signature to the request headers

Parameters

Name	Type	Description
$method	string
$path	string
$headers

Returns

Type	Description
string

cleanBucket(string $bucket) : boolean

Remove all objects in the bucket.

Parameters

Name	Type	Description
$bucket	string

Returns

Type	Description
boolean

copyObject(string $sourceObject, string $destObject, array $meta = null) : boolean

Copy an object

Parameters

Name	Type	Description
$sourceObject	string	Source object name
$destObject	string	Destination object name
$meta	array	(OPTIONAL) Metadata to apply to desination object. `Set to null to copy metadata from source object.`

Returns

Type	Description
boolean

createBucket(string $bucket, $location = null) : boolean

Add a new bucket

Parameters

Name	Type	Description
$bucket	string
$location

Returns

Type	Description
boolean

getBuckets() : array | false

List the S3 buckets

Returns

Type	Description
array \| false

getEndpoint() : \Zend_Uri_Http

Get current S3 endpoint

Returns

Type	Description
\Zend_Uri_Http

getInfo(string $object) : array | false

Get metadata information for a given object

Parameters

Name	Type	Description
$object	string

Returns

Type	Description
array \| false

getMimeType(string $path) : string

static

Attempt to get the content-type of a file based on the extension

Parameters

Name	Type	Description
$path	string

Returns

Type	Description
string

getObject(string $object, bool $paidobject = false) : string | false

Get an object

Parameters

Name	Type	Description
$object	string
$paidobject	bool	This is "requestor pays" object

Returns

Type	Description
string \| false

getObjectStream(string $object, string $streamfile = null, bool $paidobject = false) : \Zend_Http_Response_Stream | false

Get an object using streaming

Can use either provided filename for storage or create a temp file if none provided.

Parameters

Name	Type	Description
$object	string	Object path
$streamfile	string	File to write the stream to
$paidobject	bool	This is "requestor pays" object

Returns

Type	Description
\Zend_Http_Response_Stream \| false

getObjectsAndPrefixesByBucket(string $bucket, array $params = array()) : array | false

List the objects and common prefixes in a bucket.

Provides the list of object keys and common prefixes that are contained in the bucket. Valid params include the following. prefix - Limits the response to keys which begin with the indicated prefix. You can use prefixes to separate a bucket into different sets of keys in a way similar to how a file system uses folders. marker - Indicates where in the bucket to begin listing. The list will only include keys that occur lexicographically after marker. This is convenient for pagination: To get the next page of results use the last key of the current page as the marker. max-keys - The maximum number of keys you'd like to see in the response body. The server might return fewer than this many keys, but will not return more. delimiter - Causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the CommonPrefixes collection. These rolled-up keys are not returned elsewhere in the response.

Parameters

Name	Type	Description
$bucket	string
$params	array	S3 GET Bucket Paramater

Returns

Type	Description
array \| false

Details

See

getObjectsByBucket(string $bucket, array $params = array()) : array | false

List the objects in a bucket.

Provides the list of object keys that are contained in the bucket. Valid params include the following. prefix - Limits the response to keys which begin with the indicated prefix. You can use prefixes to separate a bucket into different sets of keys in a way similar to how a file system uses folders. marker - Indicates where in the bucket to begin listing. The list will only include keys that occur lexicographically after marker. This is convenient for pagination: To get the next page of results use the last key of the current page as the marker. max-keys - The maximum number of keys you'd like to see in the response body. The server might return fewer than this many keys, but will not return more. delimiter - Causes keys that contain the same string between the prefix and the first occurrence of the delimiter to be rolled up into a single result element in the CommonPrefixes collection. These rolled-up keys are not returned elsewhere in the response.

Parameters

Name	Type	Description
$bucket	string
$params	array	S3 GET Bucket Paramater

Returns

Type	Description
array \| false

getWrapperClient(string $name) : \Zend_Service_Amazon_S3

static

Get wrapper client for stream type

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Service_Amazon_S3

isBucketAvailable(string $bucket) : boolean

Checks if a given bucket name is available

Parameters

Name	Type	Description
$bucket	string

Returns

Type	Description
boolean

isObjectAvailable(string $object) : boolean

Checks if a given object exists

Parameters

Name	Type	Description
$object	string

Returns

Type	Description
boolean

moveObject(string $sourceObject, string $destObject, array $meta = null) : void

Move an object

Performs a copy to dest + verify + remove source

Parameters

Name	Type	Description
$sourceObject	string	Source object name
$destObject	string	Destination object name
$meta	array	(OPTIONAL) Metadata to apply to destination object. `Set to null to retain existing metadata.`

putFile(string $path, string $object, array $meta = null) : boolean

Put file to S3 as object

Parameters

Name	Type	Description
$path	string	File name
$object	string	Object name
$meta	array	Metadata

Returns

Type	Description
boolean

putFileStream(string $path, string $object, array $meta = null) : boolean

Put file to S3 as object, using streaming

Parameters

Name	Type	Description
$path	string	File name
$object	string	Object name
$meta	array	Metadata

Returns

Type	Description
boolean

putObject(string $object, string | resource $data, array $meta = null) : boolean

Upload an object by a PHP string

Parameters

Name	Type	Description
$object	string	Object name
$data	string \| resource	Object data (can be string or stream)
$meta	array	Metadata

Returns

Type	Description
boolean

registerAsClient(string $name) : \Zend_Service_Amazon_S3

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Service_Amazon_S3

registerStreamWrapper(string $name = 's3') : \Zend_Service_Amazon_S3

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Service_Amazon_S3

removeBucket(string $bucket) : boolean

Remove a given bucket. All objects in the bucket must be removed prior to removing the bucket.

Parameters

Name	Type	Description
$bucket	string

Returns

Type	Description
boolean

removeObject(string $object) : boolean

Remove a given object

Parameters

Name	Type	Description
$object	string

Returns

Type	Description
boolean

setEndpoint(string | \Zend_Uri_Http $endpoint) : \Zend_Service_Amazon_S3

Set S3 endpoint to use

Parameters

Name	Type	Description
$endpoint	string \| \Zend_Uri_Http

Returns

Type	Description
\Zend_Service_Amazon_S3

unregisterAsClient(string $name) : \Zend_Service_Amazon_S3

Unregister this object as stream wrapper client

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Service_Amazon_S3

unregisterStreamWrapper(string $name = 's3') : \Zend_Service_Amazon_S3

Unregister this object as stream wrapper

Parameters

Name	Type	Description
$name	string

Returns

Type	Description
\Zend_Service_Amazon_S3

Service/Amazon/S3.php

\Zend_Service_Amazon_S3jump to top

Constants

Properties

Methods

\Zend_Service_Amazon_S3
jump to top