環境準備

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，安裝依賴。安裝完成后，目錄結構如下：

             .
             ├── src
             |   └──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';