Mit dem Composer Asset Plugin können Sie Projektressourcen (CSS, JS usw.) in Ihrer composer.json
verwalten, ohne NPM oder Bower installieren zu müssen.
Dieses Plugin funktioniert durch die Übertragung von Paketinformationen von NPM oder Bower in eine kompatible Version für Composer. Dadurch können Sie Asset-Abhängigkeiten in einem PHP-basierten Projekt ganz einfach verwalten.
Wichtig:
Die nächste Hauptversion des Composer Asset Plugin ist so unterschiedlich, aber auch inkompatibel mit der aktuellen Version, dass daraus ein neues Projekt namens Foxy wurde.
Foxy ist die neue Möglichkeit, die Assets von PHP-Bibliotheken zu verwalten, da es nativ mit allen Funktionen von NPM oder Yarn funktioniert. Dieses Plugin wird jedoch weiterhin von der Community gepflegt, ohne neue Funktionen zu bieten.
Sie können die Gründe für diese neue Version oder den Unterschied zwischen Foxy und dem Fxp Composer Asset Plugin lesen, aber auch, wie Foxy funktioniert.
Funktioniert mit nativen Verwaltungssystemversionen des VCS-Repositorys von Composer
Funktioniert mit öffentlichen und privaten VCS-Repositorys
Lazy Loader von Asset-Paketdefinitionen zur Verbesserung der Leistung
Importfilter mit den Abhängigkeiten des Root-Pakets und der installierten Pakete, um die Leistung für das Update erheblich zu steigern
Rufen Sie automatisch ein Asset VCS-Repository ab und erstellen Sie es, definiert in:
NPM-Registrierung
Bower-Registrierung
Private Bower-Registrierung
Rufen Sie automatisch die Asset VCS-Repositorys der in jedem Asset-Paket definierten Abhängigkeiten ab und erstellen Sie diese (einschließlich Entwicklungsabhängigkeiten).
Zuordnung der Konvertierung des Asset-Pakets zum Composer-Paket für:
NPM-Paket – package.json
Bower-Paket – bower.json
Konvertierung der Semver-Version in die Composer-Version
Konvertierung der Semver-Range-Version in die Composer-Range-Version
Konvertierung von Abhängigkeiten mit URL in die Composer-Abhängigkeiten mit der Erstellung von VCS-Repositories
Konvertierung mehrerer Versionen derselben Abhängigkeit in unterschiedliche Composer-Abhängigkeiten
Fügen Sie manuell mehrere Versionen derselben Abhängigkeit im Projekt hinzu
Fügen Sie eine benutzerdefinierte Konfiguration des VCS-Repositorys hinzu
Überschreiben Sie die Konfiguration des VCS-Repositorys, die von der Asset-Registrierung direkt im Konfigurationsabschnitt des Root-Composers definiert wird
VCS-Treiber für:
Git
GitHub (kompatibel mit Repository-Weiterleitungen)
Git Bitbucket
Mercurial
Mercurial Bitbucket
SVN
Notgedrungen
Lokales Cache-System für:
Paketversionen
Packungsinhalt
Repository-Weiterleitungen
Benutzerdefinierte Asset-Installationsprogramme, die in der Stammdatei „ composer.json
konfigurierbar sind
Für Bower werden nicht alle im Abschnitt ignore
definierten Dateien installiert
Deaktivieren oder ersetzen Sie das Löschen der Ignorierdateien für Bower
Aktivieren Sie manuell das Löschen der Ignorierdateien für NPM
Verwenden Sie den Manager „Dateien ignorieren“ in den Composer-Skripten
Konfigurieren Sie das Plugin pro Projekt, global oder mit den Umgebungsvariablen
Kompatibel mit allen Befehlen, einschließlich:
depends
diagnose
licenses
remove
require
search
(nur Laube)
show
status
Es gibt bereits mehrere Möglichkeiten, Assets in einem PHP-Projekt zu verwalten:
Installieren Sie Node.js und verwenden Sie zusätzlich zur Composer-Befehlszeile die NPM- oder Bower-Befehlszeile
Machen Sie Schritt 1, aber fügen Sie Composer-Skripte hinzu, um den Prozess zu automatisieren
Assets direkt in das Projekt einbinden (nicht empfohlen)
Erstellen Sie ein Repository mit allen Assets und schließen Sie die Datei composer.json
ein (und verwenden Sie Packagist oder ein VCS-Repository).
Fügen Sie in composer.json
ein Paket-Repository mit einem direkten Download-Link hinzu
Erstellen Sie einen Satis- oder Packagist-Server
Andere?
Es versteht sich von selbst, dass jede Javascript-, CSS- usw. Bibliothek mit den üblichen Tools für diese Sprache entwickelt werden sollte, mit denen Frontend-Entwickler gut vertraut sind. Im Falle eines vollständigen Projekts in PHP sollte es jedoch nicht notwendig sein, mehrere Tools (PHP, Nodejs, Composer, NPM, Bower, Grunt usw.) zu verwenden, um diese Assets einfach in Ihrem Projekt zu installieren.
Dieses Plugin wurde erstellt, um diese Probleme zu beheben. Darüber hinaus fügen die meisten Entwickler ihren Projekten keine composer.json
-Datei hinzu, nur um PHP-basierte Projekte zu unterstützen, insbesondere wenn npm und/oder Bower bereits vorhanden sind und weit verbreitet sind.
Der Großteil der Dokumentation befindet sich in Resources/doc/index.md
:
Lesen Sie die Dokumentation
Lesen Sie die FAQs
Lesen Sie die Versionshinweise
Alle Installationsanweisungen finden Sie in der Dokumentation.
Dieses Composer-Plugin steht unter der MIT-Lizenz. Die vollständige Lizenz finden Sie unter:
LIZENZ
Das Fxp Composer Asset Plugin ist eine Initiative von François Pluchino. Siehe auch die Liste der Mitwirkenden.
Probleme und Funktionsanfragen werden im Github Issue Tracker verfolgt.