trikoder / assets-manifest-bundle
此包最新版本(v1.0.1)没有可用的许可证信息。
Symfony 扩展包,用于生成我们新的前端静态资产构建工具的资产 URL
v1.0.1
2018-11-27 11:33 UTC
Requires
- php: >=5.6.0
- symfony/config: >=2.7 <=5.0
- symfony/dependency-injection: >=2.7 <=5.0
- symfony/http-foundation: >=2.7 <=5.0
- symfony/http-kernel: >=2.7 <=5.0
- twig/twig: ~1.14|~2.0
Requires (Dev)
- phpunit/phpunit: ^6.0
This package is auto-updated.
Last update: 2024-08-28 05:28:14 UTC
README
此扩展包提供用于生成静态公共资产 URL 的 Twig 辅助函数。
它从简单的 JSON 配置文件中读取信息。示例文件在 manifest.json 中。
用法
扩展包提供两个 Twig 函数 - manifestAsset 和 manifestAssetInline。
manifestAsset 需要 2 个参数
- 资产 URL,格式为 @BundleName:path/to/asset 或命名空间路径 @BundleName/path/to/asset
- 可选的选项数组
- 目前只有选项: "absolute" => 如果为 true,函数返回绝对 URI
示例用法
<link href="{{ manifestAsset('@AppBundle:css/bundles/home.css') }}" rel="stylesheet" type="text/css"> <script async src="{{ manifestAsset('@AppBundle:js/home.js') }}"></script>
manifestAssetInline 需要 1 个参数
- 资产 URL,格式为 @BundleName:path/to/asset 或命名空间路径 @BundleName/path/to/asset
它返回资产的内容。
示例用法
<style>{{ manifestAssetInline('@AppBundle:css/bundles/home.css') }}</style>
使用自定义 Twig 命名空间
首先,您需要注册您的 Twig 命名空间
twig: paths: '%kernel.project_dir%/src/App/Resources': SomeTwigNamepace
然后,您可以使用
<style>{{ manifestAsset('@SomeTwigNamepace/css/home.css') }}</style> <style>{{ manifestAssetInline('@SomeTwigNamepace/js/home.js') }}</style>
注意:Twig 命名空间引用不包含分隔符 :
,如扩展包。有关更多详细信息,请参阅 此链接。
运行测试和代码检查器
为了运行测试和代码检查器,有一个包含 php 和所有必需工具的完整 Docker 环境。要设置环境,请使用
bin/dev/docker-compose build
bin/dev/composer install
运行测试(在构建环境之后)
bin/dev/composer test
运行代码检查器
bin/dev/phpcsfixer fix --dry-run .
要自动修复编码标准,只需省略 --dry-run
参数。
致谢
版权 (C) 2017 Trikoder
作者:Alen Pokos, Damir Brekalo, Krešo Kunjas。
贡献者:Branimir Đurek
许可证
此包根据 MIT 许可证 许可。