阿里云安装 oss sdk

前言

花非花雾非雾

SDK下载

• GitHub地址： GitHub
• 版本迭代： Releases
• SDK API文档： API Doc

环境准备

• PHP 5.3+，可通过

  php -v

  命令查看当前的PHP版本。
• cURL 扩展，可通过

  php -m

  命令查看curl扩展是否已经安装好。

说明：

• Ubuntu下可以使用apt-get包管理器安装php的cURL扩展 

  sudo apt-get install php-curl

• CentOS下可以使用yum包管理器安装php的cURL扩展 

  sudo yum install php-curl

• Windows下php、php-curl的安装方法请参看  WIN下编译使用Aliyun OSS PHP SDK

安装

有三种方式安装SDK:

• composer方式
• phar方式
• 源码方式

1. 您可以通过composer安装您的项目依赖，需要您在项目的根目录运行：

   composer require aliyuncs/oss-sdk-php

  或者在您的

composer.json

中声明对Aliyun OSS SDK for PHP的依赖：

i."require": {

1.  "aliyuncs/oss-sdk-php": "~2.0"

2. }

通过composer install安装依赖，安装完成后，目录结构应该像下面这样：其中app.php是用户的应用程序，vendor/目录下包含了所依赖的库，您需要在app.php中引入依赖：

1. require_once __DIR__ . '/vendor/autoload.php';

2.     .

3.     ├── app.php

4.     ├── composer.json

5.     ├── composer.lock

6.     └── vendor

注意:

• 如果您的项目中已经引用过

  autoload.php

  ，则加入了SDK的依赖之后，不需要再引入

  autoload.php

  了。
• 如果使用composer出现网络错误，可以使用composer中国区的 镜像源 ，方法是在命令行执行：

  composer config -g repositories.packagist composer http://packagist.phpcomposer.com

1. 使用phar单文件方式时，您需要在 发布页面 中选择相应的版本并下载打包好的phar文件。
2. 在您的代码中引入这个文件即可：

   1. require_once '/path/to/oss-sdk-php.phar';

1. 使用SDK源码时，您需要在 中选择相应版本并下载打包好的zip文件。
2. 解压后的根目录中包含一个

   autoload.php

   文件，您需要在代码中引入这个文件：

   1. require_once '/path/to/oss-sdk/autoload.php';

示例程序

您可以通过以下步骤运行示例程序：

1. 解压下载到的sdk包
2. 修改samples目录中的Config.php文件
   1. 修改 

      OSS_ACCESS_ID

      , 您从OSS获得的AccessKeyId。

   2. OSS_ACCESS_KEY

      , 您从OSS获得的AccessKeySecret。

   3. OSS_ENDPOINT

      , 您选定的OSS数据中心访问域名，如 

      http://oss-cn-hangzhou.aliyuncs.com

      。

   4. OSS_TEST_BUCKET

      , 您要用来运行sample使用的bucket，sample程序会在这个bucket中创建一些文件。

      注意：不能用生产环境的bucket，以免污染用户数据

3. 到samples目录中执行 

   php RunAll.php

   ， 也可以单个运行某个Sample文件。

示例程序包括以下内容：

示例文件	示例内容
Object.php	展示了 Object 操作的用法，包括 上传 、 下载 复制 删除 列举 元信息 等
MultipartUpload.php	大文件上传 分片上传 的用法
Signature.php	URL签名授权访问
Callback.php	上传回调
Image.php	图片处理
LiveChannel.php	LiveChannel
Bucket.php	Bucket 管理操作的用法，包括 创建 权限
BucketLifecycle.php	展示了如何设置/读取/清除Bucket的 生命周期
BucketLogging.php	日志
BucketReferer.php	防盗链
BucketWebsite.php	静态网站托管
BucketCors.php	跨域资源访问

旧版本

本版本相对于

1.*.*

版本是一个大版本升级，接口不再兼容，建议用户使用最新版本的SDK，如果您还是使用

2.0.0

版本以下的sdk，相应文档可以从

此处下载