ترقية FreeScout إلى PHP 8.5 (قائمة تحقق Ubuntu 26.04)
قبل نقل FreeScout إلى PHP 8.5، تأكد من أن FreeScout وكل وحدة تشغّلها تدعمه، ثم تحقق من امتدادات PHP، وأعد تشغيل عامل قائمة الانتظار، وراقب السجل بحثاً عن deprecated since 8.5 الرسائل. يثبت Ubuntu 26.04 PHP 8.5 افتراضيًا، لذا غالبًا ما تكون ترقية نظام التشغيل هي ما يثير التغيير.
هذا يهم FreeScout أكثر من معظم تطبيقات PHP، بسبب طريقة تعامل FreeScout مع إشعارات الإهمال.
لماذا يمكن أن يكسر PHP 8.5 وحدات FreeScout
كل إصدار PHP يهمل بعض الوظائف الأقدم. يهمل PHP 8.5 عدة وظائف لم تفعل شيئًا منذ PHP 8.0، بما في ذلك curl_close(), imagedestroy()، و xml_parser_free(). كما يهمل بعض الحالات الحدّية، مثل استخدام null كمفتاح مصفوفة أو تمرير chr() قيمة خارج النطاق 0 إلى 255.
تسجّل معظم تطبيقات PHP إهانة (deprecation) وتستمر. يحوّل FreeScout كل إشعار إهانة إلى خطأ، لذا توقف استدعاء واحد متبقٍ الطلب أو المهمة الخلفية التي أصابته. قد تبدو الوحدة مثبتة وسليمة بينما يفشل كل اتصال تجريه.
إذا رأيت هذه الأخطاء بعد الترقية، إصلاح أخطاء "deprecated since 8.5" في FreeScout يشرح كيفية العثور على الوحدة المسؤولة وإصلاحها.
قبل الترقية
- تحقق من الدعم: اقرأ ملاحظات إصدار FreeScout ومتطلبات النظام لـ PHP 8.5، وتأكد من أن كل وحدة مثبتة لديها إصدار متوافق مع PHP 8.5.
- حدّث الوحدات أولًا: قم بتثبيت تلك التحديثات أثناء وجودك على إصدار PHP الحالي، حتى تكون كل وحدة جاهزة قبل النقل.
- نسخ احتياطي: خذ نسخة من دليل FreeScout وقاعدة البيانات وملفات تكوين PHP الخاصة بك.
- اختبر على نسخة: إذا أمكن، قم بتشغيل الترقية على نسخة اختبارية من مكتب المساعدة أولاً.
بعد الترقية
تحقق من إصدار PHP الذي يعمل عليه FreeScout
فتح إدارة > النظام. يعرض إصدار PHP الذي يستخدمه خادم الويب الخاص بك ويسرد إضافات PHP التي يحتاجها FreeScout، مع الإشارة إلى أي منها مفقود.طابق PHP سطر الأوامر
تشغيلphp -vعلى الخادم. عامل قائمة الانتظار وschedule:runيستخدم cron واجهة سطر أوامر PHP، والتي قد تختلف عن إصدار خادم الويب. يجب أن يعمل كلاهما بنفس الإصدار مع نفس الامتدادات.أعد تثبيت الإضافات والإعدادات
يأتي إصدار PHP جديد مع حزم إضافاته الخاصة وphp.iniالملفات. قم بتثبيت الامتدادات إدارة > النظام يضع علامة كمفقود، ثم يعيد تطبيق الإعدادات المخصصة مثلupload_max_filesizeوpost_max_size.وجّه خادم الويب إلى PHP الجديد
إذا كنت تستخدم PHP-FPM، تأكد من أن خادم الويب الخاص بك يستخدم مقبس أو خدمة PHP 8.5 FPM، ثم أعد تشغيل PHP-FPM وخادم الويب.امسح ذاكرات التخزين المؤقت وأعد تشغيل عامل قائمة الانتظار
شغّل هذه من دليل FreeScout الخاص بك حتى لا تحتفظ أي عملية بالكود القديم:الطرفيةphp artisan freescout:clear-cache php artisan queue:restart
ما يجب التحقق منه في السجلات
فتح إدارة > السجلات > سجلات التطبيق بعد استخدام مكتب المساعدة لفترة. ابحث عن:
is deprecated since 8.5، الذي يشير إلى وحدة أو ملف غير جاهز بعد لـ PHP 8.5.Providing a value not in-between 0 and 255 is deprecated، منchr()المكالمات.Using null as an array offset is deprecated.
كل إدخال يسمي الملف. مسار تحت Modules/<Name> يخبرك أي وحدة تحتاج إلى تحديث.
اختبر الميزات التي تُجري اتصالات صادرة، لأنها تفشل أولاً: جلب البريد، ومزودو الذكاء الاصطناعي، ومصادر المعرفة، والتكاملات مثل Linear أو Jira أو Slack أو موصلات المتاجر. حيث تقدم وحدة ما اختبر الاتصال الزر، استخدمه.
إذا تعطل شيء ما
أعد FreeScout إلى PHP 8.4 أثناء انتظار التحديثات. لا يعامل PHP 8.4 هذه الدوال كإهانات، لذا تعمل الشيفرة نفسها بشكل طبيعي هناك. بدّل كلًا من خادم الويب وPHP سطر الأوامر، ثم أعد تشغيل PHP-FPM وخادم الويب وعامل قائمة الانتظار.