README

用于安装资产的Composer插件。

安装

使用 Composer

composer require frontpack/composer-assets-plugin

库需要PHP 5.6.0或更高版本。

命令

• composer refresh-assets - 刷新assets目录中的文件

资产配置

包

• assets-files在extra部分
  • true - 链接整个包目录
  • 文件路径 - 链接一个文件或目录内容
  • 文件路径列表 - 链接文件/目录

示例

{
	"extra": {
		"assets-files": [
			"static/plugin.js",
			"static/plugin.css",
			"static/icons.png"
		]
	}
}

• static/plugin.js - 链接到assets/org/package/plugin.js
• static/plugin.css - 链接到assets/org/package/plugin.css
• static/icons.png - 链接到assets/org/package/icons.png

或者你可以使用简单的

{
	"extra": {
		"assets-files": "static"
	}
}

得到相同的结果。

根包

• assets-dir - 安装资产的目录，默认为assets，相对于vendor-dir
• assets-directory - assets-dir的别名
• assets-files - 不兼容包中的资产文件列表，它覆盖已安装包中的assets-files
• assets-strategy - 资产的安装策略
  • auto - 根据平台选择策略（默认值）
  • copy - 复制所有资产，Windows上的默认策略
  • symlink - 创建相对符号链接，非Windows平台上的默认策略
• assets-target - 特定包的目标目录，相对于vendor-dir，必须在assets-dir之外

示例

{
	"extra": {
		"assets-dir": "public",
		"assets-files": {
			"org/package": true,
			"org/package2": "js/calendar.js",
			"org/package3": [
				"static/plugin.js",
				"static/plugin.css",
				"static/icons.png"
			]
		},
		"assets-target": {
			"ckeditor/ckeditor": "admin/wysiwyg"
		}
	}
}

• org/package - 将整个包目录链接到public/org/package
• org/package2 - 将文件js/calendar.js链接到public/org/package2/calendar.js
• org/package3
  • static/plugin.js - 链接到public/org/package3/plugin.js
  • static/plugin.css - 链接到public/org/package3/plugin.css
  • static/icons.png - 链接到public/org/package3/icons.png
• ckeditor/ckeditor - 链接到admin/wysiwyg

默认映射

插件为选定的不兼容包提供默认映射。您可以在您的composer.json中覆盖此映射。

具有默认映射的包列表

• bower-asset/tiny-slider
• ckeditor/ckeditor
• components/jquery
• enyo/dropzone
• nette/forms
• o5/grido

在哪里找到支持的包？

一些库和包默认支持Composer。对于其他存在的shim-repositories

• https://github.com/components
• https://github.com/frontpack

您始终可以在Packagist上搜索包。

许可: 新BSD许可证
作者: Jan Pecha, https://www.janpecha.cz/