阿里雲 OSS PHP PEAR 套件：Services_Aliyun_OSS 開發實踐

將阿里雲 OSS 官方 SDK 重構為 PEAR 標準套件

阿里雲 OSS 提供海量、低成本、高可靠的物件儲存服務。官方 PHP SDK 未遵循 PEAR 標準，安裝使用不便。本文介紹符合 PEAR 規範的 Services_Aliyun_OSS 套件，支援一鍵安裝、即時引用。

為什麼需要 PEAR 封裝？

• 官方 SDK 依賴亞馬遜 HTTP 庫，非 PHP 原生 HTTP_Request2
• 缺乏統一安裝入口，專案引入需手動管理依賴
• 命名空間與 PSR 標準不符，自動載入困難

安裝與使用

# 發現頻道並安裝
pear channel-discover sinkcup.github.io/pear
pear install sinkcup/Services_Aliyun_OSS

快速上手範例

<?php
require_once 'Services/Aliyun/OSS.php';

$config = [
    'accessKeyId' => 'your_access_key',
    'accessKeySecret' => 'your_secret_key',
];

$oss = new Services_Aliyun_OSS('your-bucket-name', $config);

// 上傳本地檔案至 OSS
$oss->put('/home/u1/2.jpg', '/2.jpg', [
    'Content-Type' => 'image/jpeg',
]);

// 判斷上傳結果
assertArrayHasKey('internet', $result);

專案資源

• 原始碼：GitHub Repository
• PEAR 頻道：https://sinkcup.github.io/pear/
• 官方 SDK 參考：阿里雲 OSS 開發文檔

核心優勢

1. 標準 PEAR 結構，require_once 即用
2. 統一錯誤處理與異常拋出
3. 支援簽名 URL、分片上傳、生命周期管理等高階功能
4. 單元測試覆蓋核心介面