完成后, 目录结构应该像下面这样 :. app.php composer.json composer.phar composer.lock vendor 其中 app.php 是用户的应用程序,vendor/ 目录下包含了所依赖的库, 用户需要在 app.php 中引入依赖 : require_o

Size: px

Start display at page:

Download "完成后, 目录结构应该像下面这样 :. app.php composer.json composer.phar composer.lock vendor 其中 app.php 是用户的应用程序,vendor/ 目录下包含了所依赖的库, 用户需要在 app.php 中引入依赖 : require_o"

士欧野
5 years ago
Views:

1 S3 PHP SDK 使用文档 S3 PHP SDK 说明对象存储 S3 PHP SDK 使用开源的 S3 PHP SDK aws/aws sdk php 本文档介绍用户如何使用 aws/aws sdk php 来使用对象存储服务更加详细的接口参数说明, 请在使用时参照 aws/aws sdk php API 官方说明 sdk php/v3/api/api s html 下面给出的例子是针对 php v 和 aws sdk v 进行测试的此外, 不建议使用最新版本的 aws sdk for php, 因为它需要 php> = 5.5+, 而 RHEL7 和 CENTOS7 上的 PHP 版本是 5.4,php5.5 和最新版本的 aws sdk 的配置选项不同安装 S3 PHP SDK composer 方式 curl -ss php # 在您的 composer.json 中声明对对象存储 SDK for PHP 的依赖 : vi composer.json { require : { aws/aws sdk php : # 安装 php composer.phar install yum install php xml

2 完成后, 目录结构应该像下面这样 :. app.php composer.json composer.phar composer.lock vendor 其中 app.php 是用户的应用程序,vendor/ 目录下包含了所依赖的库, 用户需要在 app.php 中引入依赖 : require_once DIR. '/vendor/autoload.php'; phar 方式使用 phar 单文件方式, 在 sdk php/releases?after= 页面中, 选择版本 , 下载已经打包好的 phar 文件, 然后在你的代码中引入这个文件即可 : require_once '/path/to/aws.phar'; 源码方式使用源码方式, 在 sdk php/releases?after= 页面中, 选择版本 , 下载已经打包好的 aws.zip 文件, 然后在你的代码中引入这个文件即可 : require_once '/path/to/aws-sdk/aws-autoloader.php'; 环境说明 PHP , 可通过 php v 命令查看当前的 PHP 版本 curl 扩展, 可通过 php m 命令查看 curl 扩展是否已经安装好以下示例的环境是通过 composer 方式安装 S3 PHP SDK

