Download the PHP package ericnorris/amazon-s3-php without Composer
On this page you can find all versions of the php package ericnorris/amazon-s3-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ericnorris/amazon-s3-php
More information about ericnorris/amazon-s3-php
Files in ericnorris/amazon-s3-php
Package amazon-s3-php
Short Description A lightweight and fast S3 client for PHP.
License MIT
Informations about the package amazon-s3-php
amazon-s3-php
Inspired by tpyo/amazon-s3-php-class, this is a simple and configurable S3 PHP library. It was written to be as lightweight as possible, while still enabling access to all of the features of AWS (e.g. server-side encryption).
Additionally, curl_multi_exec
is used (rather than curl_exec
) for better performance when doing bulk operations.
Usage
$client = new S3($access_key, $secret_key [, $endpoint = null]);
Configuration
Specify Custom Curl Options
$client->useCurlOpts($curl_opts_array)
Provides the S3 class with any curl options to use in making requests.
The following options are passed by default in order to prevent 'hung' requests:
Note: If you call this method, these defaults will not be used.
Send Additional AWS Headers
All of the available S3 operations take an optional $headers
array that will be passed along to S3. These can include x-amz-meta-
, x-amz-server-side-encryption
, Content-Type
, etc. Any Amazon headers specified will be properly included in the AWS signature as per AWS Signature v2.
Request headers that are common to all requests are located here.
S3Response Class
All methods in the S3 class will return an instance of the S3Response class.
If there is an error in curl or an error is returned from AWS, $response->error
will be non-null and set to the following array:
Methods
putObject($bucket, $path, $file [, $headers = array()])
- Uploads a file to the specified path and bucket.
$file
can either be the raw representation of a file (e.g. the result offile_get_contents()
) or a valid stream resource. - AWS Documentation
getObjectInfo($bucket, $path, [, $headers = array()])
- Retrieves metadata for the object.
- AWS Documentation
getObject($bucket, $path [, $resource = null [, $headers = array()]])
- Retrieves the contents of an object. If
$resource
is a valid stream resource, the contents will be written to the stream. Otherwise$response->body
will contain the contents of the file. - AWS Documentation
deleteObject($bucket, $path [, $headers = array()])
- Deletes an object from S3.
- AWS Documentation
getBucket($bucket [, $headers = array()])
- Returns a parsed response from S3 listing the contents of the specified bucket.
- AWS Documentation
Examples
Instantiating the S3 class:
Upload an object
Output:
Download an object
Output: