แก้ไขข้อความเตือน “PHP OPcache ไม่ได้ถูกกำหนดค่าอย่างถูกต้อง” บน Nextcloud

หาก Nextcloud แจ้งว่า“PHP OPcache ไม่ได้รับการกำหนดค่าอย่างถูกต้อง”วิธีแก้ไขที่ถูกต้องไม่ใช่การคัดลอกโค้ดการตั้งค่าขนาดใหญ่จากกระทู้เก่าในฟอรัม ขั้นแรกให้ระบุว่าข้อจำกัดหรือการตั้งค่า OPcache ใดที่ Nextcloud ไม่พอใจ จากนั้นจึงเปลี่ยนการกำหนดค่า PHP ที่เว็บเซิร์ฟเวอร์ของคุณใช้งานจริง

ในเอกสารการดูแลระบบ Nextcloud 35 ฉบับปัจจุบัน OPcache ถูกมองว่าเป็นเลเยอร์ประสิทธิภาพ PHP ที่สำคัญ Nextcloud ระบุว่าแผงควบคุมผู้ดูแลระบบจะแสดงคำเตือนที่เกี่ยวข้องเมื่อขนาดของ OPcache เกิน 90% ของความจุที่จัดสรรไว้ นอกจากนี้ยังกำหนดให้ต้องเก็บรักษาความคิดเห็นในโค้ดที่แคชไว้ด้วย เอกสารคู่มือของ PHP เองได้บันทึกคำสั่งที่เกี่ยวข้องและค่าเริ่มต้นไว้ ข้อเท็จจริงเหล่านี้ช่วยให้คุณปรับแต่ง OPcache ได้อย่างปลอดภัยยิ่งขึ้น: เพิ่มเฉพาะทรัพยากรที่จำกัด รักษาพฤติกรรมที่จำเป็นให้เปิดใช้งานอยู่ และหลีกเลี่ยงการเปลี่ยนแปลงที่ทำให้การอัปเกรดซับซ้อนขึ้น เว้นแต่คุณจะมีเหตุผลที่สมควร

คำเตือน Nextcloud OPcache โดยทั่วไปหมายความว่าอย่างไร

OPcache จะจัดเก็บไบต์โค้ด PHP ที่คอมไพล์แล้วไว้ในหน่วยความจำที่ใช้ร่วมกัน ทำให้ PHP ไม่จำเป็นต้องแยกวิเคราะห์และคอมไพล์ไฟล์แอปพลิเคชันเดียวกันซ้ำทุกครั้งที่มีการร้องขอ Nextcloud อธิบายว่านี่เป็นคุณสมบัติที่ช่วยเพิ่มประสิทธิภาพ และ PHP ได้รวม Zend OPcache ไว้ในส่วนหลักตั้งแต่ PHP 5.5 แล้ว

คำเตือนนี้อาจปรากฏขึ้นได้จากหลายสาเหตุ สาเหตุที่พบบ่อยที่สุดคือ ความจุของ OPcache ใกล้เต็ม OPcache ถูกปิดใช้งานสำหรับเว็บ SAPI หรือพฤติกรรมที่จำเป็น เช่น การเก็บรักษาความคิดเห็น ได้ถูกเปลี่ยนแปลง คู่มือการปรับแต่งปัจจุบันของ Nextcloud ระบุว่า คำเตือนเรื่องขนาดจะแสดงขึ้นเมื่อขีดจำกัดขนาดของ OPcache เกิน 90% ของการจัดสรร และระบุไว้อย่างชัดเจนว่าต้องopcache.save_comments = 1.

เอกสารอ้างอิงอย่างเป็นทางการ: การปรับแต่งเซิร์ฟเวอร์ Nextcloud และคำแนะนำเกี่ยวกับ OPcache , หมายเหตุเกี่ยวกับการกำหนดค่า PHP ของ Nextcloudและการกำหนดค่ารันไทม์ PHP OPcache

เลือกวิธีแก้ไขตามคำเตือน ไม่ใช่ใช้วิธีบล็อกแบบเดียวใช้ได้กับทุกกรณี

ปัจจุบัน PHP กำหนดค่าเริ่มต้นไว้ที่ 128 MB สำหรับopcache.memory_consumption, 8 MB สำหรับopcache.interned_strings_buffer, และ 10,000 opcache.max_accelerated_filesMB สำหรับ ค่าเริ่มต้นเหล่านี้เป็นเพียงจุดอ้างอิง ไม่ใช่เป้าหมายสากลสำหรับ Nextcloud เซิร์ฟเวอร์ส่วนตัวขนาดเล็กอาจใช้งานได้ใกล้เคียงกับค่าเริ่มต้นเหล่านี้ ในขณะที่การติดตั้งขนาดใหญ่ที่มีแอปพลิเคชันจำนวนมากอาจต้องการพื้นที่ว่างมากกว่านี้

