reputation-vip/composer-assets-installer

v2.0.0 2017-04-03 09:13 UTC

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"
     }
}