七牛云 Laravel 存储扩展教程

七牛云 Laravel 存储扩展教程

qiniu-laravel-storage项目地址:https://gitcode.com/gh_mirrors/qi/qiniu-laravel-storage

项目介绍

qiniu-laravel-storage 是一个为 Laravel 框架设计的扩展包，用于简化与七牛云存储服务的集成。通过这个扩展包，开发者可以轻松地在 Laravel 应用中上传、管理和访问存储在七牛云上的文件。

项目快速启动

安装

首先，通过 Composer 安装 qiniu-laravel-storage 扩展包：

composer require zgldh/qiniu-laravel-storage

配置

在 Laravel 项目的 config/app.php 文件中，添加服务提供者：

'providers' => [
    // 其他服务提供者...
    zgldh\QiniuStorage\QiniuFilesystemServiceProvider::class,
],

然后，发布配置文件：

php artisan vendor:publish --provider="zgldh\QiniuStorage\QiniuFilesystemServiceProvider"

在 config/filesystems.php 文件中，添加七牛云配置：

'qiniu' => [
    'driver'  => 'qiniu',
    'domains' => [
        'default'   => 'your-domain.com', // 你的七牛域名
        'https'     => 'your-https-domain.com', // 你的七牛 HTTPS 域名
        'custom'    => 'your-custom-domain.com', // 你的自定义域名
    ],
    'access_key' => 'your-access-key', // 你的 Access Key
    'secret_key' => 'your-secret-key', // 你的 Secret Key
    'bucket'     => 'your-bucket', // 你的存储空间名称
    'notify_url' => 'your-notify-url', // 你的回调地址
    'access'     => 'public', // 存储类型: public 或 private
],

使用示例

以下是一个简单的上传文件示例：

use Illuminate\Support\Facades\Storage;

// 上传文件
Storage::disk('qiniu')->put('path/to/file.jpg', file_get_contents('local/path/to/file.jpg'));

// 获取文件 URL
$url = Storage::disk('qiniu')->url('path/to/file.jpg');
echo $url;

应用案例和最佳实践

应用案例

• 图片存储与处理：使用七牛云存储扩展包，可以轻松地将用户上传的图片存储到七牛云，并利用七牛云的图片处理功能进行格式转换、缩放、裁剪等操作。
• 静态资源托管：将网站的静态资源（如 CSS、JS、图片等）存储在七牛云上，可以有效减轻服务器压力，提高访问速度。

最佳实践

• 配置缓存：在生产环境中，建议将七牛云的配置信息缓存起来，以提高性能。
• 错误处理：在上传和下载文件时，应添加适当的错误处理逻辑，以应对网络问题或权限问题。
• 使用 CDN：结合七牛云的 CDN 服务，可以进一步提高静态资源的访问速度和稳定性。

典型生态项目

• Laravel：本扩展包是为 Laravel 框架设计的，因此与 Laravel 生态系统紧密集成。
• 七牛云：七牛云提供了一系列的云存储和 CDN 服务，与本扩展包配合使用，可以构建高效、稳定的云存储解决方案。
• Composer：依赖管理工具，用于安装和管理本扩展包及其依赖。

通过以上步骤和示例，您可以快速上手并使用 qiniu-laravel-storage 扩展包，实现与七牛云存储服务的集成。

qiniu-laravel-storage项目地址:https://gitcode.com/gh_mirrors/qi/qiniu-laravel-storage