وقتی Composer از نسخهٔ PHP یا افزونهای مانند GD ایراد میگیرد، composer check-platform-reqs نیازمندی بستهها را با PHP واقعیِ همان فرایند مقایسه میکند. ابتدا مشخص کنید Composer با کدام PHP اجرا میشود، سپس محیط خط فرمان و محیط وب را جدا تطبیق دهید.
۱. نسخه و افزونههای PHP خط فرمان را بخوانید
php -v
php --ini
php -m
composer check-platform-reqs --lock
سه فرمان اول نسخه، پیکربندی خواندهشده و فهرست افزونههای PHP خط فرمان را نشان میدهند. فرمان آخر نیازمندیهای فایل قفل موجود را بررسی میکند. اگر بستهها نصب شدهاند، اجرای check-platform-reqs بدون –lock نیازمندی بستههای نصبشده را بررسی میکند.
اگر wrapper فرمان composer از PHP دیگری استفاده میکند، از مسیر تأییدشدهٔ مفسر و فایل Composer همان محیط استفاده کنید. نتیجهٔ php -v برای باینری دیگری معتبر نیست.
۲. معنی خطا را از نام نیازمندی بخوانید
| نتیجه | گام بعدی |
|---|---|
php |
نسخهٔ گزارششده را با بازهٔ درخواستی بسته مقایسه کنید. |
ext-gd یا ext-intl |
بررسی کنید افزونه برای همان مفسر و همان پیکربندی بارگذاری شده باشد. |
| فقط خط فرمان موفق است | نسخه و افزونهٔ وب را از ابزار مجاز هاست یا محیط آزمایشی بررسی کنید. |
| فقط روی هاست خطا دارید | نسخه و فهرست افزونههای محیط هدف را کنار فایل قفل همان نسخه ثبت کنید. |
فایل php.ini و افزونهها میتوانند میان CLI، PHP-FPM و محیط میزبانی متفاوت باشند. برای تشخیص محیط وب از نمایش عمومی phpinfo خودداری کنید. اطلاعات لازم را از رابط مجاز هاست یا لاگ خصوصی محیط آزمایشی بخوانید.
۳. اثر config.platform را درست تفسیر کنید
Composer هنگام حل وابستگیها میتواند از مقادیر config.platform برای مدلکردن یک محیط هدف استفاده کند. این تنظیم به انتخاب نسخه کمک میکند. فرمان check-platform-reqs پلتفرم واقعی را بررسی میکند و برای مقایسه به مقادیر شبیهسازیشده تکیه نمیکند.
ext-gd n/a ... missing
php 8.5.12 ... success
این گزیده از آزمون محلی است. در پروژهٔ تمرینی، resolver با پلتفرم شبیهسازیشده قفل ساخت. هنگام بررسی قفل، PHP واقعی ۸٫۵٫۱۲ گزارش شد و GD در همان اجرای PHP بارگذاری نشده بود. ترتیب و عبارتهای دقیق خروجی ممکن است در نسخههای دیگر فرق کند.
۴. اصلاح را در محیط آزمایشی تأیید کنید
- نیازمندی دقیق و بستهٔ درخواستکننده را ثبت کنید. برای وابستگی توسعه، فقط وقتی دامنهٔ استقرار بدون dev تعریف شده از گزینهٔ –no-dev در بررسی همان دامنه استفاده کنید.
- راه متناسب را انتخاب کنید. نسخهٔ سازگار PHP، افزونهٔ لازم یا نسخهٔ پشتیبانیشدهٔ بسته را در محیط آزمایشی بررسی کنید.
- همان فرمان را با مفسر درست دوباره اجرا کنید و سپس صفحه یا قابلیت وابسته را در وب آزمایش کنید.
رد کردن بررسی پلتفرم با گزینهٔ ignore مشکل مفسر یا افزونه را رفع نمیکند. پیش از تغییر تنظیمات هاست، وضعیت قبلی و روش بازگشت به نسخه یا artifact تأییدشده را ثبت کنید.
برای تشخیص اینکه نیازمندی از نسخههای قفلشده میآید یا حاصل حل دوبارهٔ وابستگیهاست، تفاوت composer install و update و نقش فایل قفل را مرور کنید.
۵. مطالعهٔ مرتبط
- تغییر نسخه PHP در سیپنل با MultiPHP Manager
- MultiPHP INI Editor در سیپنل؛ تنظیم memory_limit، زمان اجرا و بقیه برای هر دامنه
۶. منابع و روش بررسی
منابع در ۱۳ نوامبر ۲۰۲۶ بررسی شدند. مثال در پوشهٔ محلی ویندوز با PHP ۸.۵.۱۲ و Composer ۲.۱۱.۲ اجرا شد. مخزن تمرینی بستهٔ واقعی دانلود نمیکند و اجرای اسکریپت و افزونه در آزمایش غیرفعال بود.