环境准备

OSS PHP SDK适用于PHP 5.3以上版本。本文以PHP 5.6.22为例。

• 安装环境

  您需要安装PHP和cURL扩展：

  • 在Windows系统中，请参见Windows下编译使用阿里云 OSS PHP SDK来安装PHP和cURL扩展。在Windows环境中，如果提示找不到指定模块，请在php.ini文件中指定extension_dir为C:/Windows/System32/。
  • 在Ubuntu系统中，请使用apt-get包管理器安装PHP的cURL扩展 sudo apt-get install php-curl。
  • 在CentOS系统中，请使用yum包管理器安装PHP的cURL扩展 sudo yum install php-curl。
• 查看版本
  • 通过php -v命令查看当前的PHP版本。
  • 通过php -m命令查看cURL扩展是否已经安装好。

下载SDK

• 通过GitHub下载
• 历史版本下载

更多信息请参见OSS API文档。

安装SDK

您可以使用以下三种方式安装SDK：

• composer方式
  1. 在项目的根目录运行composer require aliyuncs/oss-sdk-php，或者在composer.json文件中添加如下依赖关系。

     "require": {
         "aliyuncs/oss-sdk-php": "~2.4"
     }

  2. 运行composer install，安装依赖。安装完成后，目录结构如下：

     .
             ├── app.php
             ├── composer.json
             ├── composer.lock
             └── vendor

     其中app.php是您的应用程序，vendor/目录下包含了所依赖的库。您需要在app.php中添加依赖关系如下：

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

  说明

  • 如果您的项目中已经引用过autoload.php，则添加了SDK的依赖关系之后，不需要再次引入。
  • 如果使用composer出现网络错误，可以使用composer中国区的镜像源。方法是在命令行执行 composer config -g repositories.packagist composer http://packagist.phpcomposer.com。
• phar方式
  1. 在GitHub中选择相应的版本并下载打包好的phar文件。
  2. 在代码中引入phar文件：

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

• 源码方式
  1. 在GitHub中选择相应版本并下载打包好的zip文件。
  2. 解压后的根目录中包含一个autoload.php文件，在代码中引入此文件：

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