heavenproject / asset-loader
公共资产文件加载器
v1.0.1
2016-09-05 09:45 UTC
Requires
- heavenproject/utils: ^1.0
- latte/latte: ^2.3
- nette/di: ^2.3
Requires (Dev)
- kdyby/tester-extras: dev-master
- mockery/mockery: ~0.9.0
- nette/application: ^2.3
- nette/bootstrap: ^2.3
- nette/tester: *
- php-mock/php-mock-mockery: ~1.1.0
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">