Composer Asset Plugin 允许您在composer.json
中管理项目资源(css、js 等),而无需安装 NPM 或 Bower。
该插件的工作原理是将包信息从 NPM 或 Bower 转换为 Composer 的兼容版本。这使您可以非常轻松地管理基于 PHP 的项目中的资产依赖关系。
重要的:
Composer Asset Plugin 的下一个主要版本与当前版本非常不同,但也与当前版本不兼容,因此它成为一个名为 Foxy 的新项目。
Foxy 是管理 PHP 库资产的新方法,因为它本身可以与 NPM 或 Yarn 的所有功能配合使用。不过,这个插件将继续由社区维护,不会有新功能。
您可以阅读这个新版本的原因,或者 Foxy 和 Fxp Composer Asset Plugin 之间的区别,以及 Foxy 的工作原理。
适用于 Composer VCS 存储库的本机管理系统版本
可与公共和私有 VCS 存储库配合使用
资产包定义的惰性加载器以提高性能
导入包含根包和已安装包的依赖项的过滤器,以显着提高更新性能
自动获取并创建在以下位置定义的资产 VCS 存储库:
NPM 注册表
鲍尔登记处
私人凉亭登记处
自动获取并创建每个资产包中定义的依赖项的 Asset VCS 存储库(包括开发依赖项)
将资源包映射到作曲家包:
NPM 包 - package.json
Bower 包 - Bower.json
Semver 版本转换为 Composer 版本
Semver 系列版本到 Composer 系列版本的转换
通过创建 VCS 存储库将带有 URL 的依赖项转换为 Composer 依赖项
将同一依赖的多个版本转换为composer的不同依赖
在项目中手动添加同一依赖项的多个版本
添加 VCS 存储库的自定义配置
直接在根 Composer 的配置部分覆盖资产注册表定义的 VCS 存储库的配置
VCS 驱动程序用于:
git
GitHub(与存储库重定向兼容)
Git 比特桶
水银
Mercurial Bitbucket
SVN
佩福斯
本地缓存系统:
软件包版本
包装内容
存储库重定向
根文件composer.json
中可配置的自定义资产安装程序
对于 Bower, ignore
部分中定义的所有文件都不会被安装
禁用或替换 Bower 忽略文件的删除
启用手动删除 NPM 的忽略文件
在 Composer 脚本中使用忽略文件管理器
全局或使用环境变量配置每个项目的插件
兼容所有命令,包括:
depends
diagnose
licenses
remove
require
search
(仅限凉亭)
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
中:
阅读文档
阅读常见问题解答
阅读发行说明
所有安装说明均位于文档中。
该作曲家插件已获得 MIT 许可。请参阅以下位置的完整许可证:
执照
Fxp Composer Asset Plugin 是 François Pluchino 的一项举措。另请参阅贡献者列表。
问题和功能请求在 Github 问题跟踪器中进行跟踪。