前言
花非花雾非雾
SDK下载
环境准备
PHP 5.3+，可通过
php -v命令查看当前的PHP版本。cURL 扩展，可通过
php -m命令查看curl扩展是否已经安装好。
说明：
Ubuntu下可以使用apt-get包管理器安装php的cURL扩展
sudo apt-get install php-curlCentOS下可以使用yum包管理器安装php的cURL扩展
sudo yum install php-curlWindows下php、php-curl的安装方法请参看 WIN下编译使用Aliyun OSS PHP SDK
安装
有三种方式安装SDK:
composer方式
phar方式
源码方式
composer方式
-
您可以通过composer安装您的项目依赖，需要您在项目的根目录运行：
composer require aliyuncs/oss-sdk-php
或者在您的composer.json中声明对Aliyun OSS SDK for PHP的依赖：
i."require": {
"aliyuncs/oss-sdk-php": "~2.0"}
require_once __DIR__ . '/vendor/autoload.php';.├── app.php├── composer.json├── composer.lock└── vendor
注意:
如果您的项目中已经引用过
autoload.php，则加入了SDK的依赖之后，不需要再引入autoload.php了。如果使用composer出现网络错误，可以使用composer中国区的镜像源，方法是在命令行执行：
composer config -g repositories.packagist composer http://packagist.phpcomposer.com
phar方式
使用phar单文件方式时，您需要在发布页面中选择相应的版本并下载打包好的phar文件。
-
在您的代码中引入这个文件即可：
require_once '/path/to/oss-sdk-php.phar';
源码方式
使用SDK源码时，您需要在发布页面中选择相应版本并下载打包好的zip文件。
-
解压后的根目录中包含一个
autoload.php文件，您需要在代码中引入这个文件：require_once '/path/to/oss-sdk/autoload.php';
示例程序
您可以通过以下步骤运行示例程序：
解压下载到的sdk包
-
修改samples目录中的Config.php文件
修改
OSS_ACCESS_ID, 您从OSS获得的AccessKeyId。修改
OSS_ACCESS_KEY, 您从OSS获得的AccessKeySecret。修改
OSS_ENDPOINT, 您选定的OSS数据中心访问域名，如http://oss-cn-hangzhou.aliyuncs.com。-
修改
OSS_TEST_BUCKET, 您要用来运行sample使用的bucket，sample程序会在这个bucket中创建一些文件。注意：不能用生产环境的bucket，以免污染用户数据
到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 | 展示了如何设置/读取/清除Bucket的日志 |
| BucketReferer.php | 展示了如何设置/读取/清除Bucket的防盗链 |
| BucketWebsite.php | 展示了如何设置/读取/清除Bucket的静态网站托管 |
| BucketCors.php | 展示了如何设置/读取/清除Bucket的跨域资源访问 |
旧版本
本版本相对于1.*.*版本是一个大版本升级，接口不再兼容，建议用户使用最新版本的SDK，如果您还是使用2.0.0版本以下的sdk，相应文档可以从此处下载。
