Настройка требуемой версии PHP для работы с Composer

Расширенные примеры работы с версией PHP и Composer

Пример 1. Использование COMPOSER_PHP_BINARY с проверкой версии

В проекте требуется PHP 8.1, но в системе установлены 7.4 и 8.1. Переменная окружения задаётся перед вызовом Composer.

# Установка переменной и выполнение
COMPOSER_PHP_BINARY=/usr/bin/php8.1 \
  composer require symfony/console

Using version ^6.4 for symfony/console
./composer.json has been updated
Running composer update symfony/console
Loading composer repositories with package information
Updating dependencies
Nothing to modify in lock file
Installing dependencies from lock file (including require-dev)
Package operations: 0 installs, 0 updates, 0 removals
Generating autoload files

Если переменная не задана или указан неверный путь, Composer использует версию PHP по умолчанию, что может вызвать ошибку совместимости:

composer require symfony/console 2>&1; echo "Exit: $?"

[InvalidArgumentException]
  Could not find package symfony/console with version >=6.4 ...
  The requested PHP version 8.1 is required by the package but you have 7.4.33.

Пример 2. Множественные версии PHP и update-alternatives

Установка трёх версий PHP и переключение между ними.

# Установка PHP 7.4, 8.1, 8.2
sudo apt update
sudo apt install php7.4 php8.1 php8.2 php7.4-cli php8.1-cli php8.2-cli

# Просмотр списка альтернатив (если уже добавлены)
sudo update-alternatives --list php
# Если пусто, добавить вручную:
sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74 --slave /usr/bin/phar phar /usr/bin/phar7.4
sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.1 81 --slave /usr/bin/phar phar /usr/bin/phar8.1
sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82 --slave /usr/bin/phar phar /usr/bin/phar8.2

# Интерактивное переключение
sudo update-alternatives --config php

There are 3 choices for the alternative php (providing /usr/bin/php).

  Selection    Path             Priority   Status
------------------------------------------------------------
* 0            /usr/bin/php8.2   82        auto mode
  1            /usr/bin/php7.4   74        manual mode
  2            /usr/bin/php8.1   81        manual mode
  3            /usr/bin/php8.2   82        manual mode

Press <enter> to keep the current choice[*], or type selection number: 2

После выбора 2 команда php -v покажет PHP 8.1. Composer также начнёт использовать эту версию.

Пример 3. Docker Compose для Composer с фиксированной версией PHP

Создание файла docker-compose.yml для проекта.

version: '3.8'
services:
  composer:
    image: composer:2.5.8
    volumes:
      - .:/app
    working_dir: /app
    entrypoint: ["composer"]
    command: ["install"]

Запуск:

docker-compose run --rm composer

Результат: внутри контейнера выполняется composer install с PHP версии, встроенной в образ (например, 8.1). Если нужно явно указать PHP более старой версии, используется образ с тегом composer:2.2 (содержит PHP 7.4).

Пример 4. phpenv: установка PHP и привязка к проекту

Предварительно phpenv установлен (инструкция на github.com/phpenv/phpenv).

# Установка PHP 7.4.33
phpenv install 7.4.33
# Список установленных
phpenv versions
# Переход в директорию проекта
cd /home/user/project
# Установка локальной версии
phpenv local 7.4.33
# Проверка
php -v
# Запуск Composer
composer install

PHP 7.4.33 (cli) (built: Nov  9 2023 12:00:00) ( NTS )
...
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file ...

Файл .php-version в корне проекта позволяет автоматически переключать версию при каждом входе в директорию (если настроен хук в оболочке).

Пример 5. composer.json с точным указанием версии PHP и проверка

Требование: проект работает только на PHP 8.0.x (не 8.1).

{
    "require": {
        "php": "8.0.*",
        "monolog/monolog": "^2.0"
    }
}

Попытка установить зависимости на системе с PHP 8.1:

composer install

Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires PHP 8.0.* but your PHP version (8.1.12) does not satisfy that requirement.

Если же PHP версии 8.0.x установлена и используется, установка пройдёт успешно.

Пример 6. Алиас в .bashrc для нескольких версий Composer

# В ~/.bashrc
alias composer7='php7.4 /usr/local/bin/composer'
alias composer8='php8.1 /usr/local/bin/composer'
alias composer82='php8.2 /usr/local/bin/composer'

# Перезагрузка
source ~/.bashrc

# Использование
composer8 require laravel/framework

Using version ^10.0 for laravel/framework
...

Для автоматического определения версии по composer.json можно написать функцию:

function composer() {
    local phpVer=$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;');
    case $phpVer in
        7.4) command php7.4 "$(which composer)" "$@";;
        8.1) command php8.1 "$(which composer)" "$@";;
        8.2) command php8.2 "$(which composer)" "$@";;
        *) command php "$(which composer)" "$@";;
    esac
}