如果您需要管理OSS儲存空間、上傳下載檔案、管理資料、進行圖片處理等,可以先安裝OSS PHP SDK。本文提供了OSS PHP SDK的多種安裝方式,請結合實際使用情境選用。
環境準備
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
。
查看版本
下載SDK
更多資訊請參見OSS API文檔。
說明
建議您使用最新版本的SDK。OSS PHP SDK 2.0.0以下版本的文檔請從此處下載。
安裝SDK
您可以使用以下三種方式安裝SDK:
composer方式
在專案的根目錄運行composer require aliyuncs/oss-sdk-php
,或者在composer.json
檔案中添加如下依賴關係。
"require": {
"aliyuncs/oss-sdk-php": "~2.4"
}
運行composer install
,安裝依賴。安裝完成後,目錄結構如下:
.
├── src
| └──app.php
├── composer.json
├── composer.lock
└── vendor
其中app.php
是您的應用程式,vendor/
目錄下包含了所依賴的庫。您需要在app.php
中添加依賴關係如下:
require_once __DIR__ . '/../vendor/autoload.php';
phar方式
在GitHub中選擇相應的版本並下載打包好的phar檔案。
在代碼中引入phar檔案:
require_once '/path/to/oss-sdk-php.phar';
源碼方式
在GitHub中選擇相應版本並下載打包好的zip檔案。
解壓後的根目錄中包含一個autoload.php
檔案,在代碼中引入此檔案:
require_once '/path/to/oss-sdk/autoload.php';
常見問題
報錯Your configuration does not allow connection
完整報錯
Your configuration does not allow connection to http://packagist.phpcomposer.com/packages.json. See https://getcomposer.org/doc/06-config.md#secure-http for details
問題現象
在使用 Composer 安裝 SDK 時,出現了串連問題,無法通過 Composer 下載所需的依賴。
問題原因
Composer 的配置預設禁止通過 HTTP 進行串連,出於安全考慮,要求所有串連都必須使用 HTTPS。這是為了確保資料轉送的安全性,防止敏感資訊被泄露或篡改。
解決方案
如果您確實需要通過 HTTP 下載依賴(例如在某些特定的內部網路環境中),可以調整 Composer 的配置以允許 HTTP 串連。
在專案根目錄下,運行以下命令以設定 Composer 允許 HTTP 串連:
composer config secure-http false
。
請注意,禁用 HTTPS 會降低安全性,因此建議在能夠使用 HTTPS 的環境中優先使用安全連線。