ขั้นตอนที่ 1: ตรวจสอบว่า Nextcloud ใช้การตั้งค่า PHP แบบใด

นี่คือขั้นตอนที่ช่วยป้องกันการแก้ไขปัญหาที่ล้มเหลวหลายครั้ง เอกสารของ Nextcloud ระบุว่าเว็บเซิร์ฟเวอร์และ PHP ที่ทำงานผ่านบรรทัดคำสั่งสามารถโหลดไฟล์การกำหนดค่าที่แตกต่างกันได้ ในระบบแบบ Debian และ Ubuntu เส้นทางทั่วไปได้แก่/etc/php/<version>/fpm/php.ini, /etc/php/<version>/apache2/php.ini, และ/etc/php/<version>/cli/php.ini.

เรียกใช้คำสั่งphp --iniเพื่อดูการกำหนดค่า CLI แต่โปรดอย่าคิดว่ามันเป็นไฟล์เดียวกันกับที่ PHP-FPM หรือ Apache ใช้ สำหรับ SAPI บนเว็บ ให้ใช้phpinfo()หน้าเว็บชั่วคราวเฉพาะในกรณีที่คุณสามารถปกป้องและลบออกได้ทันที หรือตรวจสอบการกำหนดค่าพูล/บริการ PHP-FPM และไฟล์โมดูลเฉพาะการแจกจ่ายของคุณ

คำแนะนำ:หาก Nextcloud ทำงานอยู่เบื้องหลัง Nginx หรือ Apache ที่ใช้ PHP-FPM ให้แก้ไขการตั้งค่า OPcache ของ FPM หาก Apache ใช้ mod_php ให้แก้ไขการตั้งค่า PHP ของ Apache รักษาการตั้งค่า CLI ให้สอดคล้องกันเมื่องานเบื้องหลังต้องการพฤติกรรมเดียวกัน แต่โปรดจำไว้ว่าคำเตือนในเบราว์เซอร์นั้นเกิดจากเส้นทางการร้องขอเว็บ

ขั้นตอนที่ 2: แก้ไขชุดคำสั่ง OPcache ที่เล็กที่สุดที่สามารถแก้ปัญหาได้

ตัวอย่างแบบอนุรักษ์นิยมสำหรับเซิร์ฟเวอร์ขนาดเล็กแสดงไว้ด้านล่าง โปรดพิจารณาค่าตัวเลขเหล่านี้เป็นเพียงจุดเริ่มต้น ไม่ใช่การรับประกัน:

[opcache]
opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=10000
opcache.save_comments=1

หาก Nextcloud แจ้งว่าหน่วยความจำ OPcache ใกล้เต็ม การเพิ่มขนาดจาก 128 MB เป็น 256 MB อาจเป็นการเปลี่ยนแปลงที่เหมาะสมหากเซิร์ฟเวอร์มี RAM ว่างเพียงพอ แต่หากคำเตือนชี้ไปที่สตริงที่จัดเก็บไว้ภายในหรือสคริปต์ที่แคชไว้ ให้เพิ่มขีดจำกัดนั้นแทนที่จะเพิ่มหน่วยความจำเพียงอย่างเดียว ใน VPS ที่มีหน่วยความจำจำกัด การเพิ่มขนาดเป็น 512 MB โดยตรงอาจลด RAM ที่ใช้ได้สำหรับ PHP-FPM worker, ฐานข้อมูล, Redis และระบบปฏิบัติการ

แล้วการตั้งค่าการตรวจสอบความถูกต้องซ้ำล่ะ?

คู่มือการปรับแต่งปัจจุบันของ Nextcloud ระบุว่า PHP จะตรวจสอบสคริปต์ที่แคชไว้เพื่อหาการเปลี่ยนแปลงทุกๆ สองวินาทีโดยค่าเริ่มต้น และไม่มีคำแนะนำให้เปลี่ยนค่าเริ่มต้นนี้สำหรับทุกคน การเพิ่มค่านี้opcache.revalidate_freqสามารถลดการตรวจสอบระบบไฟล์ได้ แต่ข้อเสียคือการทำงานconfig.phpจะช้าลง การอัปเกรดแอปพลิเคชันและการแก้ไขอาจใช้เวลานานขึ้นจึงจะแสดงผล การปิดใช้งานการตรวจสอบเวลาโดยสิ้นเชิงนั้นรุนแรงกว่าและอาจทำให้โค้ดเก่าทำงานอยู่จนกว่าจะล้าง OPcache ด้วยตนเองหรือรีสตาร์ท PHP

