การอัปเกรด 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 ส่วนใหญ่บันทึกการเลิกใช้และดำเนินการต่อ 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:runcron ใช้ PHP แบบบรรทัดคำสั่ง ซึ่งอาจแตกต่างจากเวอร์ชันของเว็บเซิร์ฟเวอร์ ทั้งสองต้องรันเวอร์ชันเดียวกันพร้อมส่วนขยายเดียวกันติดตั้งส่วนขยายและการตั้งค่าใหม่
เวอร์ชัน PHP ใหม่มาพร้อมแพ็กเกจส่วนขยายของตัวเองและphp.iniไฟล์ ติดตั้งส่วนขยาย จัดการ > ระบบ ทำเครื่องหมายว่าขาดหาย จากนั้นนำการตั้งค่าที่กำหนดเองกลับมาใช้เช่นupload_max_filesizeและpost_max_size.ชี้เว็บเซิร์ฟเวอร์ไปที่ PHP ใหม่
หากคุณใช้ PHP-FPM ให้ยืนยันว่าเว็บเซิร์ฟเวอร์ของคุณใช้ซ็อกเก็ตหรือบริการ PHP 8.5 FPM จากนั้นรีสตาร์ท PHP-FPM และเว็บเซิร์ฟเวอร์ล้างแคชและรีสตาร์ท queue worker
เรียกใช้คำสั่งเหล่านี้จากไดเรกทอรี FreeScout ของคุณเพื่อไม่ให้มีโปรเซสใดรันโค้ดเก่าอยู่:เทอร์มินัลphp artisan freescout:clear-cache php artisan queue:restart
สิ่งที่ควรตรวจสอบในบันทึก
เปิด จัดการ > บันทึก > บันทึกแอป หลังจากใช้ศูนย์ช่วยเหลือไประยะหนึ่ง ค้นหา:
is deprecated since 8.5, ซึ่งชี้ไปยังโมดูลหรือไฟล์ที่ยังไม่พร้อมสำหรับ PHP 8.5Providing a value not in-between 0 and 255 is deprecated, จากchr()การเรียกUsing null as an array offset is deprecated.
แต่ละรายการระบุชื่อไฟล์ เส้นทางภายใต้ Modules/<Name> บอกคุณว่าโมดูลใดต้องอัปเดต
ทดสอบฟีเจอร์ที่สร้างการเชื่อมต่อขาออก เพราะสิ่งเหล่านี้ล้มเหลวก่อน: การดึงอีเมล ผู้ให้บริการ AI แหล่งความรู้ และการเชื่อมต่อต่างๆ เช่น Linear, Jira, Slack หรือตัวเชื่อมต่อร้านค้า ในกรณีที่โมดูลมี ทดสอบการเชื่อมต่อ ปุ่ม ให้ใช้
หากมีบางอย่างเสียหาย
ย้าย FreeScout กลับไปที่ PHP 8.4 ระหว่างรอการอัปเดต PHP 8.4 ไม่ถือว่าฟังก์ชันเหล่านี้เลิกใช้ ดังนั้นโค้ดเดียวกันจึงทำงานได้ตามปกติที่นั่น สลับทั้งเว็บเซิร์ฟเวอร์และ PHP บนบรรทัดคำสั่ง จากนั้นรีสตาร์ท PHP-FPM เว็บเซิร์ฟเวอร์ และ worker ของคิว