Composer Asset Plugin を使用すると、NPM や Bower をインストールせずに、 composer.json
でプロジェクト アセット (css、js など) を管理できます。
このプラグインは、NPM または Bower のパッケージ情報を Composer の互換性のあるバージョンに置き換えることによって機能します。これにより、PHP ベースのプロジェクト内のアセットの依存関係を非常に簡単に管理できるようになります。
重要:
Composer Asset Plugin の次のメジャー バージョンは、現在のバージョンとは大きく異なりますが、互換性がないため、Foxy という名前の新しいプロジェクトになりました。
Foxy は、NPM または Yarn のすべての機能とネイティブに動作するため、PHP ライブラリのアセットを管理する新しい方法です。ただし、このプラグインは新しい機能を持たずにコミュニティによって維持され続けます。
この新しいバージョンの理由、または Foxy と Fxp Composer Asset Plugin の違いだけでなく、Foxy がどのように機能するかについても読むことができます。
Composer の VCS リポジトリのネイティブ管理システム バージョンで動作します
パブリックおよびプライベート VCS リポジトリで動作します
パフォーマンスを向上させるためのアセット パッケージ定義の遅延ローダー
ルート パッケージとインストールされたパッケージの依存関係を含むインポート フィルターにより、更新のパフォーマンスが大幅に向上します。
以下で定義されているアセット VCS リポジトリを自動的に取得して作成します。
NPMレジストリ
バウワーレジストリ
プライベートバウワーレジストリ
各アセット パッケージで定義された依存関係のアセット VCS リポジトリを自動的に取得および作成します (開発依存関係を含む)
アセット パッケージからコンポーザー パッケージへのマッピング変換:
NPM パッケージ - package.json
Bower パッケージ - bower.json
Semver バージョンから Composer バージョンへの変換
Semver 範囲バージョンから Composer 範囲バージョンへの変換
VCS リポジトリの作成による、URL を含む依存関係から Composer 依存関係への変換
同じ依存関係の複数のバージョンを Composer の異なる依存関係に変換する
同じ依存関係の複数のバージョンをプロジェクトに手動で追加する
VCS リポジトリのカスタム構成を追加する
アセットレジストリによって定義された VCS リポジトリの設定を、ルートコンポーザーの設定セクションで直接オーバーライドします。
以下の VCS ドライバー:
Git
GitHub (リポジトリ リダイレクトと互換性があります)
Git Bitbucket
マーキュリアル
Mercurial Bitbucket
SVN
パーフォース
ローカル キャッシュ システム:
パッケージのバージョン
パッケージ内容
リポジトリのリダイレクト
ルートファイルcomposer.json
で構成可能なカスタムアセットインストーラー
Bower の場合、セクションignore
で定義されたすべてのファイルはインストールされません
Bower の無視ファイルの削除を無効にするか置き換えます
NPM の無視ファイルの削除を手動で有効にする
Composer スクリプトで無視ファイル マネージャーを使用する
プラグインをプロジェクトごとに、グローバルに、または環境変数を使用して構成します
以下を含むすべてのコマンドと互換性があります。
depends
diagnose
licenses
remove
require
search
(船首のみ)
show
status
PHP プロジェクトでアセットを管理するには、すでにいくつかの可能性があります。
Node.js をインストールし、Composer コマンド ラインに加えて NPM または Bower コマンド ラインを使用します。
#1 を実行しますが、Composer スクリプトを追加してプロセスを自動化します
アセットをプロジェクトに直接含める (推奨されません)
すべてのアセットを含むリポジトリを作成し、 composer.json
ファイルを含めます (そして Packagist または VCS リポジトリを使用します)。
直接ダウンロード リンクを使用して、 composer.json
にパッケージ リポジトリを追加します。
Satis または Packagist サーバーを作成する
他の?
言うまでもなく、JavaScript、CSS などの各ライブラリは、フロントエンド開発者がよく知っている、その言語の通常のツールを使用して開発する必要があります。ただし、PHP で完全なプロジェクトを作成する場合、これらのアセットをプロジェクトにインストールするだけで複数のツール (PHP、Nodejs、Composer、NPM、Bower、Grunt など) を使用する必要はありません。
このプラグインは、これらの問題に対処するために作成されました。さらに、ほとんどの開発者は、特に npm や bower がすでに存在し、広く使用されている場合、php ベースのプロジェクトをサポートするためだけに、 composer.json
ファイルをプロジェクトに追加しません。
ドキュメントの大部分はResources/doc/index.md
にあります。
ドキュメントを読む
よくある質問を読む
リリースノートを読む
すべてのインストール手順はドキュメントに記載されています。
このコンポーザー プラグインは MIT ライセンスの下にあります。完全なライセンスについては、次を参照してください。
ライセンス
Fxp Composer Asset Plugin は、François Pluchino の取り組みです。寄稿者のリストもご覧ください。
問題と機能リクエストは Github 問題トラッカーで追跡されます。