Composer.json в PHP: полный разбор инструмента управления зависимостями

{
  "name": "myvendor/myapp",
  "description": "Пример приложения",
  "require": {
    "php": ">=8.0",
    "monolog/monolog": "^2.0"
  },
  "autoload": {
    "psr-4": {
      "MyApp\\": "src/"
    }
  }
}

Как указать зависимость только для разработки?

Цель: установить пакеты для тестирования, code style, PHPStan, которые не нужны на production.

{
  "require-dev": {
    "phpunit/phpunit": "^10.0",
    "phpstan/phpstan": "^1.10"
  }
}

Autoload php composer (автозагрузка классов с помощью composer в php)

Установка производится командой composer install --no-dev на продакшне. Типичная ошибка: использование класса из dev-пакета в основном коде – на продакшне вызовет фатальную ошибку.

Как настроить автозагрузку по PSR-0?

Цель: поддержка устаревших библиотек, использующих PSR-0.

{
  "autoload": {
    "psr-0": {
      "MyLib_": "src/"
    }
  }
}

Php composer package (управление пакетами composer в php)

Проблема: PSR-0 требует имена классов с подчеркиваниями, что не соответствует современным стандартам. При переходе на PSR-4 может потребоваться рефакторинг.

Как добавить пользовательский репозиторий?

Цель: установить пакет не из Packagist, а из приватного Git-репозитория или локальной папки.

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/mycompany/mylib"
    },
    {
      "type": "path",
      "url": "../mylib-local",
      "options": {
        "symlink": true
      }
    }
  ]
}

Composer php 8.1 (установка composer для php 8.1)

После добавления репозитория можно указать пакет mycompany/mylib в require. Ошибка: если версия в репозитории не соответствует require (например, не указан тег), composer выдаст предупреждение о неверном формате версии.

Как зафиксировать минимальную стабильность?

Цель: разрешить или запретить установку нестабильных версий (dev, alpha, beta).

{
  "minimum-stability": "stable",
  "prefer-stable": true
}

Php composer json (php: работа с composer.json)

Если разработчик хочет использовать dev-версию конкретного пакета, можно указать её явно в require: "monolog/monolog": "dev-main". Проблема: при minimum-stability: stable и отсутствии prefer-stable, composer может не установить пакет, если его стабильная версия не найдена – в итоге ошибка Could not find a matching version.

Как задать платформенные требования (версию PHP, расширения)?

Цель: гарантировать, что на целевой машине установлена нужная версия PHP и расширения.

{
  "require": {
    "php": ">=8.0, <8.3",
    "ext-json": "*",
    "ext-mbstring": "*"
  },
  "config": {
    "platform": {
      "php": "8.1"
    }
  }
}

Composer platform php (платформа composer (platform config))

Ключ config.platform позволяет имитировать определённую платформу для разрешения зависимостей (полезно, когда разработка ведётся на PHP 8.2, а продакшн на 8.1). Типичная ошибка: указание в platform версии, которая не совпадает с фактической, – тогда установленные пакеты могут использовать функции, недоступные в реальной среде.

Как управлять скриптами (hooks)?

Цель: выполнять автоматические действия после определённых событий (install, update, autoload-dump).

{
  "scripts": {
    "post-install-cmd": [
      "@clear-cache",
      "php artisan config:cache"
    ],
    "post-update-cmd": [
      "@clear-cache"
    ],
    "clear-cache": "rm -rf var/cache/*"
  }
}

Vendor php (директория vendor в php (composer))

Проблема: если скрипт завершается с ошибкой, composer прерывает выполнение. Для отладки можно использовать @composer --verbose.

Как обработать конфликтующие пакеты?

Цель: предотвратить установку несовместимых библиотек.

{
  "conflict": {
    "vendor/package": ">=2.0",
    "vendor/old-lib": "*"
  }
}

Ошибка: если конфликтующая версия уже установлена, composer при попытке обновления выдаст сообщение The requested package conflicts with ....