إصلاح أخطاء "deprecated since 8.5" في FreeScout
إذا توقفت ميزات FreeScout عن العمل بعد الانتقال إلى PHP 8.5، تحقق من سجل FreeScout بحثاً عن رسائل تنتهي بـ is deprecated since 8.5. يذكر كل منها الملف الذي تسبب فيه. حدّث الوحدة أو مكوّن FreeScout الذي يملك ذلك الملف، وأفرغ ذاكرة التخزين المؤقت، وأعد تشغيل عامل قائمة الانتظار.
PHP 8.5 هو إصدار PHP الافتراضي على Ubuntu 26.04، لذا تظهر هذه الأخطاء غالباً مباشرة بعد ترقية نظام التشغيل.
الأعراض
عادةً ما يظل FreeScout نفسه يعمل، لكن الميزات الفردية تفشل:
- خاصية اختبر الاتصال يبلغ الزر أنه لا يمكنه الوصول إلى خادم.
- تتوقف الوظائف الخلفية، مثل المزامنة أو الجلب أو صياغة AI، عن إنتاج النتائج.
- يتوقف تكامل كان يعمل قبل الترقية عن العمل بصمت.
- تُرجع صفحة إعدادات أو إجراء خطأ خادم.
العلامة الدالة هي أن curl إلى نفس العنوان يعمل من سطر أوامر الخادم، بينما تقول الوحدة إنها لا تستطيع الاتصال.
رسائل السجل
افتح سجل تطبيق FreeScout (إدارة > السجلات > سجلات التطبيق، أو storage/logs/laravel-<date>.log على الخادم). تبدو إهمالات PHP 8.5 هكذا:
Function curl_close() is deprecated since 8.5, as it has no effect since PHP 8.0
Function imagedestroy() is deprecated since 8.5, as it has no effect since PHP 8.0
chr(): Providing a value not in-between 0 and 255 is deprecated
Using null as an array offset is deprecated, use an empty string insteadعادةً ما تضيف الوحدة سياقها الخاص حول الرسالة، مثل المهمة أو الطلب الذي فشل.
لماذا يحدث
يُهمل PHP 8.5 بعض الدوال القديمة والحالات الحدية. العديد منها، مثل curl_close() و imagedestroy()، لم تفعل شيئاً منذ PHP 8.0، لذا لا يزال الكود الأقدم يستدعيها.
في معظم تطبيقات PHP، يكون إهمال الإصدار مجرد تحذير في السجل. يتعامل FreeScout مع كل إشعار إهمال كخطأ. لذا قد يكتمل الطلب بنجاح ثم يفشل بسبب استدعاء متبقٍ مثل curl_close(). عادةً ما تكون عناوين URL ومفاتيح API والشبكة وإضافات PHP لديك سليمة.
إصلاح: حدّث الكود المتأثر
ابحث عن الملف في إدخال السجل
افتح إدخال السجل الكامل. مسار تحتModules/<Name>يشير إلى تلك الوحدة. مسار تحتapp/أوvendor/يشير إلى FreeScout نفسه.حدّث تلك الوحدة أو FreeScout
فتح إدارة > الوحدات وثبّت أي تحديثات متاحة، أو تحقق من موقع مطور الوحدة للحصول على إصدار متوافق مع PHP 8.5. بالنسبة لـ FreeScout نفسه، حدّث إلى أحدث إصدار.امسح ذاكرة التخزين المؤقت وأعد تشغيل عامل قائمة الانتظار
شغّل هذه من دليل FreeScout الخاص بك. عامل قائمة الانتظار عملية طويلة الأمد، لذا يحتفظ بالكود القديم حتى يُعاد تشغيله.الطرفيةphp artisan freescout:clear-cache php artisan queue:restartأعد محاولة ما فشل
انقر اختبر الاتصال مرة أخرى، أعد تشغيل أي مزامنة توقفت، وتأكد من اكتمال مهام الخلفية الجديدة.
تأكد من نجاحه
- الميزة التي فشلت تعمل مرة أخرى.
- لم تعد إدخالات السجل الجديدة تذكر
is deprecated since 8.5.
إذا لم يتوفر تحديث بعد
شغّل FreeScout على PHP 8.4 حتى يصدر المطور إصلاحاً. لا يعامل PHP 8.4 هذه الدوال كمهملة، لذا يعمل الكود نفسه بشكل طبيعي هناك.
بدّل إصدارَي PHP اللذين يستخدمهما FreeScout. إدارة > النظام يُظهر الإصدار الذي يعمل عليه خادم الويب الخاص بك. يستخدم عامل قائمة الانتظار وcron PHP من سطر الأوامر، لذا تحقق من php -v على الخادم أيضًا. ثم أعد تشغيل PHP-FPM أو خادم الويب الخاص بك، وعامل قائمة الانتظار.
للانتقال الكامل، راجع ترقية FreeScout إلى PHP 8.5.
ReplyRabbit و PHP 8.5