Le plugin Composer Asset vous permet de gérer les actifs du projet (css, js, etc.) dans votre composer.json
sans installer NPM ou Bower.
Ce plugin fonctionne en transposant les informations du package de NPM ou Bower vers une version compatible pour Composer. Cela vous permet de gérer très facilement les dépendances des actifs dans un projet basé sur PHP.
Important:
La prochaine version majeure de Composer Asset Plugin est si différente, mais également incompatible avec la version actuelle, qu'elle est devenue un nouveau projet nommé Foxy.
Foxy est la nouvelle façon de gérer les actifs des bibliothèques PHP, car elle fonctionne nativement avec toutes les fonctionnalités de NPM ou Yarn. Cependant, ce plugin continuera à être maintenu par la communauté, sans pour autant disposer de nouvelles fonctionnalités.
Vous pouvez lire les raisons de cette nouvelle version, ou encore la différence entre Foxy et Fxp Composer Asset Plugin, mais aussi comment fonctionne Foxy.
Fonctionne avec les versions natives du système de gestion du référentiel VCS du compositeur
Fonctionne avec les référentiels VCS publics et privés
Chargeur paresseux de définitions de packages d'actifs pour améliorer les performances
Filtre d'importation avec les dépendances du package racine et des packages installés, pour augmenter considérablement les performances de la mise à jour
Obtenez et créez automatiquement un référentiel Asset VCS défini dans :
Registre NPM
Registre Bower
Registre privé Bower
Obtenez et créez automatiquement les référentiels Asset VCS des dépendances définies dans chaque package d'actifs (dépendances de développement incluses)
Conversion de mappage du package d'actifs en package composer pour :
Package NPM - package.json
Paquet Bower - bower.json
Conversion de la version Semver vers la version composer
Conversion de la version gamme Semver vers la version gamme composer
Conversion des dépendances avec URL vers les dépendances du composer avec la création de référentiels VCS
Conversion de plusieurs versions de la même dépendance en différentes dépendances du compositeur
Ajouter manuellement les multiples versions d'une même dépendance dans le projet
Ajouter une configuration personnalisée du référentiel VCS
Remplacez la configuration du référentiel VCS définie par le registre d'actifs directement dans la section de configuration du compositeur racine
Pilotes VCS pour :
Git
GitHub (compatible avec les redirections de référentiel)
Git Bitbucket
Mercuriel
Bitbucket Mercurial
SVN
Forcément
Système de cache local pour :
versions de paquet
contenu du paquet
redirections de référentiel
Installateurs d'actifs personnalisés configurables dans le fichier racine composer.json
Pour Bower, tous les fichiers définis dans la section ignore
ne seront pas installés
Désactivez ou remplacez la suppression des fichiers ignorés pour Bower
Activer manuellement la suppression des fichiers ignorés pour NPM
Utilisez le gestionnaire de fichiers ignorés dans les scripts Composer
Configurer le plugin par projet, globalement ou avec les variables d'environnement
Compatible avec toutes les commandes, notamment :
depends
diagnose
licenses
remove
require
search
(bower uniquement)
show
status
Il existe déjà plusieurs possibilités pour gérer des actifs dans un projet PHP :
Installez Node.js et utilisez la ligne de commande NPM ou Bower en plus de la ligne de commande Composer
Faites le n°1, mais ajoutez des scripts Composer pour automatiser le processus
Inclure les actifs directement dans le projet (non recommandé)
Créez un référentiel avec tous les actifs et incluez le fichier composer.json
(et utilisez Packagist ou un référentiel VCS)
Ajoutez un référentiel de packages dans composer.json
avec un lien de téléchargement direct
Créer un serveur Satis ou Packagist
Autre?
Il va sans dire que chaque bibliothèque javascript, CSS, etc. doit être développée avec les outils habituels de ce langage, que les développeurs front-end connaissent bien. Cependant, dans le cas d'un projet complet en PHP, il ne devrait pas être nécessaire d'utiliser plusieurs outils (PHP, Nodejs, Composer, NPM, Bower, Grunt, etc.) pour simplement installer ces actifs dans votre projet.
Ce plugin a été créé pour résoudre ces problèmes. De plus, la plupart des développeurs n'ajouteront pas de fichier composer.json
à leurs projets uniquement pour prendre en charge les projets basés sur PHP, en particulier lorsque npm et/ou bower existent déjà et sont largement utilisés.
La majeure partie de la documentation se trouve dans Resources/doc/index.md
:
Lire la documentation
Lire la FAQ
Lire les notes de version
Toutes les instructions d'installation se trouvent dans la documentation.
Ce plugin composer est sous licence MIT. Voir la licence complète dans :
LICENCE
Fxp Composer Asset Plugin est une initiative de François Pluchino. Voir aussi la liste des contributeurs.
Les problèmes et les demandes de fonctionnalités sont suivis dans le suivi des problèmes Github.