储存策略 | Lsky Pro

提示

兰空图床中的储存策略是整个系统的核心部分之一，目前支持本地、AWS S3、阿里云 OSS、腾讯云 COS、七牛云、又拍云、SFTP、FTP、WebDav、Minio。一个储存策略可以归属于多个角色组，同时某个角色组也可以设置多个储存策略。

如何设置归属角色组？

在创建、编辑储存策略时，第一栏的角色组输入框会展示全部已存在的角色组，鼠标单击可直接选择，mac 按住 command 加鼠标左键可以多选、取消选择，windows 上为 ctrl 或 alt 键。

如何自定义一个储存？

警告

首先你需要有一定的 PHP 的编程基础，并对 Laravel 有一定的了解。
兰空图床的储存是由 flysystemopen in new window 实现，flysystem 提供了一个接口来与不同类型的文件系统进行交互(增删改查等)，你只需要按照 flysystem 提供的接口实现你的储存即可。此教程不会详细的指导你如何实现该接口。这里有一份兰空图床实现的又拍云适配器 https://github.com/wisp-x/flysystem-upyunopen in new window 供你参考。

储存驱动适配好以后，接下来要做的就是集成到兰空图床当中。

你需要使用 composer 安装你的驱动器。现在我们假设你的驱动器名称为 flysystem-custom。

composer install xxx/flysystem-custom

增加一个枚举类

在 app/Enums/Strategy 文件夹中新增一个文件 CustomOption，内容如下

<?php

namespace App\Enums\Strategy;

final class CustomOption
{
    /** @var string 访问地址 */
    const Url = 'url';

    /** @var string 用户名 */
    const Username = 'username';

    /** @var string 密码 */
    const Password = 'password';

    /** @var string 储存名称 */
    const Bucket = 'bucket';
}

该枚举由你的储存需要的配置而定，其中 url 不管是什么储存都是必须的

增加一个枚举常量

打开 app/Enums/StrategyKey.php 文件追加一行

// ...
/** @var int Custom */
const Custom = 11;
// ...

此常量值可以自定义，但不要和其他常量值重复。

更改图片服务类中的 getAdapter 方法

打开 app/Services/ImageService.php 文件定位到 getAdapter 方法，你可以看到所有储存策略都是通过这个方法进行实例化的。我们来增加一个 adapter，在 match 表达式中追加内容：


// ...

use App\Enums\Strategy\CustomOption;

// ....

StrategyKey::Custom => new CustomAdapter(
    username: $configs->get(CustomOption::Username),
    password: $configs->get(CustomOption::Password),
    bucket: $configs->get(CustomOption::Bucket),
),

// ...

给模型中的驱动常量加上自定义储存

打开 app/Models/Strategy.php 文件，在 DRIVERS 常量中追加一行

// ...
const DRIVERS = [
    // ...
    StrategyKey::Custom => '自定义储存',
];
// ...

修改表单验证器

打开 app/Http/Requests/Admin/StrategyRequest.php 文件，在 rules 方法里追加验证内容


// ...

return array_merge($array, match((int)$this->input('key')) {
    // ...
    StrategyKey::Custom => [
        'configs.username' => 'required',
        'configs.password' => 'required',
        'configs.bucket' => 'required',
    ],
});

// ...

验证规则请参考 Laravel 官方文档

增加 web 设置表单页面

打开 resources/views/admin/strategy/add.blade.php 和 resources/views/admin/strategy/edit.blade.php
参考其他的储存策略表单，例如 minio：
添加页面：add.blade.phpopen in new window
编辑页面：edit.blade.phpopen in new window

至此，一个新的储存就适配完成了，这时候就可以在储存策略添加表单中，选择你的自定义储存策略进行配置、测试上传、管理等。

FAQ

储存的特殊说明

本地储存

为了实现本地储存可以更改储存位置，所以本地储存必须有一个域名后缀，例如 http://domain.com/uploads/123.png 中的 uploads。后缀对应的是 public 目录下的符号连接。

阿里云 OSS

如果使用 RAM 账户，请授予该账户以下权限：

AliyunOSSFullAccess
AliyunOSSReadOnlyAccess

腾讯云 COS

如果使用子账户，请授予该账户以下权限
- QcloudCOSDataFullControl
- QcloudCOSDataReadOnly
- QcloudCOSDataWriteOnly
- QcloudCOSFullAccess
- QcloudCOSListOnly
- QcloudCOSMetaAccMgmt
- QcloudCOSReadOnlyAccess
- QcloudAccessForCSGRole
- QcloudAccessForDsgcRole
- QcloudAccessForTCRRole
- QcloudAccessForTCSRole
腾讯云的储存桶名称由名称+appid 组合，在兰空图床后台的储存策略表单中请分开填写。

Minio

如果使用内网 ip 进行连接，region 可以为空，如果是外网，sdk 则会验证区域，没有设置区域则可以固定为 us-east-1

# 如何设置归属角色组？

# 如何自定义一个储存？

# FAQ

# 储存的特殊说明

# 本地储存

# 阿里云 OSS

# 腾讯云 COS

# Minio