El complemento Composer Asset le permite administrar los activos del proyecto (css, js, etc.) en su composer.json
sin instalar NPM o Bower.
Este complemento funciona transponiendo información del paquete de NPM o Bower a una versión compatible para Composer. Esto le permite gestionar las dependencias de activos en un proyecto basado en PHP muy fácilmente.
Importante:
La próxima versión principal de Composer Asset Plugin es tan diferente, pero también incompatible con la versión actual, que se convirtió en un nuevo proyecto llamado Foxy.
Foxy es la nueva forma de gestionar los activos de las bibliotecas PHP, porque funciona de forma nativa con todas las funciones de NPM o Yarn. Sin embargo, este complemento seguirá siendo mantenido por la comunidad, sin tener nuevas funciones.
Puede leer los motivos de esta nueva versión, o la diferencia entre Foxy y Fxp Composer Asset Plugin, pero también cómo funciona Foxy.
Funciona con versiones nativas del sistema de gestión del repositorio VCS de Composer.
Funciona con repositorios VCS públicos y privados.
Cargador diferido de definiciones de paquetes de activos para mejorar el rendimiento
Filtro de importación con las dependencias del paquete raíz y los paquetes instalados, para aumentar drásticamente el rendimiento de la actualización.
Obtenga y cree automáticamente un repositorio de Asset VCS definido en:
Registro del MNP
Registro de glorieta
Registro de glorieta privada
Obtenga y cree automáticamente los repositorios de Asset VCS de las dependencias definidas en cada paquete de activos (dependencias de desarrollo incluidas)
Conversión de mapeo de paquete de activos a paquete de compositor para:
Paquete NPM - paquete.json
Paquete Bower - bower.json
Conversión de la versión de Semver a la versión del compositor.
Conversión de la versión de la gama Semver a la versión de la gama Composer
Conversión de dependencias con URL a las dependencias del compositor con la creación de repositorios VCS
Conversión de múltiples versiones de la misma dependencia a diferentes dependencias del compositor
Agregue manualmente las múltiples versiones de una misma dependencia en el proyecto.
Agregue una configuración personalizada del repositorio VCS
Anule la configuración del repositorio VCS definida por el registro de activos directamente en la sección de configuración del compositor raíz
Controladores VCS para:
git
GitHub (compatible con redirecciones de repositorio)
Git Bitbucket
Mercurial
Bitbucket mercurial
SVN
Forzosamente
Sistema de caché local para:
versiones del paquete
contenido del paquete
redirecciones del repositorio
Instaladores de activos personalizados configurables en el archivo raíz composer.json
Para Bower, no se instalarán todos los archivos definidos en la sección ignore
Deshabilite o reemplace la eliminación de archivos ignorados para Bower
Habilite manualmente la eliminación de los archivos ignorados para NPM
Utilice el Administrador de ignorar archivos en los scripts de Composer
Configurar el plugin por proyecto, globalmente o con las variables de entorno
Compatible con todos los comandos, incluidos:
depends
diagnose
licenses
remove
require
search
(solo glorieta)
show
status
Ya existen varias posibilidades para gestionar activos en un proyecto PHP:
Instale Node.js y use la línea de comando NPM o Bower además de la línea de comando Composer
Haga el punto 1, pero agregue scripts de Composer para automatizar el proceso
Incluir activos directamente en el proyecto (no recomendado)
Cree un repositorio con todos los activos e incluya el archivo composer.json
(y use Packagist o un repositorio VCS)
Agregue un repositorio de paquetes en composer.json
con un enlace de descarga directa
Crear un servidor Satis o Packagist
¿Otro?
No hace falta decir que cada biblioteca javascript, CSS, etc. debe desarrollarse con las herramientas habituales para ese lenguaje, que los desarrolladores front-end conocen bien. Sin embargo, en el caso de un proyecto completo en PHP, no debería ser necesario utilizar varias herramientas (PHP, Nodejs, Composer, NPM, Bower, Grunt, etc.) para simplemente instalar estos activos en su proyecto.
Este complemento ha sido creado para abordar estos problemas. Además, la mayoría de los desarrolladores no agregarán un archivo composer.json
a sus proyectos solo para admitir proyectos basados en php, especialmente cuando npm y/o bower ya existen y se usan ampliamente.
La mayor parte de la documentación se encuentra en Resources/doc/index.md
:
Lea la documentación
Lea las preguntas frecuentes
Lea las notas de la versión
Todas las instrucciones de instalación se encuentran en la documentación.
Este complemento de compositor está bajo la licencia MIT. Ver la licencia completa en:
LICENCIA
El complemento Fxp Composer Asset es una iniciativa de François Pluchino. Véase también la lista de contribuyentes.
Los problemas y las solicitudes de funciones se rastrean en el rastreador de problemas de Github.