สำหรับผู้ดูแลระบบส่วนใหญ่ที่พยายามเพียงแค่ล้างคำเตือน ให้ปล่อยไว้opcache.validate_timestampsตามopcache.revalidate_freqการทำงานปกติ เว้นแต่คุณจะเข้าใจขั้นตอนการติดตั้งใช้งาน Nextcloud เตือนโดยเฉพาะว่าพฤติกรรมที่ผิดปกติหลังการอัปเกรดอาจเกิดจากโค้ดที่แคชไว้ล้าสมัยเมื่อมีการเปลี่ยนแปลงการตรวจสอบความถูกต้อง

ขั้นตอนที่ 3: รีสตาร์ทบริการ PHP ที่ถูกต้อง

หลังจากแก้ไขไฟล์ INI แล้ว ให้รีสตาร์ทหรือรีโหลดกระบวนการ PHP ที่ให้บริการ Nextcloud ตัวอย่างทั่วไปคือsystemctl restart php8.2-fpmสำหรับ PHP-FPM หรือการรีสตาร์ท/รีโหลด Apache เมื่อใช้ mod_php แทนที่เวอร์ชันและชื่อบริการด้วยเวอร์ชันและชื่อบริการที่ระบบของคุณใช้งานอยู่จริง

เรื่องนี้ยิ่งสำคัญมากขึ้นหากคุณได้เปลี่ยนแปลงพฤติกรรมการตรวจสอบความถูกต้อง การรีสตาร์ทบริการที่ถูกต้องจะรับประกันว่าการกำหนดค่า OPcache ใหม่จะถูกโหลดและขจัดความคลุมเครือเกี่ยวกับไบต์โค้ดที่ล้าสมัย

ขั้นตอนที่ 4: ตรวจสอบค่าต่างๆ แต่ตรวจสอบ SAPI บนเว็บด้วย

การตรวจสอบผ่านบรรทัดคำสั่งที่มีประโยชน์ ได้แก่:

php --ini
php -i | grep -i opcache

คำสั่งเหล่านี้สามารถยืนยันได้ว่า PHP รู้จักคำสั่งเหล่านั้น แต่เป็นการพิสูจน์เฉพาะการกำหนดค่า CLI เท่านั้น หากคำเตือนของ Nextcloud ยังคงอยู่ ให้เปรียบเทียบการกำหนดค่าที่โหลดจาก SAPI บนเว็บกับผลลัพธ์จาก CLI ซึ่งมีความสำคัญอย่างยิ่งในระบบที่เก็บรักษา โครงสร้างไฟล์ cli, fpm, และapache2INI แยกต่างหาก

ขั้นตอนที่ 5: ตรวจสอบการตั้งค่าการจัดการ > ภาพรวม อีกครั้ง

หลังจากรีสตาร์ทบริการ PHP แล้ว โปรดรีเฟรชหน้าภาพรวมการดูแลระบบ Nextcloud หากข้อความเตือนหายไป แสดงว่า SAPI ที่ถูกต้องกำลังอ่านการกำหนดค่า และค่าที่รายงานจะไม่เกินเกณฑ์อีกต่อไป

หากปัญหายังคงอยู่ อย่าเพิ่มค่าแบบสุ่มต่อไป ตรวจสอบสี่สิ่งต่อไปนี้ตามลำดับ: คุณแก้ไขไฟล์ INI ที่ถูกต้องหรือไม่ ไฟล์ INI อื่นที่โหลดในภายหลังเขียนทับการตั้งค่าของคุณหรือไม่ บริการ PHP ที่เกี่ยวข้องได้รับการรีสตาร์ทหรือไม่ และคำเตือนระบุชื่อทรัพยากร OPcache ที่แตกต่างจากที่คุณเพิ่มค่าหรือไม่

คุณควรจัดสรรหน่วยความจำ OPcache เท่าไหร่?

ไม่มีค่าที่ดีที่สุดเพียงค่าเดียว เป้าหมายที่เหมาะสมคือการมีพื้นที่เหลือเฟือเพียงพอ เพื่อไม่ให้แคชใกล้ถึงขีดจำกัดอยู่ตลอดเวลา โดยไม่ทำให้ส่วนอื่นๆ ของระบบขาดแคลนทรัพยากร สำหรับ VPS ขนาดเล็ก ควรเริ่มต้นอย่างระมัดระวังและตรวจสอบแรงดันหน่วยความจำ สำหรับอินสแตนซ์ที่มีแอปพลิเคชันจำนวนมากหรือโค้ด PHP ขนาดใหญ่ อาจเหมาะสมที่จะใช้หน่วยความจำ 256 MB หรือมากกว่านั้น เมื่อการใช้งาน OPcache จริงแสดงให้เห็นว่า 128 MB ไม่เพียงพอ สำหรับเซิร์ฟเวอร์ขนาดใหญ่ ควรพิจารณาขนาดหน่วยความจำร่วมกับจำนวนเวิร์กเกอร์ของ PHP-FPM และบริการที่ใช้ร่วมกันอื่นๆ