3 数据中心 Endpoint beijing 1.cmecloud.cn beijing 2.cmecloud.cn 对应 Location 值 beijing1 beijing2 创建桶的时候指定桶要创建在的区域, 比如要创建的桶要在 beijing1 数据中心的话, 桶的请求的 Endpoint 要写 { LocationConstraint : beijing1, 创建的桶要在 beijing2 数据中心的话, 桶的请求的 Endpoint 要写 { LocationConstraint : beijing2, 设置桶的属性如多版本,ACL, 静态网站, 防盗链, 上传数据到桶, 下载桶内对象的时候, 桶在哪个数据中心, 请求的 Endpoint 就写哪个数据中心不管在哪个数据中心, 用户都能获得用户的桶列表 (list_buckets) 和桶所在的数据中心 (get_bucket_location) SDK 样例新建连接下面的代码会新建一个连接, 可以和服务器交互, 由于对对象存储的任何操作都需要创建与服务端 ENDPOINT 建立连接, 于是将下面保存为 conn.php, 在其它文件中 include require_once DIR. '/vendor/autoload.php'; use Aws\S3\S3Client; $client = S3Client::factory(array( 'base_url' => ' 'port' => '80', 'key' => ' 您的 AccessKey', 'secret' => ' 您的 SecretKey', S3Client::COMMAND_PARAMS => [ 'PathStyle' => true, ], 创建 bucket 新建一个名为 my bucket 的 bucket 在数据中心 beijing1

4 $client->createbucket(array('bucket' => 'my-bucket' 创建在数据中心 beijing2 require_once DIR. '/vendor/autoload.php'; use Aws\S3\S3Client; $client = S3Client::factory(array( 'base_url' => ' 'port' => '80', 'key' => ' 您的 AccessKey', 'secret' => ' 您的 SecretKey', S3Client::COMMAND_PARAMS => [ 'PathStyle' => true, ], $client->createbucket(array('bucket' => 'my-bucket','locationconstr aint'=>'beijing2' 删除空 bucket 删除名为 my bucket 的 bucket 注 :Bucket 下无对象, 也就是该桶为空如果要删除非空桶, 需要先删除桶下所有对象 ( 包含多版本的对象将桶变为空桶 $client->deletebucket(array('bucket' => 'my-bucket' 修改 bucket 的 acl 修改 my bucket 的 acl 为 public read

5 $client->putbucketacl(array('bucket' => 'my-bucket','acl' => 'publi c-read')) 开启 bucket 的多版本开启 my bucket 多版本功能 $res = $client->putbucketversioning([ 'Bucket' => 'my-bucket', 'Status' => 'Enabled' ]); 暂停 bucket 的多版本暂停 my bucket 多版本功能 $res = $client->putbucketversioning([ 'Bucket' => 'my-bucket', 'Status' => 'Suspended' ]); 列出所有 bucket 列出用户所有 bucket

6 $blist = $client->listbuckets(); echo "Buckets belonging to ". $blist['owner']['id']. ":\n"; foreach ($blist['buckets'] as $b) { echo "{$b['name']\t{$b['creationdate']\n"; 列出桶内对象列表列出 my bucket 下所有对象 $o_iter = $client->getiterator('listobjects', array( 'Bucket' => 'my-bucket' foreach ($o_iter as $o) { echo "{$o['key']\t{$o['size']\t{$o['lastmodified']\n"; 上传对象向桶 my bucket 中上传对象名为 : hello.txt, 并且设置为私有 $key = 'hello.txt'; $source_file = './hello.txt'; $acl = 'private'; $bucket = 'my-bucket'; $client->upload($bucket, $key, fopen($source_file, 'rb' $acl); 下载对象从桶 my bucket 下载对象 hello.txt 并将它存为当前目录下的 savetolocal.txt

7 $result = $client->getobject(array( 'Bucket' => 'my-bucket', 'Key' => 'hello.txt' // 'Range' => 'bytes=0-20' // 只下载文件的前 20 个字节 'SaveAs' => "./savetolocal.txt" echo $result['body']; 删除对象删除桶 my bucket 中的对象 hello.txt $client->deleteobject(array( 'Bucket' => 'my-bucket', 'Key' => 'hello.txt', 批量删除对象批量删除桶 my bucket 中对象 my_obj1, my_obj2, my_obj3, my_obj4

8 $client->deleteobjects(array( 'Bucket' => "my-bucket", 'Objects' => array( array( 'Key' => 'my_obj1' array( 'Key' => 'my_obj2' array( 'Key' => 'my_obj3' array( 'Key' => 'my_obj4' ) 修改对象 acl 将 my bucket 桶下对象 hello.txt 的权限变为公开可读 $result = $client->putobjectacl(array( 'Bucket' => 'my-bucket', 'Key' => 'hello.txt', 'ACL' => 'public-read' 生成对象 url 对 my bucket 下的 my object 生成一个有效时间是 5 分钟的带签名的下载 URL

9 $result = $client->getobjecturl('my-bucket', 'my-object',"+5 minute s"); 对象复制将 bucket src 中的对象 object src copy 到 bucket dst 下, 且命名为 object dst $client->copyobject(array( 'Bucket' => "bucket-dst", 'Key' => "object-dst", 'CopySource' => "bucket-src/object-src", 高级分块上传接口除了通过 upload 接口上传文件到对象存储服务器外, 我们还提供了另外一种上传模式 Multipart Upload 用户可以在如下的应用场景内( 但不仅限于此使用 Multipart Upload 上传模式, 如 : 1. 需要支持断点上传 2. 上传超过 100MB 大小的文件 3. 网络条件较差, 和对象存储的服务器之间的链接经常断开 4. 上传文件之前, 无法确定上传文件的大小上传 10GiB.bin 大文件到 my bucket 桶并且命名为 multi 例子 :

10 $uploader = UploadBuilder::newInstance() ->setclient($client) ->setsource('./10gib.bin') ->setbucket("my-bucket") ->setkey("multi") ->setminpartsize(5 * 1024 * 1024) // 每个分块 5MiB ->setoption('acl', 'public-read') // 设置为公开可读, 可选 ->setconcurrency(3) // 启动 3 个线程 ->build(); try { $uploader->upload(); echo "Upload complete.\n"; catch (MultipartUploadException $e) { $uploader->abort(); echo "Upload failed.\n"; echo $e->getmessage(). "\n"; 低级分块上传接口更加底层的分块上传接口上传 10GiB.bin 大文件到 my bucket 桶并且命名为 multi 例子 :

11 $bucket = "my-bucket"; $keyname = "multi"; $filename = "./10GiB.bin"; $result = $client->createmultipartupload(array( 'Bucket' => $bucket, 'Key' => $keyname, 'ACL' => 'public-read' // 设置为公开可读, 可选 $uploadid = $result['uploadid']; // 获取 upload id try { $file = fopen($filename, 'rb'); $parts = array(); $partnumber = 1; while (!feof($file)) { $result = $client->uploadpart(array( 'Bucket' => $bucket, 'Key' => $keyname, 'UploadId' => $uploadid, 'PartNumber' => $partnumber, 'Body' => fread($file, 5 * 1024 * 1024 // 每个分块 5MiB $parts[] = array( 'PartNumber' => $partnumber++, 'ETag' => $result['etag'], ); echo "Uploading part {$partnumber of {$filename.\n"; fclose($file); catch (S3Exception $e) { $result = $client->abortmultipartupload(array( 'Bucket' => $bucket, 'Key' => $keyname, 'UploadId' => $uploadid echo "Upload of {$filename failed.\n"; $result = $client->completemultipartupload(array( 'Bucket' => $bucket, 'Key' => $keyname, 'UploadId' => $uploadid, 'Parts' => $parts,

12 静态网站托管设置错误文档和索引文档和自定义规则 $client->putbucketwebsite(array( 'Bucket' => ' 桶名 ', 'ErrorDocument' => array( 'Key' => ' 错误文档 ' 'IndexDocument' => array( 'Suffix' => ' 索引文档 ' 'RoutingRules' => array( 'RoutingRule' =>array( 'Redirect' =>array( 'HostName' => ' 删除静态网站托管配置 $client->deletebucketwebsite(array( 'Bucket' => ' 桶名 ' 转发所有请求

13 $client->putbucketwebsite(array( 'Bucket' => ' 桶名 ', 'RedirectAllRequestsTo' => array( 'HostName' => ' 'Protocol' => 'http' ) 获取静态网站托管配置 $client->getbucketwebsite( array( 'Bucket' => ' 桶名 ' 获取防盗链配置 $result = $client->getbucketpolicy([ 'Bucket' => ' 桶名 ', // REQUIRED ]); 删除防盗链配置 $result = $client->deletebucketpolicy([ 'Bucket' => ' 桶名 ', // REQUIRED ]); 设置防盗链配置

14 # 单域名 $result = $client->putbucketpolicy([ 'Bucket' => ' 桶名 ', // REQUIRED 'Policy' => '{ "Version": " ", "Statement": [{ "Effect": "Allow", "Principal": "*", "Action": "s3:getobject", "Resource": [ "arn:aws:s3::: 桶名 /*" ], "Condition": { "StringLike": { "aws:referer": " 域名 /*" ] ', ]); # 多域名 $result = $client->putbucketpolicy([ 'Bucket' => ' 桶名 ', // REQUIRED 'Policy' => '{ "Version": " ", "Statement": [{ "Effect": "Allow", "Principal": "*", "Action": "s3:getobject", "Resource": [ "arn:aws:s3::: 桶名 /*" ], "Condition": { "StringLike": { "aws:referer": [" 域名 1/*"," 域名 2/*"] ] ', ]);

15 同一个桶上不建议防盗链和静态网站同时开启, 否则访问静态网站会失败最佳实践 : 桶 1 开启静态网站, 桶 2 存放静态网站需要的图片和视频资源, 然后开启这个桶 2 的防盗链, 设置允许桶 1 的域名访问桶 2 的资源

phar 方式使用 phar 单文件方式, 在 https://github.com/aws/aws sdk php/releases?after= 页面中, 选择版本 , 下载已经打包好的 phar 文件, 然后在你的代码中引入这个文件即可 : require_once

phar 方式使用 phar 单文件方式, 在 https://github.com/aws/aws sdk php/releases?after= 页面中, 选择版本 , 下载已经打包好的 phar 文件, 然后在你的代码中引入这个文件即可 : require_once S3 PHP SDK 使用文档 S3 PHP SDK 说明对象存储 S3 PHP SDK 使用开源的 S3 PHP SDK aws/aws sdk php 本文档介绍用户如何使用 aws/aws sdk php 来使用对象存储服务更加详细的接口参数说明, 请在使用时参照 aws/aws sdkphp API 官方说明 http://docs.aws.amazon.com/aws sdk php/v3/api/api

完成后, 目录结构应该像下面这样 :. app.php composer.json composer.phar composer.lock vendor 其中 app.php 是用户的应用程序,vendor/ 目录下包含了所依赖的库, 用户需要在 app.php 中 引入依赖 : require_o

完成后, 目录结构应该像下面这样 :. app.php composer.json composer.phar composer.lock vendor 其中 app.php 是用户的应用程序,vendor/ 目录下包含了所依赖的库, 用户需要在 app.php 中引入依赖 : require_o