heavenproject/asset-loader

公共资产文件加载器

v1.0.1 2016-09-05 09:45 UTC

This package is not auto-updated.

Last update: 2024-09-15 00:54:29 UTC


README

公共资产文件加载器。

安装

composer require heavenproject/asset-loader

工作原理

资产加载器是 Latte 宏

在资产文件被资产加载器加载后,它读取资产 URL,将此信息保存到临时文件中,并在 URL 后面追加一个版本号,例如 http://example.com/images/image.jpg?v=1。当资产文件被修改后,资产加载器会在新的请求期间注册此信息,并在 URL 查询字符串中增加版本号,例如 http://example.com/images/image.jpg?v=2。这将迫使网络浏览器从服务器下载该资产文件的新版本,而不是从浏览器缓存中使用它。

注意:资产文件可以通过指定其从网站文档根目录的绝对文件路径来加载,例如 /images/image.jpg,或者通过使用其外部 URL 来加载,例如 http://example.com/images/image.jpg,但如果使用后一种形式(外部 URL),请注意,尝试处理来自不同域的资产将不起作用,因为在这种情况下资产加载器会检查 URL 中的域,如果它与网站 URL 不匹配,它将只返回给它的原始 URL,这样浏览器就可以像平常一样处理给定的资源。因此,请只加载您的网站本地资产。

要求

文档

为了使用资产加载器,您必须在配置文件中将它注册为扩展

extensions:
    asset: HeavenProject\AssetLoader\AssetLoaderExtension

然后您必须配置它

asset:
    publicDir: %wwwDir%
    targetDir: %tempDir%/assets

之后,您就可以开始使用资产加载器了

<img src="{asset $basePath . '/images/image.jpg'}" alt="Image">

许可证

此源代码是可在 免费软件 下使用的,受 MIT 许可证 保护。