前言
花非花雾非雾
SDK下载
环境准备
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方式
源码方式
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,相应文档可以从此处下载。