composer asset plugin

Менеджер зависимостей NPM/Bower для Composer

Плагин Composer Asset позволяет вам управлять ресурсами проекта (css, js и т. д.) в вашем composer.json без установки NPM или Bower.

Этот плагин работает путем переноса информации о пакете из NPM или Bower в совместимую версию для Composer. Это позволяет вам очень легко управлять зависимостями активов в проекте на основе PHP.

Важный:

Следующая основная версия плагина Composer Asset Plugin настолько отличается от текущей версии, но при этом несовместима с ней, что стала новым проектом под названием Foxy.

Foxy — это новый способ управления ресурсами библиотек PHP, поскольку он изначально работает со всеми функциями NPM или Yarn. Тем не менее, этот плагин будет продолжать поддерживаться сообществом без новых функций.

Вы можете прочитать причины появления этой новой версии или разницу между Foxy и плагином Fxp Composer Asset, а также то, как работает Foxy.

Особенности включают в себя:

• Работает с собственными версиями системы управления репозитория VCS композитора.

• Работает с публичными и частными репозиториями VCS.

• Ленивая загрузка определений пакетов ресурсов для повышения производительности.

• Фильтр импорта с зависимостями корневого пакета и установленных пакетов для значительного повышения производительности обновления.

• Автоматически получить и создать репозиторий Asset VCS, определенный в:

• Реестр НПМ

• Реестр Бауэра

• Частный реестр Бауэра

• Автоматически получать и создавать репозитории Asset VCS для зависимостей, определенных в каждом пакете активов (включая зависимости разработки).

• Сопоставление преобразования пакета ресурсов в пакет композитора для:

• Пакет NPM — package.json

• Пакет Bower — Bower.json

• Конвертация версии Semver в версию композитора

• Преобразование версии диапазона Semver в версию диапазона композитора

• Преобразование зависимостей с URL в зависимости композитора с созданием репозиториев VCS

• Преобразование нескольких версий одной и той же зависимости в разные зависимости композитора

• Добавьте вручную несколько версий одной и той же зависимости в проект.

• Добавьте пользовательскую конфигурацию репозитория VCS.

• Переопределить конфигурацию репозитория VCS, определенную реестром активов, непосредственно в разделе конфигурации корневого композитора.

• Драйверы VCS для:

• Гит

• GitHub (совместим с перенаправлением репозитория)

• Гит Битбакет

• Меркуриальный

• Меркуриальный Битбакет

• СВН

• Перфорс

• Локальная система кэширования для:

• версии пакета

• содержимое упаковки

• перенаправление репозитория

• Пользовательские установщики ресурсов, настраиваемые в корневом файле composer.json

• Для Bower все файлы, определенные в разделе ignore не будут установлены.

• Отключить или заменить удаление файлов игнорирования для Bower

• Включить вручную удаление файлов игнорирования для NPM.

• Используйте диспетчер игнорируемых файлов в сценариях Composer.

• Настройте плагин для каждого проекта, глобально или с помощью переменных среды.

• Совместим со всеми командами, включая:

• depends

• diagnose

• licenses

• remove

• require

• search (только беседка)

• show

• status

Почему этот плагин?

Уже существует несколько возможностей управления ресурсами в PHP-проекте:

1. Установите Node.js и используйте командную строку NPM или Bower в дополнение к командной строке Composer.

2. Сделайте №1, но добавьте скрипты Composer для автоматизации процесса.

3. Включайте ресурсы непосредственно в проект (не рекомендуется)

4. Создайте репозиторий со всеми ресурсами и включите файл composer.json (и используйте Packagist или репозиторий VCS).

5. Добавьте репозиторий пакетов в composer.json с прямой ссылкой для скачивания.

6. Создайте сервер Satis или Packagist.

7. Другой?

Само собой разумеется, что каждая библиотека javascript, CSS и т. д. должна разрабатываться обычными для этого языка инструментами, которые хорошо известны фронтенд-разработчикам. Однако в случае полного проекта на PHP нет необходимости использовать несколько инструментов (PHP, Nodejs, Composer, NPM, Bower, Grunt и т. д.), чтобы просто установить эти ресурсы в ваш проект.

Этот плагин был создан для решения этих проблем. Кроме того, большинство разработчиков не будут добавлять файл composer.json в свои проекты только для поддержки проектов на основе PHP, особенно когда npm и/или Bower уже существуют и широко используются.

Документация

Основная часть документации находится в Resources/doc/index.md :

Прочтите документацию

Прочтите часто задаваемые вопросы

Прочтите примечания к выпуску

Установка

Все инструкции по установке находятся в документации.

Лицензия

Этот плагин композитора находится под лицензией MIT. Полную версию лицензии смотрите здесь:

ЛИЦЕНЗИЯ

О

Плагин Fxp Composer Asset — это инициатива Франсуа Плучино. См. также список участников.

Сообщение о проблеме или запрос функции

Проблемы и запросы функций отслеживаются в системе отслеживания проблем Github.