عند العمل على مشاريع PHP واستخدام Composer لإدارة التبعيات الخاصة بك، قد تواجه رسالة الخطأ "Your requirements could not be resolved to an installable set of packages".

غالباً واجهت هذا الخطأ عدة مرات من قبل، ﻷنه يمكن أن يكون سببه مجموعة متنوعة من الأسباب.

أتذكر شعوري بالإرهاق وعدم معرفتي من أين أبدأ في المرة الأولى التي رأيته فيها. لذا، إذا كنت تشعر بنفس الطريقة، فلا بأس بذلك! في هذه المقالة، سنحلل الخطأ وننظر في بعض الأسباب والحلول الشائعة. بحلول نهاية المقالة، يجب أن يكون لديك فهم أفضل لما يسبب الخطأ وكيفية حله.

#تعارضات بين إصدارات التبعيات

{
    "name": "ashallen/composer-test",
    "require": {
        "php": "^8.4",
        "ashallendesign/short-url": "^7.0"
    }
}

composer require nesbot/carbon:^3.0

Running Composer update nesbot/carbon
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.
 
  Problem 1
    - Root composer.json requires nesbot/carbon ^3.0, found nesbot/carbon[3.0.0, ..., 3.8.2] but these were not loaded, likely because it conflicts with another require.
  Problem 2
    - ashallendesign/short-url is locked to version v7.9.0 and an update of this package was not requested.
    - ashallendesign/short-url v7.9.0 requires nesbot/carbon ~2.0 -> found nesbot/carbon[2.0.0, ..., 2.72.5] but it conflicts with your root composer.json require (^3.0).
 
Use the option --with-all-dependencies (-W) to allow upgrades, downgrades and removals for packages currently locked to specific versions.
 
Installation failed, reverting ./composer.json and ./composer.lock to their original content.

لنحلل رسالة الخطأ ثم ننظر في بعض الحلول. يمكننا بعد ذلك اتخاذ خطوات صغيرة ومنطقية لحل المشكلة. لا تريد اتخاذ أي قرارات كبيرة دون فهم الصورة الكاملة لأنك ستخاطر بتعطيل تطبيقك. يذكر قسم "المشكلة 1" من رسالة الخطأ أننا نحاول طلب nesbot/carbon ^3.0 ويعرض لنا الإصدارات المتاحة (v3.0.0 - v3.8.2). لكنه يخبرنا أنه لا يمكن تحميلها. على الرغم من أن هذا يبدو واضحًا لنا الآن لأننا حاولنا تثبيته للتو، إلا أن هذا يمكن أن يكون مفيدًا إذا كان الخطأ ناتجًا عن حزمة لا نطلبها مباشرةً ولم تكن متأكدًا من مكان التعارض. يخبرنا قسم "المشكلة 2" أن ashallendesign/short-url مقفل عند الإصدار v7.9.0 ويتطلب nesbot/carbon ~2.0. لذلك، لا يمكننا تثبيت سوى إصدارات من nesbot/carbon بين v2.0.0 و v2.72.5. هذه مشكلة لأننا نحاول طلب ^3.0. في هذه المرحلة، لدينا فهم لما يسبب التعارض: نريد ^3.0، لكن إحدى تبعياتنا تحتاج إلى ^2.0. هناك العديد من الحلول الممكنة للاختيار من بينها:

#1. تحديث التبعية الموجودة لديك

composer require nesbot/carbon:^3.0 --with-all-dependencies

#2. استخدام إصدار أقدم من الحزمة الجديدة

composer require nesbot/carbon:^2.0

#3. إزالة التبعية الموجودة

#تعارضات بين إصدارات PHP

{
  "name": "ashallen/composer-test",
  "require": {
    "php": "^8.4"
  },
  "require-dev": {
    "phpunit/phpunit": "^11.5"
  }
}

Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.
 
  Problem 1
    - Root composer.json requires php ^8.4 but your php version (8.3.14) does not satisfy that requirement.

composer install --ignore-platform-reqs

#ملخص