پی اچ پی

رفع خطای نسخهٔ PHP و افزونه‌ها با composer check-platform-reqs

با check-platform-reqs نسخهٔ PHP و افزونه‌های لازم را بررسی کنید و اثر config.platform و تفاوت PHP وب و خط فرمان را بفهمید.

رایکت رایکت بروزرسانی ۳ دقیقه مطالعه ۰ دیدگاه
رفع خطای نسخهٔ PHP و افزونه‌ها با composer check-platform-reqs

وقتی 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 بارگذاری نشده بود. ترتیب و عبارت‌های دقیق خروجی ممکن است در نسخه‌های دیگر فرق کند.

۴. اصلاح را در محیط آزمایشی تأیید کنید

  1. نیازمندی دقیق و بستهٔ درخواست‌کننده را ثبت کنید. برای وابستگی توسعه، فقط وقتی دامنهٔ استقرار بدون dev تعریف شده از گزینهٔ –no-dev در بررسی همان دامنه استفاده کنید.
  2. راه متناسب را انتخاب کنید. نسخهٔ سازگار PHP، افزونهٔ لازم یا نسخهٔ پشتیبانی‌شدهٔ بسته را در محیط آزمایشی بررسی کنید.
  3. همان فرمان را با مفسر درست دوباره اجرا کنید و سپس صفحه یا قابلیت وابسته را در وب آزمایش کنید.

رد کردن بررسی پلتفرم با گزینهٔ ignore مشکل مفسر یا افزونه را رفع نمی‌کند. پیش از تغییر تنظیمات هاست، وضعیت قبلی و روش بازگشت به نسخه یا artifact تأییدشده را ثبت کنید.

برای تشخیص اینکه نیازمندی از نسخه‌های قفل‌شده می‌آید یا حاصل حل دوبارهٔ وابستگی‌هاست، تفاوت composer install و update و نقش فایل قفل را مرور کنید.

۵. مطالعهٔ مرتبط

۶. منابع و روش بررسی

منابع در ۱۳ نوامبر ۲۰۲۶ بررسی شدند. مثال در پوشهٔ محلی ویندوز با PHP ۸.۵.۱۲ و Composer ۲.۱۱.۲ اجرا شد. مخزن تمرینی بستهٔ واقعی دانلود نمی‌کند و اجرای اسکریپت و افزونه در آزمایش غیرفعال بود.

این مطلب برایتان مفید بود؟
رایکت
نوشته شده توسط رایکت

تیم محتوای رایکت؛ آموزش‌ها و راهنماهای کاربردی هاست، دامنه و مدیریت سایت.

مطالب مرتبط

دیدگاه‌ها

نظر یا سوال خود را درباره این مطلب با ما در میان بگذارید

دیدگاه خود را بنویسید

aapanel
cloudlinux
cpanel
directadmin
jetbackup
laravel
mysql
virtualizor
vmware
wordpress