สารบัญคู่มือ

ตรวจความพร้อมของระบบ

ใช้กับสานรุ่น 0.7.0 · ตรวจทานล่าสุด

หน้าตรวจความพร้อมและคำสั่ง school:doctor ตรวจการตั้งค่าของเครื่องที่ติดตั้งอยู่โดยไม่แสดงค่าลับ ใช้ตรวจหลังติดตั้ง หลังอัปเดต และเมื่อสงสัยว่าระบบทำงานไม่ครบ

เปิดดูอย่างไร

  • หลังบ้าน หน้า /cms#deployment
  • บรรทัดคำสั่ง php artisan school:doctor (ใส่ --json เพื่อได้ผลเป็น JSON)

คำสั่งพิมพ์หนึ่งบรรทัดต่อหนึ่งรายการ ขึ้นต้นด้วย [OK] [WARN] หรือ [ERR] ท้ายสุดสรุปว่า "ผ่าน เตือน ผิดพลาด" อย่างละกี่รายการ

ระดับความหมาย
[OK]ผ่าน
[WARN]คำเตือน เป็นคำแนะนำ ไม่ขวางการอัปเดต
[ERR]ผิดพลาด ต้องแก้ก่อนอัปเดตระบบ ตัวอัปเดตไม่ทำงานเมื่อมีรายการ [ERR]

รหัสที่คำสั่งคืน 0 เมื่อผ่านทุกรายการ 1 เมื่อมีเฉพาะคำเตือน และ 2 เมื่อมีอย่างน้อยหนึ่ง [ERR]

ผลนี้เป็นการตรวจทางเทคนิคของเครื่องปัจจุบัน ต้องมีการสำรองและกู้คืนที่ตรวจแล้ว และโรงเรียนตรวจรับก่อนใช้งานจริง

ข้อที่ทำให้เป็น [ERR] เมื่อไม่ผ่าน

รายการตรวจอะไร
PHP ที่รองรับPHP ต้องเป็น 8.4.1 ขึ้นไป
ส่วนขยาย PHPต้องมี ctype, curl, dom, fileinfo, intl, mbstring, openssl, pdo, sodium, tokenizer, xml, zip, pdo_mysql (เมื่อใช้ MySQL หรือ MariaDB หรือเป็นระบบใช้งานจริง) และ gd หรือ imagick อย่างใดอย่างหนึ่ง
เชื่อมต่อฐานข้อมูลเชื่อมต่อฐานข้อมูลได้
โครงสร้างฐานข้อมูลไม่มี migration ค้าง (ของแกนระบบและโมดูลที่เปิดอยู่)
application key ใช้เข้ารหัสได้จริงAPP_KEY ตั้งไว้และเข้ารหัสแล้วถอดรหัสกลับได้ (ไม่แสดงค่า key)
เขียนพื้นที่จัดเก็บได้เขียน storage/app/private, storage/framework/cache, storage/framework/sessions, storage/framework/views, storage/logs และ bootstrap/cache ได้
โมดูลที่ติดตั้งไฟล์ module.json ของทุกโมดูลถูกต้อง

สองรายการต่อไปนี้เป็น [ERR] เฉพาะบางกรณี

  • ปิด debug สำหรับเผยแพร่ เป็น [ERR] เมื่อ APP_DEBUG เปิดอยู่ในระบบใช้งานจริง (production) ถ้าไม่ใช่ระบบใช้งานจริงเป็น [WARN]
  • พื้นที่ดิสก์สำหรับอัปเดต เป็น [ERR] เมื่อตรวจร่วมกับแพ็กเกจที่กำลังจะติดตั้งและพื้นที่ว่างไม่พอ เกณฑ์คือพื้นที่ว่างอย่างน้อย 2 เท่าของ (ขนาดแพ็กเกจ รวมกับขนาดไฟล์สำรองล่าสุด) ถ้าตรวจโดยไม่มีแพ็กเกจเป็น [WARN]

ข้อที่เป็นคำเตือน [WARN]

