阿里雲 ACE 平台的 Storage 服務為開發者提供 分布式、高可用、無限擴展 的對象存儲能力,解決分布式環境下「本地檔案系統不共享、實例擴縮容導致數據丟失」的核心痛點。無需引入 SDK、無需申請 AK/SK、無需手動建立 Bucket,直接通過內建 CEStorage 類操作,體驗極簡。
<img>、CDN 加速string upload(string $srcFileName, string $destFileName)
$srcFileName:本地臨時檔案路徑 (如 $_FILES['file']['tmp_name'])$destFileName:存儲對象名 (支援目錄結構,如 avatar/user_123.jpg)xxx.aliapp.com/aliyun_ce_storage/),失敗返回 falsestring read(string $filename)
falsestring getUrl(string $filename)
bool delete(string $filename)
true,失敗 falsebool fileExists(string $filename)
true,不存在 falsearray getList(
string $prefix = '', // 前綴過濾 (如 'avatar/')
int $num = 100, // 最大返回條數
string $marker = '', // 起始標記 (分頁用)
string $delimiter = '' // 分隔符,設為 '/' 僅列出當前「目錄」不遞歸
)
['files'=>[['name'=>..., 'size'=>..., 'time'=>...],...], 'dirs'=>[...]]$delimiter='/' 可模擬目錄瀏覽體驗string errmsg() // 返回最後錯誤訊息
int errno() // 返回錯誤碼
# errno: 0=成功, -1=參數錯誤, -400=無效參數, -404=對象不存在, -500=服務端錯誤
<?php
$storage = new CEStorage();
// 1. 上傳 (處理表單上傳)
if (isset($_FILES['avatar']) && $_FILES['avatar']['error'] === UPLOAD_ERR_OK) {
$url = $storage->upload($_FILES['avatar']['tmp_name'], 'avatar/' . $_FILES['avatar']['name']);
if ($url) {
echo "上傳成功: $url";
// 存入資料庫: UPDATE users SET avatar_url='$url' WHERE id=...
} else {
echo "上傳失敗: " . $storage->errmsg() . " (errno: " . $storage->errno() . ")";
}
}
// 2. 列舉用戶頭像
$list = $storage->getList('avatar/', 50);
foreach ($list['files'] as $f) {
echo "<img src='{$f['name']}' width='50'> {$f['name']} ({$f['size']} bytes)<br>";
}
// 3. 讀取配置檔
if ($storage->fileExists('config/app.json')) {
$config = json_decode($storage->read('config/app.json'), true);
}
// 4. 刪除過期檔案
$storage->delete('temp/old_export.csv');
?>
# 傳統 PHP (本地存儲,分布式環境失效)
move_uploaded_file($_FILES['file']['tmp_name'], '/var/www/uploads/' . $filename);
# ACE 模式 (分布式安全)
$ce = new CEStorage();
$result = $ce->upload($_FILES['file']['tmp_name'], 'uploads/' . $filename);
# $result 為公網 URL,可直接用於前端展示、CDN 回源、資料庫存儲
/aliyun_ce_storage/
├── avatar/ # 用戶頭像
│ ├── user_1.jpg
│ └── user_2.png
├── upload/ # 通用上傳
│ ├── 2024/01/15/xxx.pdf
│ └── 2024/01/16/yyy.docx
├── cache/ # 靜態緩存文件
│ └── sitemap.xml
├── backup/ # 備份導出
│ └── db_20240115.sql.gz
└── public/ # 靜態資源 (CSS/JS/圖片)
└── assets/logo.png
Storage 服務適合中小檔案 (< 100MB)。超大檔案建議:
$url = $storage->upload($tmp, 'avatar/user_123.jpg');
# 縮略: $url . '?x-oss-process=image/resize,w_100,h_100,m_fill'
# 水印: $url . '?x-oss-process=image/watermark,text_SGVsbG8='
# 格式轉換: $url . '?x-oss-process=image/format,webp'
temp/):配置 OSS 生命週期規則,1 天自動刪除backup/):轉冷存儲 (IA/Archive) 降低成本public/):配置 CDN 回源,長期保留| 問題 | 原因 | 解決 |
|---|---|---|
| upload 返回 false | tmp_name 無效 / 檔案過大 / 網路抖動 | 檢查 errno/errmsg;確認 $_FILES['error']===0;重試機制 |
| read 超時/記憶體溢出 | 讀取大檔案進入 PHP 記憶體 | 改用 getUrl 重定向、或 Range 請求分段讀取 |
| getList 遺漏檔案 | 單次最多 1000 條,需分頁 | 使用 marker 分頁循環獲取 |
| 並發上傳同名檔案覆蓋 | 無原子性保證 | 檔名加入 UUID/時間戳/用戶ID:avatar/{uid}_{time}_{uuid}.jpg |
| 權限控制 | 預設公讀 | 敏感文件存私有 Bucket,簽名 URL 限時下載 |
| 維度 | ACE Storage | OSS PHP SDK | 本地檔案系統 |
|---|---|---|---|
| 接入複雜度 | 極低 (new CEStorage()) | 中 (AK/SK/Endpoint/Bucket) | 低 (原生函數) |
| 分布式共享 | ✅ 原生支援 | ✅ 需自行管理 | ❌ 單機綁定 |
| 實例擴縮容安全 | ✅ 數據不丟失 | ✅ 數據不丟失 | ❌ 數據丟失 |
| 功能豐富度 | 基礎 CRUD | 完整 (分片/圖片處理/生命週期/權限/版本控制) | 完整 (受限於單機) |
| 適用場景 | ACE 應用快速開發、中小檔案 | 複雜存儲需求、大檔案、精細權限控制 | 單機應用、臨時緩存 |
ACE Storage 以「零配置、類檔案介面、分布式安全」三大優勢,成為 ACE 應用處理用戶上傳、靜態資源、備份導出的首選存儲抽象層。