前言
花非花霧非霧
SDK下載下傳
環境準備
- PHP 5.3+,可通過
指令檢視目前的PHP版本。php -v
- cURL 擴充,可通過
指令檢視curl擴充是否已經安裝好。php -m
說明:
- 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 require aliyuncs/oss-sdk-php
或者在您的
composer.json
中聲明對Aliyun OSS SDK for PHP的依賴:
i."require": {
-
"aliyuncs/oss-sdk-php": "~2.0"
-
}
通過composer install安裝依賴,安裝完成後,目錄結構應該像下面這樣:其中app.php是使用者的應用程式,vendor/目錄下包含了所依賴的庫,您需要在app.php中引入依賴:
-
require_once __DIR__ . '/vendor/autoload.php';
-
.
-
├── app.php
-
├── composer.json
-
├── composer.lock
-
└── vendor
注意:
- 如果您的項目中已經引用過
,則加入了SDK的依賴之後,不需要再引入
autoload.php
了。
autoload.php
- 如果使用composer出現網絡錯誤,可以使用composer中國區的 鏡像源 ,方法是在指令行執行:
composer config -g repositories.packagist composer http://packagist.phpcomposer.com
- 使用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獲得的AccessKeyId。OSS_ACCESS_ID
-
, 您從OSS獲得的AccessKeySecret。OSS_ACCESS_KEY
-
, 您標明的OSS資料中心通路域名,如OSS_ENDPOINT
。http://oss-cn-hangzhou.aliyuncs.com
-
, 您要用來運作sample使用的bucket,sample程式會在這個bucket中建立一些檔案。OSS_TEST_BUCKET
注意:不能用生産環境的bucket,以免污染使用者資料
- 修改
- 到samples目錄中執行
, 也可以單個運作某個Sample檔案。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 | 日志 |
BucketReferer.php | 防盜鍊 |
BucketWebsite.php | 靜态網站托管 |
BucketCors.php | 跨域資源通路 |
舊版本
本版本相對于
1.*.*
版本是一個大版本更新,接口不再相容,建議使用者使用最新版本的SDK,如果您還是使用
2.0.0
版本以下的sdk,相應文檔可以從
此處下載下傳