ตรวจความพร้อมของระบบ
หน้าตรวจความพร้อมและคำสั่ง 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 เว็บไซต์ใช้ HTTPS | APP_URL ไม่ได้ขึ้นต้นด้วย https:// |
| เข้ารหัส session | SESSION_ENCRYPT ไม่เปิด (แนะนำให้เปิดสำหรับโรงเรียนจริง) |
| เปิดให้ผู้ชมภายนอกเข้าถึง | SCHOOL_LOCAL_ONLY=true ทำให้ใช้ได้เฉพาะเครื่องนี้ |
| cookie ปลอดภัย (Secure/HttpOnly) | ยังไม่ Secure (ตั้ง SESSION_SECURE_COOKIE=true เมื่อใช้ HTTPS) หรือไม่ HttpOnly |
| สำรอง/กู้คืนได้ (ZipArchive) | ไม่มีส่วนขยาย PHP zip |
| พื้นที่ไฟล์ของโรงเรียน | ใช้โควตาคลังสื่อถึง 90% ขึ้นไป |
| โมดูลที่ถูกปิดเพราะเงื่อนไขไม่ครบ | มีโมดูลที่ระบบปิดเอง (ไม่นับโมดูลทดลองและโมดูลที่ถูกสั่งปิดไว้) ข้อความบอกเหตุผลของแต่ละโมดูล |
| เขตเวลา Asia/Bangkok | config/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 เปิดอยู่ บอกสามกรณี
- เว็บตรวจไฟล์ที่เปลี่ยนเอง (
opcache.validate_timestampsเปิด) ผ่าน - ไม่ตรวจไฟล์ที่เปลี่ยน (
opcache.validate_timestamps=0) แต่ตัวอัปเดตล้าง OPcache ของเว็บให้เองได้ ผ่าน - ไม่ตรวจไฟล์ที่เปลี่ยนและโฮสต์ไม่ให้เว็บล้าง OPcache เอง (
opcache.restrict_api) เตือน หลังอัปเดตทุกครั้งต้อง restart PHP จึงจะได้โค้ดชุดใหม่
ดูเพิ่มที่แก้ปัญหาที่พบบ่อย และอัปเดตสาน
พบข้อผิดพลาดหรืออยากให้เพิ่มเนื้อหา แจ้งได้ที่ แบบฟอร์มติดต่อ