PIE 1.5 вносит критическое изменение в поведение неинтерактивных установок расширений: флаг автоматического выбора пакета удалён, и теперь каждое требуемое расширение нужно явно сопоставлять с пакетом через --select.
Релиз также добавляет команду pie upgrade для обновления расширений с учётом версионных ограничений, возможность устанавливать несколько пакетов одной командой и ряд вспомогательных улучшений. Если ваш CI-пайплайн использует PIE, сценарии установки потребуют обновления.
Главное изменение: отказ от автоматического выбора пакетов
В PIE 1.5 флаг --allow-non-interactive-project-install, который ранее позволял автоматически выбирать пакет для каждого требуемого расширения, объявлен устаревшим и больше не работает. Теперь при неинтерактивной установке из директории проекта необходимо явно указывать соответствие между именем расширения и именем пакета через опцию --select.
Рассмотрим проект, в composer.json которого указаны зависимости:
{
"require": {
"ext-redis": "*"
},
"require-dev": {
"ext-xdebug": "*"
}
}
Запись ext-redis лишь декларирует требование к среде выполнения, но не устанавливает конкретное расширение. Чтобы сборка в CI прошла успешно, нужно явно выбрать пакет. Для production-окружения команда будет выглядеть так:
pie install --no-interaction --no-dev \
--select=redis=phpredis/phpredis
Левая часть маппинга — имя расширения без префикса ext-, правая — полное имя пакета. PIE проверит, установлен ли Redis, и при необходимости установит выбранный пакет. Для каждого дополнительного расширения, требующего выбора, добавляется ещё один --select.
Флаг --no-dev исключает из проверки зависимости из секции require-dev. В примере выше без него PIE попытался бы обработать и Xdebug, что привело бы к ошибке из-за отсутствия указания пакета. Для среды разработки, где нужны оба расширения, команда примет вид:
pie install --no-interaction \
--select=redis=phpredis/phpredis \
--select=xdebug=xdebug/xdebug
Установка нескольких расширений одной командой
Если вы указываете пакеты напрямую, а не полагаетесь на анализ composer.json, PIE 1.5 позволяет перечислить их в одной команде:
pie install phpredis/phpredis xdebug/xdebug
Это особенно удобно при формировании образов контейнеров, где все необходимые расширения известны заранее. Найти точное имя пакета помогает новая команда pie search.
Обновление расширений через pie upgrade
Версия 1.5 добавляет отдельную команду для обслуживания уже установленных через PIE расширений:
pie upgrade
Она работает с целевой инсталляцией PHP и учитывает версионные ограничения, заданные при установке. Например, если PhpRedis был установлен с явным ограничением ^6.0:
pie install 'phpredis/phpredis:^6.0'
то последующие запуски pie upgrade будут обновлять его в пределах 6.x. Переход на следующую мажорную версию потребует изменения ограничения. При обновлении сохраняются все переданные ранее configure-опции.
Дополнительные улучшения
pie check-build-tools— проверяет наличие необходимых для сборки инструментов. Полезна в неинтерактивных средах, где PIE по умолчанию не устанавливает сборочные зависимости автоматически.pie search— ищет пакеты расширений, упрощая подготовку команд.- Обновлена библиотека проверки аттестаций.
Полный список изменений доступен в официальных заметках к релизу.