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

【实战教程】PHP与七牛云的完美对接，你值得拥有！

news 2025/7/22 7:57:12

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

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

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

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

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

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

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

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

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

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

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

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，token参数为上传Token，key参数为存储在七牛云上的文件名（如果为null，则自动生成一个唯一的文件名），$filePath参数为本地文件路径。上传成功后，会返回一个包含文件信息的数组。

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

http://<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;