การเปรียบเทียบในทางปฏิบัตินั้นง่ายมาก: หน่วยความจำ OPcache ที่มากขึ้นจะช่วยลดการล้างแคชและการคอมไพล์ใหม่ แต่หน่วยความจำ OPcache ที่น้อยลงจะทำให้มี RAM มากขึ้นสำหรับ PHP ที่ทำงานพร้อมกันและฐานข้อมูล เลือกตามการใช้งานที่วัดได้และคำเตือนที่ Nextcloud รายงาน ไม่ใช่ตามจำนวนสูงสุดที่เซิร์ฟเวอร์ของคุณสามารถรองรับได้

ข้อผิดพลาดทั่วไปที่ทำให้คำเตือนยังคงปรากฏอยู่

• การแก้ไข PHP ผ่าน CLI เท่านั้น:เบราว์เซอร์ยังคงใช้ PHP-FPM หรือ mod_php อยู่
• การเพิ่มขีดจำกัดผิดจุด: การเพิ่มหน่วยความจำไม่ได้ช่วยแก้ปัญหาตารางไฟล์เร่งความเร็วที่เต็มแล้ว
• หากลืมรีสตาร์ทกระบวนการ PHP ที่กำลังทำงานอยู่อาจยังคงใช้ค่า INI เก่าอยู่
• การปิดใช้งานopcache.save_comments: Nextcloud ต้องการให้เก็บรักษาความคิดเห็นไว้
• การคัดลอกโค้ดการปรับแต่งที่ล้าสมัย:คู่มือเก่าๆ อาจแนะนำการตั้งค่าการตรวจสอบความถูกต้องที่เข้มงวดเกินไป ซึ่งอาจทำให้เกิดปัญหาในการอัปเกรด

วิธีการที่แนะนำตามประเภทของเซิร์ฟเวอร์

เซิร์ฟเวอร์ Nextcloud ส่วนตัวขนาดเล็ก:คงค่าเริ่มต้นของการตรวจสอบความถูกต้องไว้ เก็บรักษาความคิดเห็น และเพิ่มขีดจำกัดเฉพาะส่วนที่เกินเกณฑ์ที่กำหนดไว้เท่านั้น วิธีนี้ช่วยลดการใช้ RAM และปัญหาที่ไม่คาดคิดในการใช้งาน

เซิร์ฟเวอร์ที่มีผู้ใช้งานหลายคน:ตรวจสอบการใช้ OPcache และเพิ่มพื้นที่ว่างให้มากขึ้นเมื่อคำเตือนของผู้ดูแลระบบบ่งชี้ว่ามีการใช้งานมากเกินไป ประสานการใช้หน่วยความจำ OPcache กับขนาดของเวิร์กเกอร์ PHP-FPM เพื่อให้การปรับแต่งเพียงอย่างเดียวไม่ก่อให้เกิดการสลับหน่วยความจำทั่วทั้งระบบ

การจัดการโฮสติ้งหรืออิมเมจคอนเทนเนอร์:ขั้นแรกให้ตรวจสอบว่าต้องการแก้ไขการตั้งค่า PHP ที่ใด การแก้ไขไฟล์ภายในคอนเทนเนอร์ชั่วคราวอาจหายไปหลังจากการปรับใช้ใหม่ ในขณะที่ผู้ให้บริการอาจเปิดเผยค่า INI แบบกำหนดเองผ่านแผงควบคุมหรือการกำหนดค่าสภาพแวดล้อม

การตรวจสอบครั้งสุดท้าย

วิธีแก้ไขที่ถูกต้องประกอบด้วยสามส่วน: กระบวนการ PHP บนเว็บของ Nextcloud เปิดใช้งาน OPcache แล้ว พฤติกรรมที่จำเป็น เช่น การทำงานต่างๆopcache.save_comments=1ยังคงเหมือนเดิม และทรัพยากร OPcache เฉพาะที่ใกล้เต็มความจุแล้ว มีพื้นที่ว่างเหลือพอใช้ เมื่อเงื่อนไขเหล่านี้เป็นจริงและ PHP ถูกโหลดใหม่แล้ว คำเตือนควรหายไปโดยไม่ต้องใช้การจัดสรรหน่วยความจำมากเกินไปหรือการเปลี่ยนแปลงการตรวจสอบแคชที่มีความเสี่ยง