README

Composer 资产插件允许您在不安装 NPM 或 Bower 的情况下，通过 composer.json 管理项目资产（css、js 等）。

此插件通过将包信息从 NPM 或 Bower 转换为与 Composer 兼容的版本来工作。这使得您能够非常容易地在基于 PHP 的项目中管理资产依赖项。

功能包括

与 composer 的 VCS 仓库的本地管理系统版本兼容
与公共和私有 VCS 仓库兼容
资产包定义的懒加载以提升性能
带有根包及其已安装包的依赖关系的导入过滤器，显著提高更新性能
自动获取和创建在
- NPM 注册表
- Bower 注册表
自动获取和创建每个资产包中定义的依赖项的资产 VCS 仓库（包括开发依赖项）
将资产包映射到 composer 包，用于
- NPM 包 - package.json
- Bower 包 - bower.json
将 Semver 版本转换为 composer 版本
将 Semver 范围版本转换为 composer 范围版本
将带有 URL 的依赖项转换为通过创建 VCS 仓库的 composer 依赖项
将同一依赖项的多个版本转换为 composer 的不同依赖项
手动添加项目中的同一依赖项的多个版本
添加 VCS 仓库的自定义配置
在根 composer 的额外部分中直接覆盖由资产注册表定义的 VCS 仓库的配置
VCS 驱动器包括
- Git
- GitHub（兼容仓库重定向）
- Git Bitbucket
- Mercurial
- Mercurial Bitbucket
- SVN
- Perforce
本地缓存系统用于
- 包版本
- 包内容
- 仓库重定向
在根文件 composer.json 中可配置的自定义资产安装程序
对于Bower，所有在ignore部分定义的文件将不会安装
禁用或替换Bower忽略文件的删除
手动启用NPM忽略文件的删除
在Composer脚本中使用忽略文件管理器
与所有命令兼容，包括
- depends
- diagnose
- licenses
- remove
- require
- search（仅限Bower）
- show
- status

为什么需要这个插件？

PHP项目中管理资源的可能性已经有很多了

安装Node.js并使用NPM或Bower命令行，除了Composer命令行
执行#1，但添加Composer脚本来自动化这个过程
直接在项目中包含资源（不建议）
创建包含所有资源的仓库并包含composer.json文件（并使用Packagist或VCS仓库）
在composer.json中添加包仓库，并提供直接下载链接
创建Satis或Packagist服务器
其他？

不言而喻，每个JavaScript、CSS等库都应该使用该语言常用的工具进行开发，前端开发者对此都很熟悉。然而，在PHP完整项目中，不需要使用多个工具（PHP、Nodejs、Composer、NPM、Bower、Grunt等）来简单地安装这些资源到项目中。

本插件正是为了解决这些问题而创建的。另外，大多数开发者不会仅仅为了支持基于PHP的项目而将composer.json文件添加到项目中，尤其是当npm和/或Bower已经存在并被广泛使用时。

文档

大部分文档位于Resources/doc/index.md

阅读文档

阅读常见问题解答

阅读发布说明

安装

原始的fxp/composer-asset-plugin包将被替换为bisubus/composer-asset-plugin（版本约束应设置为最新，例如dev-master）。您仍然可以在全局范围内安装fxp/composer-asset-plugin，但在项目中用这个包替换它。

查看发布说明以了解所需的Composer版本。

全局范围（每个用户）安装

$ composer global require "bisubus/composer-asset-plugin:dev-master"

项目范围安装

$ composer require "bisubus/composer-asset-plugin:dev-master"

使用

使用--ansi或--no-ansi Composer选项触发关闭开关（根据需要添加），因为目前Composer插件无法添加自定义CLI选项。

当显式将bower-asset或npm-asset包提交到命令行时，它会自动禁用。

许可协议

此Composer插件受MIT许可协议保护。请参阅完整的许可协议，

在Resources/meta/LICENSE

关于

Fxp Composer Asset Plugin是由François Pluchino发起的。还可以查看贡献者列表。

报告问题或功能请求

问题和功能请求在GitHub问题跟踪器中记录。

bisubus / composer-asset-plugin

维护者

详细信息