Laravel 七牛(七牛配置)

解决方案简述

在现代Web开发中，Laravel框架以其优雅的语法和强大的功能而备受开发者青睐。在处理文件存储时，本地存储可能无法满足所有需求。这时，使用第三方云存储服务（如七牛云）就显得尤为重要。如何在Laravel项目中集成七牛云存储，并提供多种配置思路。

一、安装七牛 SDK

我们需要通过Composer安装七牛云的PHP SDK。打开命令行工具，在项目根目录下执行以下命令：

bash composer require qiniu/php-sdk

这将自动下载并安装七牛云所需的类库。

二、配置环境变量

为了确保安全性以及便于管理，建议将七牛云的相关密钥信息存放在.env文件中。编辑.env文件，添加如下内容：

properties QINIU_ACCESS_KEY=your_access_key_here QINIU_SECRET_KEY=your_secret_key_here QINIU_BUCKET=your_bucket_name_here QINIU_DOMAIN=http://your_domain.com

请根据实际情况替换为自己的七牛云账号信息。

三、创建配置文件

接下来，在config目录下创建一个名为qiniu.php的配置文件。该文件用于定义七牛云的相关设置：

php
<?php</p>

<p>return [
    'access<em>key' => env('QINIU</em>ACCESS<em>KEY'),
    'secret</em>key' => env('QINIU<em>SECRET</em>KEY'),
    'bucket'     => env('QINIU<em>BUCKET'),
    'domain'     => env('QINIU</em>DOMAIN')
];

这样可以方便地在代码中获取这些参数。

四、编写上传逻辑

我们可以在app/Services目录下创建一个名为QiNiuService.php的服务类来封装上传逻辑：

php
<?php</p>

<p>namespace AppServices;</p>

<p>use QiniuAuth;
use QiniuStorageUploadManager;</p>

<p>class QiNiuService
{
    protected $auth;
    protected $bucket;
    protected $domain;</p>

<pre><code>public function __construct()
{
    $this->auth = new Auth(config('qiniu.access_key'), config('qiniu.secret_key'));
    $this->bucket = config('qiniu.bucket');
    $this->domain = config('qiniu.domain');
}

/**
 * @param string $localFilePath 本地文件路径
 * @param string $key 文件名
 * @return array
 */
public function uploadFile(string $localFilePath, string $key): array
{
    // 生成上传 Token
    $token = $this->auth->uploadToken($this->bucket);

    // 初始化 UploadManager 对象并进行文件的上传
    $uploadMgr = new UploadManager();
    list($ret, $err) = $uploadMgr->putFile($token, $key, $localFilePath);

    if ($err !== null) {
        return ['error' => $err];
    } else {
        return ['url' => $this->domain . '/' . $ret['key']];
    }
}

}

五、另一种思路：使用 Flysystem 扩展包

除了直接使用官方SDK外，还可以考虑使用Laravel社区提供的Flysystem扩展包来简化操作。它提供了统一的接口，支持多种云存储服务，包括七牛云。

安装flysystem-qiniu驱动：

bash composer require overtrue/flysystem-qiniu

然后修改config/filesystems.php文件，添加七牛云配置：

php 'qiniu' => [ 'driver' => 'qiniu', 'domains' => [ 'default' => env('QINIU_DOMAIN'), 'https' => str_replace('http://', 'https://', env('QINIU_DOMAIN')), ], 'access_key' => env('QINIU_ACCESS_KEY'), 'secret_key' => env('QINIU_SECRET_KEY'), 'bucket' => env('QINIU_BUCKET'), 'notify_url' => '', // 可选 'callback_url' => '', // 可选 ],

现在你就可以像操作本地文件一样轻松地与七牛云交互了。例如：

php Storage::disk('qiniu')->put('example.txt', 'Hello World!');

以上就是关于Laravel项目中集成七牛云存储的全部内容。希望对你有所帮助！