xini/silverstripe-prefix-requirements

此包已被废弃且不再维护。作者建议使用innoweb/silverstripe-prefix-requirements包代替。

为所有需求添加文件哈希前缀。替换默认的?{mtime}后缀，使需求完全可缓存。

维护者

详细信息

github.com/xini/silverstripe-prefix-requirements

主页

源代码

问题

安装: 144

依赖: 0

建议者: 0

安全: 0

星标: 2

关注者: 4

分支: 1

开放问题: 0

类型:silverstripe-vendormodule

3.0.2 2023-03-19 13:08 UTC

Requires

Replaces

BSD-3-Clause e6b447f8548d2f44ae8302730e9ec219c625de46

cachingsilverstriperequirementsprefix

This package is auto-updated.

Last update: 2023-12-08 05:35:02 UTC

README

概述

为所有需求添加文件哈希前缀。替换默认的?{mtime}后缀，使需求完全可缓存。

每当CSS或JavaScript文件更改时，都会生成一个带有前缀的新文件版本。这使得文件完全可缓存，因为每次更改都会在HTML中包含一个带有新URL的文件。

建议使用Grunt或Gulp（或其他您可能想要使用的任何技术）压缩CSS文件。

需求

  • SilverStripe CMS 5.x

注意：此版本与SilverStripe 5兼容。对于SilverStripe 4，请参阅2.x版本分支。对于SilverStripe 3，请参阅1.x版本分支。

安装

  1. composer require innoweb/silverstripe-prefix-requirements
  2. 运行dev/build

使用

带有前缀的文件生成并存储在Requirements_Backend类的默认CombinedFilesFolder中。您可以在config.yml中使用以下条目来指定生成的文件存储位置

SilverStripe\View\Requirements_Backend:
  default_combined_files_folder: '_your_folder'

默认为ASSETS_DIR . '/_combinedfiles'。

此模块不处理CMS中的CSS和JavaScript。

由于文件被移动到配置的CombinedFilesFolder，请确保您在CSS和JavaScript文件中的包含只使用相对于网站根的路径。例如：/_resources/themes/yourtheme/images/icon.png，而不是../images/icon.png。

您可以使用配置排除某些需求不被重写

Innoweb\PrefixRequirements\Control\PrefixResourceURLGenerator:
  excluded_resources:
    - 'vendor/lekoala/silverstripe-debugbar/**/*'
    - 'vendor/jonom/silverstripe-betternavigator/**/*'

您还可以更改用于哈希的格式，并将其更改为后缀而不是前缀

Innoweb\PrefixRequirements\Control\PrefixResourceURLGenerator:
  nonce_style: [mtime|sha1|md5]
  use_postfix: true

许可

BSD 3-Clause License，请参阅许可