รายการเตือนเมื่อ
รุ่นฐานข้อมูลต่ำกว่า MariaDB 10.6 หรือ MySQL 8.0 หรืออ่านรุ่นไม่ได้
คุกกี้เซสชันผูกกับโฮสต์เดียว (SESSION_DOMAIN)SESSION_DOMAIN ขึ้นต้นด้วยจุด ซึ่งส่งคุกกี้ไปถึงโฮสต์หน้าบ้านด้วย ควรเว้นว่างเมื่อแยกหน้าบ้านกับระบบภายใน
ปิดบัญชีสาธิตตัวแปร SCHOOL_DEMO ยังเปิดอยู่
URL เว็บไซต์ใช้ HTTPSAPP_URL ไม่ได้ขึ้นต้นด้วย https://
เข้ารหัส sessionSESSION_ENCRYPT ไม่เปิด (แนะนำให้เปิดสำหรับโรงเรียนจริง)
เปิดให้ผู้ชมภายนอกเข้าถึงSCHOOL_LOCAL_ONLY=true ทำให้ใช้ได้เฉพาะเครื่องนี้
cookie ปลอดภัย (Secure/HttpOnly)ยังไม่ Secure (ตั้ง SESSION_SECURE_COOKIE=true เมื่อใช้ HTTPS) หรือไม่ HttpOnly
สำรอง/กู้คืนได้ (ZipArchive)ไม่มีส่วนขยาย PHP zip
พื้นที่ไฟล์ของโรงเรียนใช้โควตาคลังสื่อถึง 90% ขึ้นไป
โมดูลที่ถูกปิดเพราะเงื่อนไขไม่ครบมีโมดูลที่ระบบปิดเอง (ไม่นับโมดูลทดลองและโมดูลที่ถูกสั่งปิดไว้) ข้อความบอกเหตุผลของแต่ละโมดูล
เขตเวลา Asia/Bangkokconfig/app.php ตั้งเขตเวลาเป็นอย่างอื่น (เขตเวลากำหนดในไฟล์นั้น ไม่มีตัวแปร .env)
cron (schedule:run) ทำงานไม่พบสัญญาณของ cron ภายใน 10 นาที ตั้ง schedule:run ทุกนาที
คิวงานมีงานล้มเหลว หรือมีงานค้างเกิน 1 ชั่วโมง (แสดงเมื่อมีตารางคิวงาน)
OPcache หลังอัปเดตดูหัวข้อถัดไป

รายการต่อไปนี้ตรวจเฉพาะระบบที่ให้เจ้าหน้าที่ใช้งาน (ระบบภายในหรือระบบรวม) ไม่ตรวจที่หน้าบ้าน

รายการเตือนเมื่อ
ตัวส่งเมลเป็น SMTPในระบบใช้งานจริง ตัวส่งเมลไม่ใช่ SMTP (รวม Gmail)
ส่งอีเมลได้ยังไม่ได้ทดสอบส่ง หรือการทดสอบล่าสุดไม่ได้รับการยอมรับ ตั้งค่าที่ /cms#mail
บัญชีผู้ดูแลจริงไม่มีบัญชีผู้ดูแลที่เปิดใช้งาน
ผู้ดูแลเปิดยืนยันสองขั้นตอนมีผู้ดูแลที่ยังไม่เปิดยืนยันสองขั้นตอน (ตั้งที่ บัญชีของฉัน)
ไฟล์สำรองล่าสุดไม่มีไฟล์ใน storage/app/private/backups หรือไฟล์ล่าสุดเก่ากว่า 3 วัน
งานเผยแพร่ตามเวลาไม่พบการทำงานของงานเผยแพร่ภายใน 5 นาที
ระบบทดลอง (ข้อมูลสมมติ) และไฟล์รายการบัญชีทดลองระบบนี้เป็นระบบทดลอง และไฟล์ demo-accounts.txt ยังไม่ถูกลบ ดูทดลองใช้งานสาน

ถ้าติดตั้งแบบแยกสองฝั่ง การตรวจความพร้อมมีรายการเพิ่มเกี่ยวกับการจับคู่ การส่งและดึงข้อมูลล่าสุด ซองข้อความ ลายเซ็นที่ถูกปฏิเสธ และไฟล์กุญแจ

รายการ OPcache

รายการนี้ปรากฏเมื่อดูผ่านเว็บ (ไม่ปรากฏเมื่อสั่ง school:doctor จากบรรทัดคำสั่ง เพราะค่าของบรรทัดคำสั่งไม่ใช่ค่าของเว็บ) และเมื่อ OPcache เปิดอยู่ บอกสามกรณี

  1. เว็บตรวจไฟล์ที่เปลี่ยนเอง (opcache.validate_timestamps เปิด) ผ่าน
  2. ไม่ตรวจไฟล์ที่เปลี่ยน (opcache.validate_timestamps=0) แต่ตัวอัปเดตล้าง OPcache ของเว็บให้เองได้ ผ่าน
  3. ไม่ตรวจไฟล์ที่เปลี่ยนและโฮสต์ไม่ให้เว็บล้าง OPcache เอง (opcache.restrict_api) เตือน หลังอัปเดตทุกครั้งต้อง restart PHP จึงจะได้โค้ดชุดใหม่

ดูเพิ่มที่แก้ปัญหาที่พบบ่อย และอัปเดตสาน

พบข้อผิดพลาดหรืออยากให้เพิ่มเนื้อหา แจ้งได้ที่ แบบฟอร์มติดต่อ