全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多
对象存储 OSS

安装

更新时间:2018-05-24 13:33:03

SDK下载

建议您使用最新版本的SDK。2.0.0版本以下的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扩展的安装方法请参见 Windows下编译使用阿里云 OSS PHP SDK

安装

有三种方式安装SDK:

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

composer方式

composer方式安装SDK的步骤如下:

  1. 在项目的根目录运行composer require aliyuncs/oss-sdk-php,或者在您的composer.json中声明对阿里云 OSS SDK for PHP的依赖:

    1. "require": {
    2. "aliyuncs/oss-sdk-php": "~2.0"
    3. }
  2. 通过composer install安装依赖。安装完成后,目录结构如下:

    1. .
    2. ├── app.php
    3. ├── composer.json
    4. ├── composer.lock
    5. └── vendor

    其中app.php是用户的应用程序,vendor/目录下包含了所依赖的库。您需要在app.php中引入依赖:

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

说明:

  • 如果您的项目中已经引用过autoload.php,则加入了SDK的依赖之后,不需要再次引入。
  • 如果使用composer出现网络错误,可以使用composer中国区的镜像源。方法是在命令行执行composer config -g repositories.packagist composer http://packagist.phpcomposer.com

phar方式

phar方式安装SDK的步骤如下:

  1. 发布页面中选择相应的版本并下载打包好的phar文件。

  2. 在代码中引入phar文件:

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

源码方式

源码方式安装SDK的步骤如下:

  1. 发布页面中选择相应版本并下载打包好的zip文件。

  2. 解压后的根目录中包含一个autoload.php文件,在代码中引入此文件:

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

示例程序

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

  1. 解压下载的SDK包。

  2. 修改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是您运行示例程序所使用的Bucket。示例程序会在这个Bucket中创建一些文件。
  3. 在samples目录中执行 php RunAll.php, 也可以单独运行某个示例文件。

示例程序包含以下内容:

示例文件 示例内容
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的跨域资源访问
本文导读目录