XOOPS 2.7.0 การตรวจสอบความเข้ากันได้สำหรับคำแนะนำนี้

เอกสารนี้แสดงรายการการเปลี่ยนแปลงที่จำเป็นในพื้นที่เก็บข้อมูลนี้ ดังนั้นคู่มือการติดตั้งจึงตรงกับ XOOPS 2.7.0

พื้นฐานการตรวจสอบ:

• ที่เก็บคำแนะนำปัจจุบัน: L:\GitHub\XoopsDocs\xoops-installation-guide
• XOOPS 2.7.0 คอร์ ตรวจสอบแล้วที่: L:\GitHub\MAMBAX7\CORE\XoopsCore27
• ตรวจสอบแหล่งที่มาหลัก 2.7.0:
  • README.md
  • release_notes.txt
  • htdocs/install/language/english/welcome.php
  • htdocs/install/include/config.php
  • htdocs/install/include/page.php
  • htdocs/install/class/pathcontroller.php
  • htdocs/install/page_dbsettings.php
  • htdocs/install/page_configsave.php
  • htdocs/install/page_siteinit.php
  • htdocs/install/page_end.php
  • htdocs/mainfile.dist.php
  • upgrade/preflight.php
  • upgrade/README.md
  • upgrade/upd_2.5.11-to-2.7.0/index.php

ขอบเขต

ปัจจุบัน Repo นี้ประกอบด้วย:

• ไฟล์ Markdown ภาษาอังกฤษระดับรูทที่ใช้เป็นแนวทางหลัก
• สำเนา en/ บางส่วน
• de/ และ fr/ จองต้นไม้ด้วยทรัพย์สินของตนเองอย่างครบถ้วน

ไฟล์ระดับรูทจำเป็นต้องผ่านครั้งแรก หลังจากนั้น การเปลี่ยนแปลงที่เทียบเท่ากันจะต้องสะท้อนให้เห็นใน de/book/ และ fr/book/ ต้นไม้ en/ ยังต้องการการล้างข้อมูลด้วย เนื่องจากดูเหมือนว่าจะได้รับการดูแลเพียงบางส่วนเท่านั้น

1. การเปลี่ยนแปลงพื้นที่เก็บข้อมูลทั่วโลก

1.1 การกำหนดเวอร์ชันและข้อมูลเมตา

อัปเดตการอ้างอิงระดับคำแนะนำทั้งหมดจาก XOOPS 2.5.x เป็น XOOPS 2.7.0

ไฟล์ที่ได้รับผลกระทบ:

• README.md
• SUMMARY.md — การแสดงสดหลัก TOC สำหรับคำแนะนำรูท; ป้ายการนำทางและส่วนหัวของส่วนจะต้องตรงกับชื่อบทใหม่และส่วน Historical Upgrade Notes ที่เปลี่ยนชื่อ
• en/README.md
• en/SUMMARY.md
• de/README.md
• de/SUMMARY.md
• fr/README.md
• fr/SUMMARY.md
• chapter-2-introduction.md
• about-xoops-cms.md
• appendix-1-working-with-the-new-admin-gui-our-dashboard.md
• appendix-5-increase-security-of-your-xoops-installation.md
• de/book/*.md และ fr/book/*.md ที่แปลเป็นภาษาท้องถิ่น

การเปลี่ยนแปลงที่จำเป็น:

• เปลี่ยน for XOOPS 2.5.7.x เป็น for XOOPS 2.7.0
• อัปเดตปีลิขสิทธิ์จาก 2018 เป็น 2026
• แทนที่การอ้างอิง XOOPS 2.5.x และ 2.6.0 เก่า โดยที่อธิบายรุ่นปัจจุบัน
• แทนที่คำแนะนำการดาวน์โหลดในยุค SourceForge ด้วย GitHub Releases:
  • https://github.com/XOOPS/XoopsCore27/releases

1.2 รีเฟรชลิงก์

ไฟล์ about-xoops-cms.md และ 10aboutxoops.md ที่แปลเป็นภาษาท้องถิ่น ยังคงชี้ไปที่ตำแหน่ง GitHub 2.5.x และ 2.6.0 แบบเก่า ลิงก์เหล่านั้นจำเป็นต้องได้รับการอัปเดตเป็นที่ตั้งโปรเจ็กต์ 2.7.x ปัจจุบัน

1.3 รีเฟรชภาพหน้าจอ

ภาพหน้าจอทั้งหมดที่แสดงตัวติดตั้ง อัปเกรด UI แดชบอร์ดผู้ดูแลระบบ ตัวเลือกธีม ตัวเลือกโมดูล และหน้าจอหลังการติดตั้งล้าสมัย

ต้นไม้สินทรัพย์ได้รับผลกระทบ:

• .gitbook/assets/
• en/assets/
• de/assets/
• fr/assets/

นี่เป็นการรีเฟรชแบบเต็ม ไม่ใช่การรีเฟรชบางส่วน โปรแกรมติดตั้ง 2.7.0 ใช้เค้าโครงที่ใช้ Bootstrap ที่แตกต่างกันและโครงสร้างภาพที่แตกต่างกัน

2 บทที่ 2: บทนำ

ไฟล์:

• chapter-2-introduction.md

2.1 ความต้องการของระบบจะต้องถูกเขียนใหม่

บทปัจจุบันมีเพียง Apache, MySQL และ PHP XOOPS 2.7.0 มีขั้นต่ำที่ชัดเจน:

ส่วนประกอบ	2.7.0 ขั้นต่ำ	2.7.0 คำแนะนำ
PHP	8.2.0	8.4+
MySQL	5.7.8	8.4+
เว็บเซิร์ฟเวอร์	เซิร์ฟเวอร์ใดๆ ที่รองรับ จำเป็นต้องมี PHP	แนะนำ Apache หรือ Nginx

หมายเหตุที่จะเพิ่ม:

• IIS ยังคงอยู่ในรายการโปรแกรมติดตั้งมากที่สุดเท่าที่จะเป็นไปได้ แต่ Apache และ Nginx เป็นตัวอย่างที่แนะนำ
• บันทึกประจำรุ่นยังกล่าวถึงความเข้ากันได้ของ MySQL 9.0

2.2 เพิ่มรายการตรวจสอบส่วนขยายที่จำเป็นและแนะนำ PHP

ขณะนี้ตัวติดตั้ง 2.7.0 แยกข้อกำหนดที่ยากออกจากส่วนขยายที่แนะนำ

การตรวจสอบที่จำเป็นซึ่งแสดงโดยผู้ติดตั้ง:

• MySQLi
• เซสชัน
• PCRE
• ตัวกรอง
• file_uploads
• ข้อมูลไฟล์

ส่วนขยายที่แนะนำ:

• mbstring
• นานาชาติ
• ไอคอนวี -xml
• ซลิบ
• จีดี
• exif
• ขด

2.3 ลบคำแนะนำการตรวจสอบ

ขั้นตอนที่ 5 ปัจจุบันอธิบาย checksum.php และ checksum.mdi ไฟล์เหล่านั้นไม่ได้เป็นส่วนหนึ่งของ XOOPS 2.7.0

การดำเนินการ:

• ลบส่วนการตรวจสอบความถูกต้องทั้งหมด

2.4 อัปเดตแพ็คเกจและคำแนะนำในการอัปโหลด

เก็บ docs/, extras/, htdocs/, upgrade/ คำอธิบายโครงร่างแพ็กเกจ แต่อัปเดตการอัปโหลด และข้อความการเตรียมการเพื่อสะท้อนถึงความคาดหวังเส้นทางการเขียนในปัจจุบัน:- mainfile.php

• uploads/
• uploads/avatars/
• uploads/files/
• uploads/images/
• uploads/ranks/
• uploads/smilies/
• xoops_data/caches/
• xoops_data/caches/xoops_cache/
• xoops_data/caches/smarty_cache/
• xoops_data/caches/smarty_compile/
• xoops_data/configs/
• xoops_data/configs/captcha/
• xoops_data/configs/textsanitizer/
• xoops_data/data/
• xoops_data/protector/

คำแนะนำในปัจจุบันเข้าใจสิ่งนี้

2.5 แทนที่การแปล/ดาวน์โหลดภาษา SourceForge

ข้อความปัจจุบันยังคงบอกว่าให้เยี่ยมชม XOOPS บน SourceForge สำหรับแพ็คเกจภาษาอื่น จำเป็นต้องแทนที่ด้วยคำแนะนำการดาวน์โหลดโปรเจ็กต์/ชุมชนปัจจุบัน

3 บทที่ 3: การตรวจสอบการกำหนดค่าเซิร์ฟเวอร์

ไฟล์:

• chapter-3-server-configuration-check.md

การเปลี่ยนแปลงที่จำเป็น:

• เขียนคำอธิบายหน้าใหม่โดยใช้เค้าโครงสองบล็อกปัจจุบัน:
  • ข้อกำหนด
  • ส่วนขยายที่แนะนำ
• แทนที่ภาพหน้าจอเก่า
• บันทึกการตรวจสอบข้อกำหนดที่ระบุไว้ข้างต้นอย่างชัดเจน

4. บทที่ 4: ใช้เส้นทางที่ถูกต้อง

ไฟล์:

• chapter-4-take-the-right-path.md

การเปลี่ยนแปลงที่จำเป็น:

• เพิ่มฟิลด์ Cookie Domain ใหม่
• อัปเดตชื่อและคำอธิบายของช่องเส้นทางให้ตรงกับ 2.7.0:
  • XOOPS เส้นทางราก
  • XOOPS เส้นทางข้อมูล
  • XOOPS เส้นทางห้องสมุด
  • XOOPS URL
  • โดเมนคุกกี้
• เพิ่มหมายเหตุว่าตอนนี้การเปลี่ยนเส้นทางไลบรารีต้องใช้ตัวโหลดอัตโนมัติของ Composer ที่ถูกต้องที่ vendor/autoload.php

นี่คือการตรวจสอบความเข้ากันได้จริงในเวอร์ชัน 2.7.0 และควรได้รับการบันทึกไว้อย่างชัดเจน คู่มือปัจจุบันไม่ได้กล่าวถึง Composer เลย

5 บทที่ 5: การเชื่อมต่อฐานข้อมูล

ไฟล์:

• chapter-5-database-connections.md

การเปลี่ยนแปลงที่จำเป็น:

• เก็บข้อความว่ารองรับเฉพาะ MySQL เท่านั้น
• อัปเดตส่วนการกำหนดค่าฐานข้อมูลเพื่อให้สอดคล้องกับ:
  • ชุดอักขระเริ่มต้นคือ utf8mb4
  • การเลือกการจัดเรียงจะอัปเดตแบบไดนามิกเมื่อมีการเปลี่ยนแปลงชุดอักขระ
• แทนที่ภาพหน้าจอสำหรับทั้งการเชื่อมต่อฐานข้อมูลและหน้าการกำหนดค่า

ข้อความปัจจุบันที่บอกว่าชุดอักขระและการจัดเรียงไม่จำเป็นต้องให้ความสนใจนั้นอ่อนเกินไปสำหรับ 2.7.0 อย่างน้อยควรกล่าวถึงค่าเริ่มต้น utf8mb4 ใหม่ และตัวเลือกการจัดเรียงแบบไดนามิก

6 บทที่ 6: การกำหนดค่าระบบขั้นสุดท้าย

ไฟล์:

• chapter-6-final-system-configuration.md

6.1 ไฟล์การกำหนดค่าที่สร้างขึ้นมีการเปลี่ยนแปลง

คำแนะนำในปัจจุบันระบุว่าโปรแกรมติดตั้งเขียน mainfile.php และ secure.php

ใน 2.7.0 ยังติดตั้งไฟล์กำหนดค่าลงใน xoops_data/configs/ ซึ่งรวมถึง:

• xoopsconfig.php
• ไฟล์กำหนดค่า captcha
• ไฟล์กำหนดค่า textsanitizer

6.2 ไฟล์กำหนดค่าที่มีอยู่ใน xoops_data/configs/ จะไม่ถูกเขียนทับ

ลักษณะการทำงานที่ไม่เขียนทับนั้น กำหนดขอบเขต ไม่ใช่แบบสากล เส้นทางโค้ดที่แตกต่างกันสองเส้นทางใน page_configsave.php เขียนไฟล์การกำหนดค่า:

• writeConfigurationFile() (เรียกที่บรรทัด 59 และ 66) เสมอ จะสร้าง xoops_data/data/secure.php และ mainfile.php จากอินพุตวิซาร์ด ไม่มีการตรวจสอบการมีอยู่ สำเนาที่มีอยู่จะถูกแทนที่
• copyConfigDistFiles() (เรียกที่บรรทัด 62 ซึ่งกำหนดไว้ที่บรรทัด 317) คัดลอกเฉพาะไฟล์ xoops_data/configs/¤ (xoopsconfig.php, การกำหนดค่า captcha, การกำหนดค่า textsanitizer) หากปลายทางไม่มีอยู่แล้ว.

การเขียนบทใหม่ต้องสะท้อนพฤติกรรมทั้งสองอย่างชัดเจน:

• สำหรับ mainfile.php และ secure.php¤: เตือนว่าการแก้ไขไฟล์เหล่านี้ด้วยมือจะถูกเขียนทับเมื่อมีการเรียกใช้โปรแกรมติดตั้งอีกครั้ง
• สำหรับไฟล์ xoops_data/configs/: อธิบายว่าการปรับแต่งในเครื่องจะยังคงอยู่ตลอดการเรียกใช้ซ้ำและอัปเกรด และการเรียกคืนค่าเริ่มต้นที่จัดส่งจะต้องลบไฟล์และเรียกใช้ใหม่ (หรือการคัดลอก .dist.php ที่เกี่ยวข้องด้วยมือ)

อย่าสรุป “ไฟล์ที่มีอยู่จะถูกเก็บรักษาไว้” ในไฟล์กำหนดค่าที่โปรแกรมติดตั้งเขียนไว้ ซึ่งไม่ถูกต้องและจะทำให้ผู้ดูแลระบบเข้าใจผิดในการแก้ไข mainfile.php หรือ secure.php

6.3 HTTPS และการจัดการพร็อกซีแบบย้อนกลับมีการเปลี่ยนแปลง

ขณะนี้ mainfile.php ที่สร้างขึ้น รองรับการตรวจจับโปรโตคอลที่กว้างขึ้น รวมถึงส่วนหัว Reverse-proxy คู่มือควรกล่าวถึงสิ่งนี้ แทนที่จะบอกเป็นนัยเฉพาะการตรวจจับ http หรือ https โดยตรง

6.4 การนับโต๊ะผิด

บทปัจจุบันบอกว่าไซต์ใหม่สร้างตาราง 32

XOOPS 2.7.0 สร้างตาราง 33 ตารางที่หายไปคือ:

• tokens

การดำเนินการ:- อัปเดตการนับจาก 32 เป็น 33

• เพิ่ม tokens ในรายการตาราง

7 บทที่ 7: การตั้งค่าการดูแลระบบ

ไฟล์:

• chapter-7-administration-settings.md

7.1 คำอธิบายรหัสผ่าน UI ล้าสมัยแล้ว

ตัวติดตั้งยังคงมีการสร้างรหัสผ่าน แต่ตอนนี้ยังรวมถึง:

• เครื่องวัดความแรงของรหัสผ่านที่ใช้ zxcvbn
• ฉลากความแรงของการมองเห็น
• ตัวสร้าง 16 ตัวอักษรและขั้นตอนการคัดลอก

อัปเดตข้อความและภาพหน้าจอเพื่ออธิบายแผงรหัสผ่านปัจจุบัน

7.2 การตรวจสอบอีเมลมีผลบังคับใช้แล้ว

อีเมลของผู้ดูแลระบบได้รับการตรวจสอบด้วย FILTER_VALIDATE_EMAIL บทนี้ควรกล่าวถึงว่าค่าอีเมลที่ไม่ถูกต้องถูกปฏิเสธ

7.3 ส่วนคีย์ใบอนุญาตไม่ถูกต้อง

นี่คือหนึ่งในการแก้ไขข้อเท็จจริงที่สำคัญที่สุด

คู่มือปัจจุบันพูดว่า:

• มี License System Key
• มันถูกเก็บไว้ใน /include/license.php
• /include/license.php ต้องเขียนได้ระหว่างการติดตั้ง

นั่นไม่แม่นยำอีกต่อไป

จริงๆ แล้ว 2.7.0 ทำอะไรได้บ้าง:

• การติดตั้งเขียนข้อมูลใบอนุญาตไปที่ xoops_data/data/license.php
• htdocs/include/license.php ขณะนี้เป็นเพียง wrapper ที่เลิกใช้แล้วซึ่งโหลดไฟล์จาก XOOPS_VAR_PATH
• ข้อความเก่าเกี่ยวกับการทำให้ /include/license.php เขียนได้ ควรลบออก

การดำเนินการ:

• เขียนส่วนนี้ใหม่แทนที่จะลบออก
• อัปเดตเส้นทางจาก /include/license.php เป็น xoops_data/data/license.php

7.4 รายการธีมล้าสมัยแล้ว

คู่มือปัจจุบันยังคงอ้างอิงถึง Zetagenesis และชุดธีมยุค 2.5 ที่เก่ากว่า

ธีมที่มีอยู่ใน XOOPS 2.7.0:

• default
• xbootstrap
• xbootstrap5
• xswatch4
• xswatch5
• xtailwind
• xtailwind2

โปรดทราบ:

• xswatch4 เป็นธีมเริ่มต้นปัจจุบันที่แทรกโดยข้อมูลตัวติดตั้ง
• Zetagenesis ไม่ได้เป็นส่วนหนึ่งของรายการธีมที่บรรจุไว้อีกต่อไป

7.5 รายการโมดูลล้าสมัย

โมดูลที่มีอยู่ในแพ็คเกจ 2.7.0:

• system — ติดตั้งโดยอัตโนมัติระหว่างขั้นตอนการเติมตาราง / การแทรกข้อมูล แสดงอยู่เสมอ โดยจะไม่ปรากฏในเครื่องมือเลือกเลย
• debugbar — เลือกได้ในขั้นตอนการติดตั้ง
• pm — เลือกได้ในขั้นตอนการติดตั้ง
• profile — เลือกได้ในขั้นตอนการติดตั้ง
• protector — เลือกได้ในขั้นตอนการติดตั้ง

สิ่งสำคัญ: หน้าตัวติดตั้งโมดูล (htdocs/install/page_moduleinstaller.php) สร้างรายชื่อผู้สมัครโดยการวนซ้ำ XoopsLists::getModulesList() และ กรองสิ่งใดก็ตามที่มีอยู่แล้วในตารางโมดูล (บรรทัดที่ 95-102 รวบรวม $listed_mods; บรรทัด 116 ข้ามไดเรกทอรีใด ๆ ที่อยู่ในรายการนั้น) เนื่องจากมีการติดตั้ง system ก่อนขั้นตอนนี้ทำงาน จึงจะไม่ปรากฏเป็นช่องทำเครื่องหมาย

จำเป็นต้องเปลี่ยนแปลงคำแนะนำ:

• หยุดบอกว่ามีเพียงสามโมดูลที่รวมเข้าด้วยกัน
• อธิบายขั้นตอนการติดตั้งโดยแสดง โมดูลที่เลือกได้สี่โมดูล (debugbar, pm, profile, protector) ไม่ใช่ห้า
• เอกสาร system แยกกันเป็นโมดูลหลักที่ติดตั้งตลอดเวลาซึ่งไม่ปรากฏในเครื่องมือเลือก
• เพิ่ม debugbar ให้กับคำอธิบายโมดูลที่รวมมาให้เหมือนใหม่ใน 2.7.0
• โปรดทราบว่าตอนนี้การเลือกโมดูลเริ่มต้นของตัวติดตั้งว่างเปล่า มีโมดูลให้เลือก แต่ไม่ได้ตรวจสอบล่วงหน้าโดยการกำหนดค่าตัวติดตั้ง

8. บทที่ 8: พร้อมที่จะไป

ไฟล์:

• chapter-8-ready-to-go.md

8.1 ติดตั้งกระบวนการล้างข้อมูลจำเป็นต้องเขียนใหม่

คำแนะนำปัจจุบันระบุว่าโปรแกรมติดตั้งเปลี่ยนชื่อโฟลเดอร์การติดตั้งเป็นชื่อที่ไม่ซ้ำ

นั่นยังคงเป็นจริงอยู่ แต่กลไกเปลี่ยนไป:

• สคริปต์การล้างข้อมูลภายนอกถูกสร้างขึ้นในเว็บรูท
• หน้าสุดท้ายทริกเกอร์การล้างข้อมูลผ่าน AJAX
• โฟลเดอร์การติดตั้งเปลี่ยนชื่อเป็น install_remove_<unique suffix>
• ทางเลือกสำรองเป็น cleanup.php ยังคงมีอยู่

การดำเนินการ:

• อัปเดตคำอธิบาย
• รักษาคำแนะนำสำหรับผู้ใช้ให้เรียบง่าย: ลบไดเร็กทอรีการติดตั้งที่เปลี่ยนชื่อหลังการติดตั้ง

8.2 การอ้างอิงภาคผนวกแดชบอร์ดผู้ดูแลระบบล้าสมัย

บทที่ 8 ยังคงชี้ให้ผู้อ่านเห็นถึงประสบการณ์ผู้ดูแลระบบยุคออกซิเจนแบบเก่า ที่ต้องสอดคล้องกับธีมของผู้ดูแลระบบปัจจุบัน:

• default
• dark
• modern
• transition

8.3 คำแนะนำการแก้ไขเส้นทางหลังการติดตั้งจำเป็นต้องแก้ไขข้อความปัจจุบันบอกให้ผู้อ่านอัปเดต secure.php ด้วยคำจำกัดความเส้นทาง ใน 2.7.0 ค่าคงที่เส้นทางเหล่านั้นถูกกำหนดไว้ใน mainfile.php ในขณะที่ secure.php เก็บข้อมูลที่ปลอดภัย บล็อกตัวอย่างในบทนี้ควรได้รับการแก้ไขให้เหมาะสม

8.4 ควรเพิ่มการตั้งค่าการผลิต

คู่มือควรระบุอย่างชัดเจนถึงค่าเริ่มต้นที่ใช้งานจริงซึ่งปัจจุบันมีอยู่ใน mainfile.dist.php:

• XOOPS_DB_LEGACY_LOG ควรคงอยู่ false
• XOOPS_DEBUG ควรคงอยู่ false

9. บทที่ 9: อัปเกรดการติดตั้ง XOOPS ที่มีอยู่

ไฟล์:

• chapter-9-upgrade-existing-xoops-installation.md

บทนี้ต้องมีการเขียนใหม่ที่ใหญ่ที่สุด

9.1 เพิ่มขั้นตอนก่อนการบิน Smarty 4 ที่บังคับ

XOOPS 2.7.0 ขั้นตอนการอัปเกรดตอนนี้บังคับกระบวนการ preflight ก่อนที่การอัพเกรดจะเสร็จสิ้น

ขั้นตอนที่จำเป็นใหม่:

1. คัดลอกไดเร็กทอรี upgrade/ ไปยังรากของไซต์
2. เรียกใช้ /upgrade/preflight.php
3. สแกน /themes/ และ /modules/ เพื่อหาไวยากรณ์ Smarty แบบเก่า
4. ใช้โหมดการซ่อมแซมเสริมตามความเหมาะสม 5.วิ่งซ้ำจนสะอาด
5. ดำเนินการต่อใน /upgrade/

บทปัจจุบันไม่ได้กล่าวถึงสิ่งนี้เลย ซึ่งทำให้ไม่เข้ากันกับคำแนะนำ 2.7.0

9.2 แทนที่การเล่าเรื่องผสานยุค 2.5.2 ด้วยตนเอง

บทปัจจุบันยังคงอธิบายการอัพเกรดแบบแมนนวล 2.5.2 พร้อมการรวมเฟรมเวิร์ก บันทึกย่อของ AltSys และการปรับโครงสร้างไฟล์ที่จัดการด้วยมือ ซึ่งควรจะแทนที่ด้วยลำดับการอัพเกรด 2.7.x จริงจาก release_notes.txt และ upgrade/README.md

โครงร่างบทที่แนะนำ:

1. สำรองไฟล์และฐานข้อมูล
2. ปิดไซต์
3. คัดลอก htdocs/ บนรากที่มีชีวิต
4. คัดลอก htdocs/xoops_lib ลงในเส้นทางไลบรารีที่ใช้งานอยู่
5. คัดลอก htdocs/xoops_data ลงในเส้นทางข้อมูลที่ใช้งานอยู่
6. คัดลอก upgrade/ ไปที่รูทเว็บ
7. เรียกใช้ preflight.php
8. เรียกใช้ /upgrade/
9. แจ้งให้อัปเดตเสร็จสมบูรณ์
10. อัปเดตโมดูล system
11. อัปเดต pm, profile และ protector หากติดตั้งไว้
12. ลบ upgrade/
13. เปิดไซต์อีกครั้ง

9.3 เอกสารการเปลี่ยนแปลงการอัพเกรดจริง 2.7.0

ตัวอัปเดตสำหรับ 2.7.0 มีการเปลี่ยนแปลงที่เป็นรูปธรรมเป็นอย่างน้อย:

• สร้างตาราง tokens
• ขยาย bannerclient.passwd สำหรับแฮชรหัสผ่านสมัยใหม่
• เพิ่มการตั้งค่าการตั้งค่าคุกกี้เซสชัน
• ลบไดเร็กทอรีที่รวมกลุ่มที่ล้าสมัย

คู่มือนี้ไม่จำเป็นต้องเปิดเผยรายละเอียดการใช้งานทั้งหมด แต่ควรหยุดหมายความว่าการอัปเกรดเป็นเพียงการคัดลอกไฟล์และการอัพเดตโมดูลเท่านั้น

10. หน้าการอัปเกรดในอดีต

ไฟล์:

• upgrading-from-xoops-2.4.5-easy-way.md
• upgrading-from-xoops-2.0.-above-2.0.14-and-2.2..md
• upgrading-from-any-xoops-2.0.7-to-2.0.13.2.md
• upgrading-a-non-utf-8-site.md
• upgrading-xoopseditor-package.md

สถานะ: การตัดสินใจเชิงโครงสร้างได้รับการแก้ไขแล้ว — ราก SUMMARY.md ย้ายสิ่งเหล่านี้ไปยังส่วน หมายเหตุการอัปเกรดเชิงประวัติ โดยเฉพาะ และแต่ละไฟล์จะมีคำบรรยายภาพ “การอ้างอิงเชิงประวัติ” ที่ชี้ผู้อ่านไปยังบทที่ 9 สำหรับการอัปเกรด 2.7.0 พวกเขาไม่ใช่คำแนะนำการอัปเกรดชั้นหนึ่งอีกต่อไป

งานคงเหลือ(ความสม่ำเสมอเท่านั้น):

• ตรวจสอบให้แน่ใจว่า README.md (root) แสดงรายการเหล่านี้ภายใต้หัวข้อ “Historical Upgrade Notes” เดียวกัน ไม่ใช่ภายใต้ส่วนหัว “Upgrades” ทั่วไป
• จำลองการแยกแบบเดียวกันใน de/README.md, de/SUMMARY.md, fr/README.md, fr/SUMMARY.md และ en/SUMMARY.md.
• ตรวจสอบให้แน่ใจว่าหน้าการอัปเกรดในอดีตแต่ละหน้า (รูทและสำเนา de/book/upg*.md / fr/book/upg*.md ที่แปลแล้ว) มีคำบรรยายเนื้อหาเก่าที่ลิงก์กลับไปยังบทที่ 9

11. ภาคผนวก 1: ผู้ดูแลระบบ GUI

ไฟล์:

• appendix-1-working-with-the-new-admin-gui-our-dashboard.md

ภาคผนวกนี้เชื่อมโยงกับผู้ดูแลระบบ Oxygen GUI และจำเป็นต้องเขียนใหม่

การเปลี่ยนแปลงที่จำเป็น:

• แทนที่การอ้างอิงออกซิเจนทั้งหมด
• แทนที่ภาพหน้าจอไอคอน/เมนูเก่า
• บันทึกธีมผู้ดูแลระบบปัจจุบัน:
  • ค่าเริ่มต้น
  • มืด
  • ทันสมัย
  • การเปลี่ยนแปลง
• กล่าวถึงความสามารถของผู้ดูแลระบบปัจจุบัน 2.7.0 ที่ระบุในบันทึกประจำรุ่น:
  • ความสามารถในการโอเวอร์โหลดเทมเพลตในธีมผู้ดูแลระบบ
  • อัปเดตชุดธีมผู้ดูแลระบบ

12. ภาคผนวก 2: การอัปโหลด XOOPS ผ่าน FTP

ไฟล์:

• appendix-2-uploading-xoops-via-ftp.md

การเปลี่ยนแปลงที่จำเป็น:

• ลบสมมติฐานเฉพาะของ HostGator และเฉพาะ cPanel
• ปรับปรุงถ้อยคำในการอัพโหลดไฟล์ให้ทันสมัย
• โปรดทราบว่าขณะนี้ xoops_lib มีการพึ่งพาผู้แต่ง ดังนั้นการอัปโหลดจึงมีขนาดใหญ่ขึ้นและไม่ควรถูกตัดแบบเลือก## 13. ภาคผนวก 5: ความปลอดภัย

ไฟล์:

• appendix-5-increase-security-of-your-xoops-installation.md

การเปลี่ยนแปลงที่จำเป็น:

• ลบการสนทนา register_globals ออกทั้งหมด
• ลบภาษาตั๋วโฮสต์ที่ล้าสมัย
• แก้ไขข้อความการอนุญาตจาก 404 ถึง 0444 โดยที่ตั้งใจจะอ่านอย่างเดียว
• อัปเดตการสนทนา mainfile.php และ secure.php เพื่อให้ตรงกับเค้าโครง 2.7.0
• เพิ่มบริบทคงที่ที่เกี่ยวข้องกับความปลอดภัยของโดเมนคุกกี้ใหม่:
  • XOOPS_COOKIE_DOMAIN_USE_PSL
  • XOOPS_COOKIE_DOMAIN
• เพิ่มคำแนะนำการผลิตสำหรับ:
  • XOOPS_DB_LEGACY_LOG
  • XOOPS_DEBUG

14. ผลกระทบจากการบำรุงรักษาข้ามภาษา

หลังจากที่ไฟล์ภาษาอังกฤษระดับรากได้รับการแก้ไขแล้ว จำเป็นต้องมีการอัปเดตที่เทียบเท่าใน:

• de/book/
• fr/book/
• de/README.md
• fr/README.md
• de/SUMMARY.md
• fr/SUMMARY.md

ต้นไม้ en/ ยังต้องได้รับการตรวจสอบเนื่องจากมี README และชุดเนื้อหาแยกต่างหาก แต่ดูเหมือนว่าจะมีแผนภูมิ book/ บางส่วนเท่านั้น

15. ลำดับความสำคัญ

สำคัญก่อนที่จะเผยแพร่

1. อัปเดตการอ้างอิง repo/เวอร์ชันเป็น 2.7.0
2. เขียนบทที่ 9 ใหม่เกี่ยวกับโฟลว์การอัปเกรดจริงของ 2.7.0 และพรีไฟลต์ Smarty 4
3. อัปเดตความต้องการของระบบเป็น PHP 8.2+ และ MySQL 5.7.8+
4. แก้ไขเส้นทางไฟล์คีย์ลิขสิทธิ์บทที่ 7
5. แก้ไขสินค้าคงคลังของธีมและโมดูล
6. แก้ไขตารางบทที่ 6 ตั้งแต่ 32 ถึง 33

สำคัญเพื่อความถูกต้อง

7. เขียนคำแนะนำเส้นทางที่เขียนได้ใหม่
8. เพิ่มข้อกำหนดตัวโหลดอัตโนมัติของนักแต่งเพลงในการตั้งค่าเส้นทาง
9. อัปเดตคำแนะนำชุดอักขระฐานข้อมูลเป็น utf8mb4
10. แก้ไขคำแนะนำในการแก้ไขเส้นทางบทที่ 8 เพื่อให้ค่าคงที่ได้รับการบันทึกไว้ในไฟล์ที่ถูกต้อง
11. ลบคำแนะนำในการตรวจสอบ
12. ลบคำแนะนำ register_globals และคำแนะนำอื่นๆ PHP ออก

การล้างข้อมูลคุณภาพที่วางจำหน่าย

13. แทนที่ภาพหน้าจอตัวติดตั้งและผู้ดูแลระบบทั้งหมด
14. ย้ายหน้าการอัพเกรดในอดีตออกจากโฟลว์หลัก
15. ซิงค์สำเนาภาษาเยอรมันและฝรั่งเศสหลังจากแก้ไขภาษาอังกฤษแล้ว
16. ทำความสะอาดลิงก์เก่าและบรรทัด README ที่ซ้ำกัน