اگر Composer نسخهٔ مشخصی از یک بسته را نمیپذیرد، composer prohibits محدودیتهایی را که جلوی همان نسخه را میگیرند نشان میدهد. نام بسته و شمارهٔ نسخهٔ نامزد را مشخص کنید و هر سطر نتیجه را به بستهٔ درخواستکننده و بازهٔ مجاز آن وصل کنید.
۱. پرسش را با نسخهٔ دقیق مطرح کنید
composer prohibits demo/core 2.0.0
composer why demo/core
نامهای demo در این آموزش مربوط به مخزن تمرینیاند. در پروژهٔ خود نام دقیق بسته را از composer.json، composer.lock یا پیام خطا بردارید. فرمان اول میپرسد چه چیزی مانع نسخهٔ ۲٫۰٫۰ است. فرمان دوم نشان میدهد چه بستههایی به demo/core وابستهاند.
اگر میخواهید درخت وابستگی را ببینید از گزینهٔ --tree در prohibits استفاده کنید. خطای ریشه میتواند چند شاخه داشته باشد. هر شاخه را تا بستهٔ مستقیم یا محدودیت پروژه دنبال کنید.
۲. نتیجه را به یک تصمیم تبدیل کنید
demo/client 1.0.0 requires demo/core (^1.0)
در آزمایش واقعی، demo/client نسخهٔ ۱٫۰٫۰ بستهٔ core را در بازهٔ ^1.0 میخواست. نسخهٔ ۲٫۰٫۰ در این بازه قرار نمیگیرد. برای رسیدن به آن، باید نسخهٔ سازگار client را پیدا کنید یا core را در خط نسخهٔ پشتیبانیشده نگه دارید.
| محدودیت از کجا میآید؟ | چه بررسیای انجام دهید |
|---|---|
| بستهٔ ریشه | بازهٔ خود پروژه و دلیل ثبت آن را بخوانید. تغییر بازه باید با سازگاری کد و تست همراه باشد. |
| وابستگی غیرمستقیم | نسخههای بستهٔ واسط و محدودیتهای هر نسخه را بررسی کنید. |
| پلتفرم PHP | نسخه و افزونههای محیط هدف را با نیازمندی اعلامشده مقایسه کنید. |
| بسته در قفل ثابت مانده | متن resolver و دامنهٔ update جزئی را بررسی کنید. تصمیم تغییر یک بسته ممکن است به تغییر وابستگی دیگر نیاز داشته باشد. |
۳. محدودیت حل نسخه را در کپی پروژه بررسی کنید
- با composer.json و composer.lock همان بازبینی در یک شاخهٔ آزمایشی شروع کنید.
- نسخهٔ نامزد و بستهٔ محدودکننده را ثبت کنید. اگر تغییر نسخهٔ بستهٔ واسط لازم است، یادداشت انتشار و نیازمندیهای نسخهٔ جدید را بخوانید.
- پیشنمایش حل وابستگی را در همان محیط بررسی کنید. پس از تغییر تأییدشده، تفاوت قفل، نیازمندیهای PHP و نتیجهٔ آزمون برنامه را مرور کنید.
پاککردن قفل یا نادیدهگرفتن نیازمندیهای پلتفرم، علت تداخل را مشخص نمیکند. اگر بررسی نتیجه نداد، نام بسته، نسخهٔ نامزد و گزیدهٔ محدودیتها را ثبت کنید. آدرس مخزن خصوصی و اطلاعات احراز هویت را از گزارش عمومی حذف کنید.
۴. چرا خروجی خالی به معنی نصب موفق نیست؟
prohibits یک ابزار تشخیص بر اساس اطلاعات و وابستگیهای قابل مشاهده است. در دسترسبودن نسخه در مخزن، محدودیت امنیتی، وضعیت قفل و سازگاری کل گراف هم در حل واقعی اثر دارند. خروجی حل آزمایشی و تست برنامه را پیش از تصمیم نهایی کنار هم بخوانید.
اگر محدودیت به PHP یا یک افزونهٔ آن مربوط است، بررسی نیازمندیهای پلتفرم با check-platform-reqs را هم در محیط هدف انجام دهید تا محدودیت نسخهٔ بسته با وضعیت واقعی PHP اشتباه نشود.
۵. مطالعهٔ مرتبط
- PHP و MySQL چیست و چه ربطی به سایت من دارند؟
- رفع خطای Cannot find module در Node.js؛ مسیر یا وابستگی؟
۶. منابع و روش بررسی
منابع در ۱۳ نوامبر ۲۰۲۶ بررسی شدند. مثال در پوشهٔ محلی ویندوز با PHP ۸.۵.۱۲ و Composer ۲.۱۱.۲ اجرا شد. مخزن تمرینی بستهٔ واقعی دانلود نمیکند و اجرای اسکریپت و افزونه در آزمایش غیرفعال بود.