全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

安装

更新时间:2017-08-10 12:38:29

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方式

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

    composer require aliyuncs/oss-sdk-php

  2. 或者在您的composer.json中声明对Aliyun OSS SDK for PHP的依赖:

    1. "require": {
    2. "aliyuncs/oss-sdk-php": "~2.0"
    3. }
  3. 通过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的依赖之后,不需要再引入autoload.php了。
  • 如果使用composer出现网络错误,可以使用composer中国区的镜像源,方法是在命令行执行:composer config -g repositories.packagist composer http://packagist.phpcomposer.com

phar方式

  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 展示了如何设置/读取/清除Bucket的日志
BucketReferer.php 展示了如何设置/读取/清除Bucket的防盗链
BucketWebsite.php 展示了如何设置/读取/清除Bucket的静态网站托管
BucketCors.php 展示了如何设置/读取/清除Bucket的跨域资源访问

旧版本

本版本相对于1.*.*版本是一个大版本升级,接口不再兼容,建议用户使用最新版本的SDK,如果您还是使用2.0.0版本以下的sdk,相应文档可以从此处下载

本文导读目录