Laravel 整合阿里雲 OSS Composer 套件：johnlui/aliyun-oss

緣起

阿里雲官方提供基於命名空間的 V2 版 SDK，但文件不完整、上手門檻較高。為此我封裝了輕量 Composer 套件：johnlui/aliyun-oss。

安裝方式

在 composer.json 的 require 區段新增：

{
    "require": {
        "johnlui/aliyun-oss": "dev-master"
    }
}

執行 composer update 完成安裝。

使用範例

<?php
use JohnLui\AliyunOSS\AliyunOSS;

// 建立 OSSClient 物件
// 參數：Endpoint、AccessKeyId、AccessKeySecret
$oss = AliyunOSS::boot('https://oss-cn-qingdao.aliyuncs.com', $AccessKeyId, $AccessKeySecret);

// 設定 Bucket
$oss = $oss->setBucket($bucketName);

// 上傳檔案（以 public/robots.txt 為例）
// 參數：Object 名稱、本地檔案路徑
$oss->uploadFile('robots.txt', public_path('robots.txt'));

// 取得簽名 URL（帶過期時間）
// 參數：Object 名稱、過期 DateTime 物件
echo $oss->getUrl('robots.txt', new DateTime("+1 day"));

特色

• 鏈式呼叫風格，語意清晰。
• 封裝常用操作（上傳、下載、簽名 URL、刪除等）。
• 相容 Laravel 專案，開箱即用。

歡迎至 GitHub Star 支援！