Docs For Class Services_Amazon_S3

[line 109]
Services_Amazon_S3_Stream is a stream wrapper for Amazon S3. With this, buckets and objects can be manipulated using the PHP filesystem functions, e.g. fopen(), file_put_contents(), file_exists() etc.

S3 has no notion of directories but support emulation to some extent using the prefix and delimiter parameters when listing keys in a bucket.

The path "s3://mybucket/myprefix/bar" corresponds to the object key "myprefix/bar" in the bucket called "mybucket". "s3://mybucket/myprefix" is considered a directory containing all objects with keys beginning with "myprefix".

This class is used by the PHP stream wrapper API and shouldn't be called directly, except for Services_Amazon_S3_Stream::register().

Various options may be specified using Services_Amazon_S3_Stream::register() or using a PHP stream context.

Available options are:

access_key_id string 20-character key id
secret_access_key string 40-character secred key
http_options array is mapped to $s3->httpOptions
use_ssl bool maps to $s3->useSSL
request_style string maps to $s3->useSSL
endpoint string maps to $s3->endpoint
acl string|Services_Amazon_S3_AccessControlList applies this ACL to new files
strict bool use strict mode (see below) - the default is false

The wrapper assumes that all paths names are encoded in UTF-8.

Strict mode: S3 buckets has no directory structure but just treats a path with slashes as verbatim string. Contrary to a regular filesystem this makes it possible to create an object with the key "foo/bar/baz" without "foo/bar" being created in advance. When strict mode is enabled, this wrapper makes extra sanity checks to ensure that a directory exists before accessing it using opendir() or creating a file or directory inside it using fopen() or mkdir(). Also it verified that a file exists when calling unlink(), and that a directory does not already exist when calling mkdir(). These extra sanity checks require additional requests to the server. Most code will not require these checks, so by default strict mode is disabled.

Author: Christian Schmidt <chsc@peytz.dk>
Version: Release: 0.2.0
Copyright: 2008-2009 Peytz & Co. A/S
Link: http://pear.php.net/package/Services_Amazon_S3
License: New BSD License

dir_closedir [line 813]

bool dir_closedir(
)

Support for closedir().

Return: always returns true
See: http://www.php.net/manual/en/function.closedir.php
Access: public

[ Top ]

dir_opendir [line 695]

bool dir_opendir(
string
$path, string
$options)

Support for opendir().

Return: true on success
See: http://www.php.net/manual/en/function.opendir.php
Access: public

Parameters:

string	`$path`	—	the path to the directory
string	`$options`	—	unknown (parameter is not documented in PHP Manual)

[ Top ]

dir_readdir [line 746]

string|bool dir_readdir(
)

Support for readdir().

Return: the next filename, or false if there are no more files in the directory
See: http://www.php.net/manual/en/function.readdir.php
Access: public

[ Top ]

dir_rewinddir [line 796]

bool dir_rewinddir(
)

Support for rewinddir().

Return: always returns true
See: http://www.php.net/manual/en/function.rewinddir.php
Access: public

[ Top ]

mkdir [line 556]

bool mkdir(
string
$path, int
$mode, int
$options)

Support for mkdir().

Return: true if directory was successfully created
See: http://www.php.net/manual/en/function.mkdir.php
Access: public

Parameters:

string	`$path`	—	the directory path
int	`$mode`	—	permission flags - see mkdir()
int	`$options`	—	a bit mask of STREAM_REPORT_ERRORS and STREAM_MKDIR_RECURSIVE

[ Top ]

register [line 246]

void register(
[string
$wrapper = 's3'], [array
$options = array()])

Unless anonymous access is wanted, the common way to register the wrapper is this:

 Services_Amazon_S3_Stream::register('s3',

   array('access_key_id'     => '0PN5J17HBGZHT7JJ3X82',
         'secret_access_key' => 'uV3F3YluFJax1cknvbcGwgjvx4QpvB+leU8dUj2o'));

The wrapper may be registered multiple times with different prefixes to allow access using different access keys.

Options may also be specified using a PHP stream context.

Access: public

Parameters:

string	`$wrapper`	—	the wrapper scheme, i.e. the string preceding "://" in paths like "s3://mybucket/mykey"
array	`$options`	—	associate array of key-value pairs

[ Top ]

rename [line 516]

bool rename(
string
$fromPath, string
$toPath)

Support for rename(). The renaming isn't atomic as rename() usually is, but the write part is.

Return: true if file was successfully renamed
See: http://www.php.net/manual/en/function.rename.php
Access: public

