Skip to content

feat: 支持通过配置独立控制 JS/CSS 资源缓存版本号#27

Merged
PrintNow merged 1 commit into
2.0from
feat/assets-version
May 26, 2026
Merged

feat: 支持通过配置独立控制 JS/CSS 资源缓存版本号#27
PrintNow merged 1 commit into
2.0from
feat/assets-version

Conversation

@PrintNow
Copy link
Copy Markdown
Owner

背景

原有实现中,JS/CSS URL 的缓存破坏版本参数(?v2.3.10-beta)强制使用框架版本号(Admin::VERSION),用户无法单独控制,导致升级框架时才能让浏览器重新加载资源,反之亦然。

相关上游 issue:jqhph/dcat-admin#2177

改动

  • src/Layout/Asset.phpwithVersionQuery() 优先读取 config('admin.assets_version'),为空时 fallback 到 Admin::VERSION;值为空字符串/null 时不附加任何版本查询参数
  • config/admin.php — 新增 assets_version 配置项,支持 ADMIN_ASSETS_VERSION 环境变量
  • src/Console/stubs/config.stub — 同步更新 stub,新安装项目自动带上该配置
  • README.md — 在新增功能列表中注明此特性

使用方式

.env 中设置:

ADMIN_ASSETS_VERSION=1.0.0

或在 config/admin.php 中直接写值。留空(默认)则沿用框架版本号;显式设为空字符串则不添加任何版本查询参数。

新增 `admin.assets_version` 配置项(对应 `ADMIN_ASSETS_VERSION` 环境变量),
允许用户自定义附加在 JS/CSS URL 上的缓存破坏版本参数,不再强制跟随框架版本。
设为空值时不添加任何版本查询参数。
@PrintNow PrintNow merged commit d938ff3 into 2.0 May 26, 2026
5 checks passed
@PrintNow PrintNow deleted the feat/assets-version branch May 26, 2026 14:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant