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 問題追蹤器中進行追蹤。