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

แก้ปัญหาที่พบบ่อย

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

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

ตอนติดตั้ง

อาการตรวจและแก้
ตัวติดตั้งแจ้งล็อก พบ .env หรือ installed marker จากเว็บเดิมระบบไม่ฝืนลบ เปิดหลังบ้านเดิม หรือใช้โฟลเดอร์และฐานข้อมูลใหม่สำหรับทดลอง
ฐานข้อมูลไม่ว่างตรวจว่ากรอกฐานใหม่จริง และไม่มีตาราง WordPress หรือของโครงการอื่น ตัวติดตั้งไม่ลบทับ
เชื่อมฐานข้อมูลไม่ได้ตรวจ host, port, prefix ของชื่อฐานและผู้ใช้ที่ hosting เติมให้ ทดสอบสิทธิ์เฉพาะฐานนั้น และไม่ส่งรหัสผ่านใน screenshot สาธารณะ
สร้าง owner-token หรือ .env ไม่ได้แก้ ownership และ permission ของ website account ให้เขียน storage/ และ bootstrap/cache/ ได้ ไม่ใช้ chmod 777
419session หรือ CSRF หมดอายุ โหลดหน้าตัวติดตั้งใหม่และกรอกรหัสเจ้าของอีกครั้ง
รูปข้อมูลตัวอย่างไม่ครบตรวจ resources/install/demo/media และ manifest จากแพ็กเกจเดิม ห้ามแก้ค่า hash เพื่อข้ามไฟล์
ขัดข้องระหว่างติดตั้งกลับหน้าเดิมด้วยรหัสเจ้าของและฐานข้อมูลเป้าหมายเดิม ต้องใช้บัญชี รหัสผ่าน และโหมดเดิม ถ้า migration ค้างกลางการสร้างตาราง ให้เริ่มด้วยฐานใหม่และซอร์สแยก ไม่ reset ฐานเดิม

หลังติดตั้ง

อาการตรวจและแก้
ทุกหน้าขึ้น 404ตรวจว่า DocumentRoot ชี้ public/ ตรวจ mod_rewrite และ AllowOverride (Apache) หรือ try_files (nginx) ว่าไม่ชี้ไปที่ root ของแอป
ติดตั้งสำเร็จแต่เข้าสู่ระบบแล้วไม่อยู่ตรวจ APP_URL, HTTPS, SESSION_SECURE_COOKIE และ SESSION_PATH บน localhost ต้องใช้ config local ที่ตัวติดตั้งสร้าง ไม่คัด config คุกกี้จากโดเมนอื่น
เมนูยังแสดงแบบเก่าตรวจเลขรุ่นของไฟล์ asset แล้ว reload หลัง deploy ล้าง Laravel view และ config cache ตรวจ breakpoint ของธีมที่เพิ่มเอง และดู console errors
มีแถบเตือนสีส้มบนหน้า /cms และ /work ว่า cron ไม่ทำงานตรวจ path ของ PHP (ต้อง 8.4.1 ขึ้นไป) path ของ artisan และบัญชีผู้ใช้ แล้วดูรายการ "cron (schedule:run) ทำงาน" ที่ /cms#deployment หรือสั่ง school:doctor ติดตั้งแบบมาตรฐานต้องมี cron ทั้งสองโฟลเดอร์ ดูการตั้ง cron
หน้าบ้านไม่ได้ข่าวใหม่ หรือฟอร์มจากหน้าบ้านไม่เข้าระบบภายในcron ของระบบภายในหยุด หรือการจับคู่หลุด เปิด /admin/pairing ดูสถานะ ตรวจ cron แล้วสั่ง php artisan saan:publish --full ถ้ามี SSH
"ไฟล์สำรองล่าสุด" เตือนยังไม่มีไฟล์ใน storage/app/private/backups หรือเก่ากว่า 3 วัน ตรวจ cron และ SAAN_BACKUP_DAILY_AT หรือสำรองด้วยมือ ดูสำรองและกู้คืนข้อมูล

ระหว่างและหลังอัปเดต

หน้า "กำลังปรับปรุงระบบ" ไม่หาย

ระบบปิดเว็บชั่วคราวระหว่างสลับไฟล์ ถ้าหน้านี้ค้างนานผิดปกติหลังอัปเดต

  1. รอ cron ปิดงานที่ค้างให้เอง ภายในหนึ่งนาที (cron schedule:run สั่ง saan:update --recover --auto ทุกนาที) ถ้าทุกขั้นผ่านแล้วเว็บเปิดเป็นรุ่นใหม่ ถ้าไม่ครบจะคืนรุ่นเดิม
  2. ถ้ามี SSH สั่งเองได้ด้วย php artisan saan:update --recover

ถ้าตัวที่เริ่มอัปเดตตายกลางการสลับไฟล์ และไม่มีขั้นทำต่อทำงานอยู่ คำขอแรกของผู้เข้าชมจะคืนไฟล์จากสำเนาและเปิดเว็บเอง ไม่ต้องมี cron หรือ SSH ดูอัปเดตสาน

OPcache: หลังอัปเดตเว็บยังเป็นโค้ดเก่า หรือปุ่มอัปเดตในหลังบ้านไม่ยอมทำงาน

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

  1. เปิดหน้า /cms#deployment ดูรายการ "OPcache หลังอัปเดต" ซึ่งบอกว่าเป็นกรณีใด
  2. ถ้ารายการนั้นเตือนว่าไม่ตรวจไฟล์ที่เปลี่ยนและเว็บล้างเองไม่ได้ ให้ restart PHP หลังอัปเดตทุกครั้ง
  3. ในกรณีนี้ระบบปฏิเสธการอัปเดตจากปุ่มในหลังบ้านก่อนแตะไฟล์ ให้อัปเดตด้วย php artisan saan:update จาก SSH หรือจาก cron ที่ PHP CLI เริ่ม process ได้ แล้ว restart PHP
  4. ถ้าเว็บยังตรวจไฟล์ที่เปลี่ยนเอง (opcache.validate_timestamps=1) ตัวอัปเดตรอรอบตรวจหนึ่งครั้ง (3 วินาที) ก่อนขั้นตอนหลังสลับไฟล์และก่อนเปิดเว็บ ไม่ต้องทำอะไรเพิ่ม

ตัวอัปเดตปฏิเสธตั้งแต่ต้น

คำสั่ง saan:update ปฏิเสธเมื่อผู้ใช้ระบบที่รันคำสั่งไม่ใช่เจ้าของไฟล์ของแอป เช่น รันด้วย root ให้รันด้วยบัญชีเดียวกับที่เป็นเจ้าของไฟล์ของแอป

--all หยุดกลางทาง

ข้อความ [ERR] หยุดที่ <ไฟล์> บอกว่าแพ็กเกจนั้นคืนรุ่นเดิมแล้ว และกี่แพ็กเกจติดตั้งไปแล้ว แก้สาเหตุตามข้อความแล้วสั่งคำสั่งเดิมซ้ำได้ ถ้าคำสั่งบอกว่าเริ่ม PHP CLI ไม่ได้ ให้ติดตั้งทีละแพ็กเกจตามลำดับที่แสดง หรือกำหนด SAAN_PHP_CLI

ยังแก้ไม่ได้

ขอความช่วยเหลือ และแนบข้อความที่ระบบแสดง (ไม่ต้องแนบรหัสผ่านหรือข้อมูลส่วนบุคคลของนักเรียน)

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