PHP與七牛雲對接實例分享

PHP與七牛雲對接實例分享

引言：
隨著網路的發展，越來越多的網站和應用程式需要儲存和管理大量的圖片、影片和其他檔案。而七牛雲作為一家領先的雲端儲存和CDN服務供應商，為開發者提供了高效、可靠的儲存和分發解決方案。本文將分享如何使用PHP語言與七牛雲進行對接，並提供相關程式碼範例。

一、註冊七牛雲端帳號
首先我們需要註冊一個七牛雲端帳號，登入後可以獲得七牛雲端儲存空間。在七牛雲後台，我們可以創建一個新的儲存空間，每個儲存空間有一個唯一的名稱。

二、安裝七牛雲PHP SDK
七牛雲提供了適用於PHP開發的SDK，我們可以透過Composer來安裝。在專案根目錄下建立composer.json文件，並新增以下內容：

{
    "require": {
        "qiniu/php-sdk": "^7.0"
    }
}

然後在命令列中執行composer install命令，Composer將自動下載並安裝七牛雲PHP SDK。

三、設定七牛雲端存取金鑰
在使用七牛雲SDK之前，我們需要在專案中設定存取金鑰。在七牛雲後台，找到對應的儲存空間，在「金鑰管理」頁面中可以找到AccessKey和SecretKey，這兩個金鑰用於API請求的簽章認證。

我們可以在專案的設定檔中加入以下內容，將AccessKey和SecretKey替換為你自己的金鑰：

define('QINIU_ACCESS_KEY', 'your_access_key');
define('QINIU_SECRET_KEY', 'your_secret_key');

四、上傳檔案到七牛雲端儲存空間
接下來我們來看一個簡單的例子，將本地的圖片上傳到七牛雲端儲存空間。

<?php
require 'vendor/autoload.php';

use QiniuAuth;
use QiniuStorageUploadManager;

// 获取七牛云访问密钥
$accessKey = QINIU_ACCESS_KEY;
$secretKey = QINIU_SECRET_KEY;

// 初始化Auth对象
$auth = new Auth($accessKey, $secretKey);

// 生成上传Token
$bucket = 'your_bucket_name'; // 替换为你的存储空间名称
$token = $auth->uploadToken($bucket);

// 上传文件
$filePath = '/path/to/your/file.jpg'; // 替换为你的本地文件路径
$uploadManager = new UploadManager();
list($ret, $err) = $uploadManager->putFile($token, null, $filePath);

if ($err !== null) {
    echo "文件上传失败: ", $err->message(), "
";
} else {
    echo "文件上传成功
";
    echo "文件URL: ", $ret['key'], "
";
    echo "文件Hash: ", $ret['hash'], "
";
}
?>

在上述程式碼中，我們先透過QiniuAuth類別建立一個Auth對象，並使用AccessKey和SecretKey進行初始化。然後使用Auth物件的uploadToken方法產生一個上傳Token，參數為儲存空間名稱。

接著，我們使用QiniuStorageUploadManager類別的putFile方法來上傳本機檔案。其中，$token參數為上傳Token，$key參數為儲存在七牛雲上的檔案名稱（如果為null，則自動產生一個唯一的檔案名稱），$filePath參數為本機檔案路徑。上傳成功後，會傳回一個包含檔案資訊的陣列。

五、使用七牛雲端儲存
在上傳檔案成功後，我們可以透過七牛雲的CDN來存取和顯示檔案。透過以下格式的URL，可以存取七牛雲端儲存空間中的檔案：

http://<bucket>.<domain>/<key>

其中，是儲存空間名稱，是七牛雲的域名，是檔名。

六、下載七牛雲端儲存的文件
如果需要從七牛雲端儲存下載文件，可以使用以下程式碼：

<?php
require 'vendor/autoload.php';

use QiniuAuth;
use QiniuStorageBucketManager;

// 获取七牛云访问密钥
$accessKey = QINIU_ACCESS_KEY;
$secretKey = QINIU_SECRET_KEY;

// 初始化Auth对象
$auth = new Auth($accessKey, $secretKey);

// 初始化BucketManager对象
$bucketMgr = new BucketManager($auth);

// 存储空间名称
$bucket = 'your_bucket_name'; // 替换为你的存储空间名称

// 文件名
$key = 'your_file_key'; // 替换为你的文件名

// 生成私有下载链接
$url = $bucketMgr->privateDownloadUrl($bucket, $key);

echo '文件下载链接：', $url;
?>

在以上程式碼中，我們先建立一個BucketManager對象，並使用AccessKey和SecretKey進行初始化。然後，使用BucketManager物件的privateDownloadUrl方法產生一個私人下載鏈接，參數為儲存空間名稱和檔案名稱。

結束語：
透過上述範例，我們可以輕鬆實現PHP與七牛雲的對接，實現檔案的上傳和下載功能。七牛雲提供了豐富的API和工具，開發者可以根據自己的需求進行更具體的功能實現。希望本文對你有幫助，謝謝閱讀！

以上是PHP與七牛雲對接實例分享的詳細內容。更多資訊請關注PHP中文網其他相關文章！