当前位置：首页 > article >正文

【实战教程】PHP与七牛云的完美对接

article 2025/1/19 3:22:06

前言：

随着互联网的迅速发展，越来越多的网站和应用程序需要处理大量的图片、视频和其他文件。为了有效地存储和管理这些文件，并提供快速的内容分发服务，开发者们常常依赖于云存储和CDN服务提供商。

七牛云是一家领先的云存储和CDN服务提供商，为开发者提供高效、可靠的存储和分发解决方案。与七牛云进行对接可以帮助开发者轻松地实现文件上传、下载和分发功能。

本文将分享如何使用PHP语言与七牛云进行对接，并提供相关的代码示例，帮助开发者快速上手。

一、注册七牛云账号

首先，我们需要注册一个七牛云账号并登录，以便获得七牛云提供的存储空间。在七牛云后台，用户可以方便地创建一个新的存储空间，每个存储空间都具有独特的名称。

二、安装七牛云PHP SDK

七牛云提供了适用于PHP开发的SDK。通过Composer可以很方便地进行安装。在项目根目录下，我们需要创建一个composer.json文件，并添加以下内容：

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

Copy

然后在命令行中执行composer install命令，Composer将自动下载并安装七牛云PHP SDK。

三、配置七牛云访问密钥

在使用七牛云SDK之前，需要配置访问密钥。在七牛云后台，找到对应的存储空间，在“密钥管理”页面中可以找到AccessKey和SecretKey，这两个密钥用于API请求的签名认证。

为了简化配置过程，我们可以在项目的配置文件中添加以下内容：

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

Copy

四、上传文件到七牛云存储空间

接下来我们来看一个简单的例子，将本地的图片上传到七牛云存储空间。


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'], "
";
}

Copy

在以上代码中，我们首先通过QiniuAuth类创建一个Auth对象，并使用AccessKey和SecretKey进行初始化。然后使用Auth对象的uploadToken方法生成一个上传Token，参数为存储空间名称。

接着，我们使用QiniuStorageUploadManager类的putFile方法来上传本地文件。其中，token参数为上传Token，token参数为上传Token，key参数为存储在七牛云上的文件名（如果为null，则自动生成一个唯一的文件名），$filePath参数为本地文件路径。上传成功后，会返回一个包含文件信息的数组。

五、使用七牛云存储

在上传文件成功后，我们可以通过七牛云的CDN来访问和显示文件。通过以下格式的URL，可以访问七牛云存储空间中的文件：

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

Copy

其中，<bucket>是存储空间名称，<domain>是七牛云的域名，<key>是文件名。

六、下载七牛云存储的文件

如果需要从七牛云存储中下载文件，可以使用以下代码：


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;

Copy

在以上代码中，我们首先创建了一个BucketManager对象，并使用AccessKey和SecretKey进行初始化。接着，调用BucketManager对象的privateDownloadUrl方法生成一个私有下载链接，该方法需要传入存储空间名称和文件名作为参数。