composer asset plugin

Gerenciador de dependências NPM/Bower para Composer

O plug-in Composer Asset permite gerenciar ativos do projeto (css, js, etc.) em seu composer.json sem instalar NPM ou Bower.

Este plugin funciona transpondo informações do pacote do NPM ou Bower para uma versão compatível com o Composer. Isso permite que você gerencie dependências de ativos em um projeto baseado em PHP com muita facilidade.

Importante:

A próxima versão principal do Composer Asset Plugin é tão diferente, mas também incompatível com a versão atual, que se tornou um novo projeto chamado Foxy.

Foxy é a nova forma de gerenciar ativos de bibliotecas PHP, pois funciona nativamente com todos os recursos do NPM ou Yarn. Porém, este plugin continuará sendo mantido pela comunidade, sem contar com novas funcionalidades.

Você pode ler os motivos desta nova versão, ou a diferença entre Foxy e Fxp Composer Asset Plugin, mas também como o Foxy funciona.

Os recursos incluem:

• Funciona com versões de sistema de gerenciamento nativo do repositório VCS do compositor

• Funciona com repositórios VCS públicos e privados

• Carregador lento de definições de pacotes de ativos para melhorar o desempenho

• Filtro de importação com as dependências do pacote raiz e dos pacotes instalados, para aumentar drasticamente o desempenho da atualização

• Obtenha e crie automaticamente um repositório Asset VCS definido em:

• Registro NPM

• Registro Bower

• Registro Privado Bower

• Obtenha e crie automaticamente os repositórios de dependências do Asset VCS definidos em cada pacote de ativos (dependências de desenvolvimento incluídas)

• Mapeamento da conversão do pacote de ativos para o pacote compositor para:

• Pacote NPM - package.json

• Pacote Bower - bower.json

• Conversão da versão Semver para a versão do compositor

• Conversão da versão da gama Semver para a versão da gama compositor

• Conversão de dependências com URL para dependências do compositor com criação de repositórios VCS

• Conversão de múltiplas versões da mesma dependência para diferentes dependências do compositor

• Adicione manualmente as múltiplas versões de uma mesma dependência no projeto

• Adicione uma configuração personalizada do repositório VCS

• Substitua a configuração do repositório VCS definida pelo registro de ativos diretamente na seção de configuração do compositor raiz

• Drivers VCS para:

• Git

• GitHub (compatível com redirecionamentos de repositório)

• GitBitbucket

• Mercurial

• Bitbucket mercurial

• SVN

• Forçosamente

• Sistema de cache local para:

• versões do pacote

• conteúdo do pacote

• redirecionamentos de repositório

• Instaladores de ativos personalizados configuráveis ​​no arquivo raiz composer.json

• Para o Bower, todos os arquivos definidos na seção ignore não serão instalados

• Desative ou substitua a exclusão dos arquivos ignorados do Bower

• Habilite manualmente a exclusão dos arquivos ignorados para NPM

• Use o Ignore Files Manager nos scripts do Composer

• Configure o plugin por projeto, globalmente ou com as variáveis ​​de ambiente

• Compatível com todos os comandos, incluindo:

• depends

• diagnose

• licenses

• remove

• require

• search (somente bower)

• show

• status

Por que este plugin?

Já existem diversas possibilidades de gerenciamento de ativos em um projeto PHP:

1. Instale o Node.js e use a linha de comando NPM ou Bower além da linha de comando do Composer

2. Faça o nº 1, mas adicione scripts do Composer para automatizar o processo

3. Incluir ativos diretamente no projeto (não recomendado)

4. Crie um repositório com todos os ativos e inclua o arquivo composer.json (e use Packagist ou um repositório VCS)

5. Adicione um repositório de pacotes em composer.json com um link direto para download

6. Crie um servidor Satis ou Packagist

7. Outro?

Nem é preciso dizer que cada biblioteca javascript, CSS, etc. deve ser desenvolvida com as ferramentas usuais para aquela linguagem, que os desenvolvedores front-end conhecem bem. Porém, no caso de um projeto completo em PHP, não deve ser necessário utilizar diversas ferramentas (PHP, Nodejs, Composer, NPM, Bower, Grunt, etc.) para simplesmente instalar esses assets em seu projeto.

Este plugin foi criado para resolver esses problemas. Além disso, a maioria dos desenvolvedores não adicionará um arquivo composer.json aos seus projetos apenas para suportar projetos baseados em php, especialmente quando npm e/ou bower já existem e são amplamente utilizados.

Documentação

A maior parte da documentação está localizada em Resources/doc/index.md :

Leia a documentação

Leia as perguntas frequentes

Leia as notas de lançamento

Instalação

Todas as instruções de instalação estão localizadas na documentação.

Licença

Este plugin do compositor está sob licença do MIT. Veja a licença completa em:

LICENÇA

Sobre

Fxp Composer Asset Plugin é uma iniciativa de François Pluchino. Veja também a lista de colaboradores.

Relatando um problema ou uma solicitação de recurso

Problemas e solicitações de recursos são rastreados no rastreador de problemas do Github.