reputation-vip / composer-assets-installer
v2.0.0
2017-04-03 09:13 UTC
Requires
- composer-plugin-api: ~1.0
- symfony/filesystem: ^3.0
Requires (Dev)
- composer/composer: ^1.4
- phpunit/phpunit: ~4.4
This package is not auto-updated.
Last update: 2024-09-14 16:43:50 UTC
README
Composer Assets Installer 提供了一种快速且简单的方法,可以将你的 Composer 包的资源复制到公共文件夹中。你只需要在 "composer.json" 文件中选择目标的一个或多个资源目录。
代码示例
以下是我们项目中想要使用的远程 Composer 包的 composer.json 文件
{
"require": {
"reputation-vip/composer-assets-installer": "~1.0"
},
"name": "reputation-vip/required-distant-package",
"extra": {
"assets-dir" : "public"
}
}
以下是我们项目的 composer.json 文件
{
"require": {
"reputation-vip/composer-assets-installer": "~1.0",
"my/required-distant-package": "~1.0"
},
"extra": {
"assets-dir" : "web"
}
}
然后,资源将通过以下路径访问:web/my/required-distant-package。
动机
作为 Reputation VIP 开发团队的一员,我们习惯于创建完整的 Composer 包,嵌入 JavaScript 逻辑和 CSS 层。
当我们刚开始使用 Composer 时,由于它缺乏资源处理功能而感到有些沮丧。事实上,Composer 强迫我们手动将资源复制到公共目录。此外,每次我们更新包时,我们都需要重复这个任务。
这就是为什么我们需要一个 经过测试、文档齐全且易于配置 的 Composer 插件,这样我们就可以 保持对资源目录的控制。
安装
你只需将以下行添加到 composer.json 文件的依赖项中
"require": {
"reputation-vip/composer-assets-installer": "~1.0"
}
然后,你可以指定资源目录的目标(例如 web)
"extra": {
"assets-dir": "web"
}
API 参考
使用此解决方案,你可以指定任意多的目标
"extra": {
"assets-dir": {
"js": "web/js",
"css": "web/css"
}
}