ulthon/ulthon_admin
1
0
Fork 0
mirror of https://gitee.com/ulthon/ulthon_admin.git synced 2026-08-30 12:45:32 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat(storage): v2.5.0存量升级脚本补齐存储配置

Browse Source
This commit is contained in:
augushong
2026-08-20 22:21:25 +08:00
parent 15cda70d0a
commit aba0d20615
1 changed files with 235 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

235
extend/base/admin/service/adminUpdateCodeData/v2.5.0.php Normal file
View File

@@ -0,0 +1,235 @@
<?php
/**
* @internal-framework
*
* 此文件为框架内置功能
*
* 用途：框架版本更新代码（v2.5.0）- S3 / WebDAV 存储支持存量升级
* 维护者：框架维护者
*
* 变更：
* - system_config 新增 upload 组 12 条存储配置（与 adminInitData/SystemConfig.php 种子一致）
* s3_access_key / s3_secret_key / s3_region / s3_bucket / s3_endpoint /
* s3_path_style / s3_domain
* webdav_url / webdav_username / webdav_password / webdav_prefix / webdav_domain
* - system_config.upload_allow_type 追加合并 s3、webdav（保留用户自定义值与原顺序）
* - 清理 sysconfig 缓存（tag=sysconfig，TTL 3600s，脚本直改 DB 不清则
* in: 校验 1 小时内拒绝新上传方式）
*
* 设计说明：
* - 幂等 check-then-insert：新配置用 (group, name) 检查存在性
* - upload_allow_type 为追加合并而非整体覆盖：仅在缺失时 append，已有自定义值不动
* - 表前缀取默认连接配置（database.default 指向的连接），不写死 mysql 连接——
* 本项目默认连接是 main，自定义前缀项目上 connections.mysql.prefix 会取错前缀
*
* 注意：此文件属于框架内核，业务开发者不应修改
*/
use think\console\Input;
use think\console\Output;
use think\facade\Cache;
use think\facade\Db;
class UpdateFunction
{
/**
* @var Input
*/
public $input;
/**
* @var Output
*/
public $output;
/**
* 待新增 sysconfig 配置（upload 组，S3 / WebDAV 存储）.
* 字段顺序与 adminInitData/SystemConfig.php 一致：name/group/value/remark/sort.
*/
public $newConfigs = [
[
'name' => 's3_access_key',
'group' => 'upload',
'value' => '填你的',
'remark' => 'S3公钥',
'sort' => 0,
],
[
'name' => 's3_secret_key',
'group' => 'upload',
'value' => '填你的',
'remark' => 'S3私钥',
'sort' => 0,
],
[
'name' => 's3_region',
'group' => 'upload',
'value' => '填你的',
'remark' => 'S3地域',
'sort' => 0,
],
[
'name' => 's3_bucket',
'group' => 'upload',
'value' => '填你的',
'remark' => 'S3空间名称',
'sort' => 0,
],
[
'name' => 's3_endpoint',
'group' => 'upload',
'value' => '',
'remark' => 'S3自定义端点(兼容MinIO等,留空用AWS官方)',
'sort' => 0,
],
[
'name' => 's3_path_style',
'group' => 'upload',
'value' => '0',
'remark' => 'S3路径风格(1开启,MinIO建议)',
'sort' => 0,
],
[
'name' => 's3_domain',
'group' => 'upload',
'value' => '填你的',
'remark' => 'S3访问域名',
'sort' => 0,
],
[
'name' => 'webdav_url',
'group' => 'upload',
'value' => '填你的',
'remark' => 'WebDAV服务地址',
'sort' => 0,
],
[
'name' => 'webdav_username',
'group' => 'upload',
'value' => '填你的',
'remark' => 'WebDAV账户',
'sort' => 0,
],
[
'name' => 'webdav_password',
'group' => 'upload',
'value' => '填你的',
'remark' => 'WebDAV密码',
'sort' => 0,
],
[
'name' => 'webdav_prefix',
'group' => 'upload',
'value' => '',
'remark' => 'WebDAV存储前缀',
'sort' => 0,
],
[
'name' => 'webdav_domain',
'group' => 'upload',
'value' => '填你的',
'remark' => 'WebDAV访问域名',
'sort' => 0,
],
];
/**
* upload_allow_type 待追加的上传方式（追加合并，不覆盖已有值）.
*/
public $allowTypeAppend = ['s3', 'webdav'];
public function update()
{
$this->output->writeln('更新代码');
$this->output->info('v2.5.0：S3 / WebDAV 存储支持存量升级（补齐 12 条 sysconfig + upload_allow_type 追加 s3、webdav）');
// 表前缀从默认连接取（database.default 指向的连接），不能写死 connections.mysql
$prefix = config('database.connections.' . config('database.default') . '.prefix', 'ul_');
$configTable = $prefix . 'system_config';
// 确认表存在（防御性检查）
$tablesExist = Db::query(
'SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ?',
[$configTable]
);
if (empty($tablesExist)) {
$this->output->warning("表 {$configTable} 不存在，跳过数据补齐。请先执行 scheme:sync 或 migrate:run 初始化表结构。");
return;
}
// ==================== 新配置幂等补齐（check-then-insert）====================
$configAdded = 0;
$configSkipped = 0;
foreach ($this->newConfigs as $cfg) {
// 幂等：用 (group, name) 检查存在性
$exists = Db::name('system_config')
->where('group', $cfg['group'])
->where('name', $cfg['name'])
->find();
if ($exists) {
$this->output->writeln(" - 配置 {$cfg['group']}.{$cfg['name']} 已存在，跳过");
++$configSkipped;
continue;
}
Db::name('system_config')->insert($cfg);
$this->output->writeln(" - 新增配置 {$cfg['group']}.{$cfg['name']} 完成");
++$configAdded;
}
// ==================== upload_allow_type 追加合并（不覆盖用户自定义值）====================
$typesAppended = [];
$allowRow = Db::name('system_config')
->where('group', 'upload')
->where('name', 'upload_allow_type')
->find();
if (!$allowRow) {
// 不存在则插入完整默认值（与种子 adminInitData/SystemConfig.php 一致）
Db::name('system_config')->insert([
'name' => 'upload_allow_type',
'group' => 'upload',
'value' => 'local_public,alioss,qnoss,txcos,s3,webdav',
'remark' => '可用的上传文件方式',
'sort' => 0,
]);
$this->output->writeln(' - 新增配置 upload.upload_allow_type 完成（默认全集）');
++$configAdded;
} else {
// 追加合并：过滤空串项后逐个 append，保持原顺序与用户自定义值不动
$types = array_values(array_filter(explode(',', (string) $allowRow['value']), function ($item) {
return $item !== '';
}));
foreach ($this->allowTypeAppend as $type) {
if (!in_array($type, $types, true)) {
$types[] = $type;
$typesAppended[] = $type;
}
}
if (!empty($typesAppended)) {
Db::name('system_config')
->where('id', $allowRow['id'])
->update(['value' => implode(',', $types)]);
$this->output->writeln(' - 配置 upload.upload_allow_type 追加 ' . implode(',', $typesAppended) . ' 完成：' . implode(',', $types));
} else {
$this->output->writeln(' - 配置 upload.upload_allow_type 已含 ' . implode(',', $this->allowTypeAppend) . '，跳过');
}
}
// ==================== 清理 sysconfig 缓存 ====================
// 脚本直改 DB 绕过了 sysconfig() 的缓存失效逻辑（tag=sysconfig，TTL 3600s），
// 不清理则表单 in: 校验在缓存过期前会拒绝新上传方式
Cache::tag('sysconfig')->clear();
$this->output->writeln(' - 已清理 sysconfig 缓存（tag=sysconfig）');
$summary = "本次新增 {$configAdded} 条配置";
if (!empty($typesAppended)) {
$summary .= '，upload_allow_type 追加 ' . implode(',', $typesAppended);
}
$summary .= "，跳过 {$configSkipped} 条已存在";
$this->output->info($summary);
$this->output->writeln('更新代码完成');
}
}