Parameters:

string	`$fromPath`	—	the path to the file to rename
string	`$toPath`	—	the new path to the file

[ Top ]

rmdir [line 602]

bool rmdir(
string
$path, int
$options)

Support for rmdir().

Note: This method uses @ to suppress errors from unlink().

Return: true if directory was successfully removed
See: http://www.php.net/manual/en/function.rmdir.php
Access: public

Parameters:

string	`$path`	—	the directory path
int	`$options`	—	a bit mask of STREAM_REPORT_ERRORS

[ Top ]

stream_close [line 432]

void stream_close(
)

Support for fclose().

See: http://www.php.net/manual/en/function.fclose.php
Access: public

[ Top ]

stream_eof [line 364]

bool stream_eof(
)

Support for feof().

Return: true if end-of-file has been reached, otherwise false
See: http://www.php.net/manual/en/function.feof.php
Access: public

[ Top ]

stream_flush [line 390]

bool stream_flush(
)

Support for fflush().

Return: true if data was successfully stored (or there was no data to store
See: http://www.php.net/manual/en/function.fflush.php
Access: public

[ Top ]

stream_open [line 266]

bool stream_open(
string
$path, string
$mode, int
$options, string
&$opened_path)

Support for fopen(). Also used by file_get_contents() and file_put_contents().

Return: true on success
Access: public

Parameters:

string	`$path`	—	the path to open
string	`$mode`	—	the file mode ( "r", "wb" etc.)
int	`$options`	—	a bit mask of STREAM_USE_PATH and STREAM_REPORT_ERRORS
string	`&$opened_path`	—	the file actually opened

[ Top ]

stream_read [line 340]

string|false stream_read(
int
$count)

Support for fread(), file_get_contents() etc.

Return: the read string, or false in case of an error
See: http://www.php.net/manual/en/function.fread.php
Access: public

Parameters:

int $count — maximum number of bytes to be read

[ Top ]

stream_seek [line 378]

bool stream_seek(
int
$offset, int
$whence)

Support for fseek().

Return: true on success
See: http://www.php.net/manual/en/function.fseek.php
Access: public

Parameters:

int	`$offset`	—	the byte offset to got to
int	`$whence`	—	SEEK_SET, SEEK_CUR, or SEEK_END

[ Top ]

stream_stat [line 413]

array stream_stat(
)

Support for fstat().

Return: an array with file status, or false in case of an error
- see fstat() for a description of this array
See: http://www.php.net/manual/en/function.fstat.php
Access: public

[ Top ]

stream_tell [line 401]

int stream_tell(
)

Support for ftell().

Return: byte offset from beginning of file
See: http://www.php.net/manual/en/function.ftell.php
Access: public

[ Top ]

stream_write [line 353]

int stream_write(
string
$data)

Support for fwrite(), file_put_contents() etc.

Return: number of bytes written
See: http://www.php.net/manual/en/function.fwrite.php
Access: public

Parameters:

string $data — the data to be written

[ Top ]

unlink [line 478]

bool unlink(
string
$path)

Support for unlink().

Return: true if file was successfully deleted
See: http://www.php.net/manual/en/function.unlink.php
Access: public

Parameters:

string $path — the file path

[ Top ]

url_stat [line 642]

array url_stat(
string
$path, int
$flags)

Support for stat().

Return: an array with file status, or false in case of an error
- see fstat() for a description of this array
See: http://www.php.net/manual/en/function.stat.php
Access: public

Parameters:

string	`$path`	—	the to get information about.
int	`$flags`	—	a bit mask of STREAM_URL_STAT_LINK and STREAM_URL_STAT_QUIET

[ Top ]

Class: Services_Amazon_S3_Stream

Class Overview

Author(s):

Version:

Copyright:

Variables

Methods

Inherited Variables

Inherited Methods

Class Details

Class Variables

$context =

Method Detail

dir_closedir [line 813]

dir_opendir [line 695]

Parameters:

dir_readdir [line 746]

dir_rewinddir [line 796]

mkdir [line 556]

Parameters:

register [line 246]

Parameters:

rename [line 516]

Parameters:

rmdir [line 602]

Parameters:

stream_close [line 432]

stream_eof [line 364]

stream_flush [line 390]

stream_open [line 266]

Parameters:

stream_read [line 340]

Parameters:

stream_seek [line 378]

Parameters:

stream_stat [line 413]

stream_tell [line 401]

stream_write [line 353]

Parameters:

unlink [line 478]

Parameters:

url_stat [line 642]

Parameters: