Site Code
ฐานข้อมูลของ Site Code
ตาราง MySQL ของเว็บคุณเอง — ฐานข้อมูลแยกที่แตะตาราง CMS ไม่ได้, migration, query builder, db.docs, view core_* และหน้าจัดการฐานข้อมูล
ในหน้านี้
Site Code มีตาราง MySQL ของตัวเอง ออกแบบด้วย migration และเรียกใช้ด้วย query builder แบบ synchronous จัดการข้อมูลได้ที่ โค้ดของเว็บไซต์ → ฐานข้อมูล
ฐานข้อมูลแยก (แนะนำ)#
MySQL
├── anasaki ตารางของ CMS — ผู้ใช้ของโค้ดไม่มีสิทธิ์ใด ๆ ที่นี่
└── anasaki_code ตารางของนักพัฒนา + view core_* แบบอ่านอย่างเดียว
- โค้ดทั้งหมด (migration,
db.*, SQL console) รันด้วยผู้ใช้ MySQLanasaki_codeซึ่งมีสิทธิ์เฉพาะฐานข้อมูลanasaki_code— MySQL เองจึงกันไม่ให้แตะตาราง CMS - การติดตั้งด้วย docker compose สร้างให้อัตโนมัติตอนเริ่มครั้งแรก (
docker/mysql-init/10-site-code.sh+CODE_DB_PASSWORD) และส่งCODE_DB_DSNให้ CMS - เว็บที่ติดตั้งก่อนหน้านั้น: รัน SQL 4 บรรทัดที่หน้าฐานข้อมูลแสดง แล้วตั้ง
CODE_DB_PASSWORD— ขั้นตอนเต็มอยู่ใน อัปเดตเวอร์ชัน
View core_* (อ่านอย่างเดียว)#
| view | คอลัมน์ |
|---|---|
core_posts | id, type, title, slug, status, excerpt, author_id, featured_media_id, published_at, created_at, updated_at (เฉพาะที่เผยแพร่) |
core_terms | id, taxonomy, name, slug |
core_post_terms | post_id, term_id (ของโพสต์ที่เผยแพร่) |
core_users | id, name, email, role, status, created_at (ไม่มีรหัสผ่านหรือ token) |
โหมดสำรอง (fallback)#
ถ้าไม่มี CODE_DB_DSN หรือเชื่อมต่อไม่ได้ ตารางของคุณจะอยู่ในฐานข้อมูล CMS โดยขึ้นต้นด้วย sc_ (ระบบเติม/ตัดให้เอง) — migration, query builder, db.docs และหน้าจัดการยังใช้ได้ แต่ db.query, db.raw, schema.raw, SQL console และ view core_* ใช้ไม่ได้ (ใช้ db.posts แทน) การเปลี่ยนจากโหมดสำรองเป็นฐานข้อมูลแยกไม่ย้ายตาราง sc_ เดิมให้ (ต้อง dump → import เอง)
Migration#
สร้างไฟล์ใน migrations/ (ปุ่ม Migration ใหม่ ใน editor ตั้งชื่อเป็น migrations/NNN_ชื่อ.ts ให้) รันตามลำดับชื่อไฟล์
// migrations/001_create_orders.ts
export default migration({
up(schema) {
schema.create('orders', (t) => {
t.id(); // BIGINT UNSIGNED AUTO_INCREMENT PK
t.string('code', 20).unique();
t.foreignId('user_id').nullable().references('core_users');
t.enum('status', ['pending', 'paid']).default('pending');
t.decimal('total', 12, 2);
t.json('shipping').nullable();
t.timestamps(); // created_at, updated_at
t.index(['status', 'created_at']);
});
},
down(schema) { schema.drop('orders'); },
});
- คอลัมน์:
id, string, text, integer, bigInteger, decimal, boolean, date, datetime, json, enum, uuid, foreignId, timestamps()· modifier:nullable, default, unique, index, unsigned, comment, after, change, useCurrent, references(...).onDelete(...)· ทำให้คอลัมน์แยกตัวพิมพ์ด้วย.binary() - ชื่อตาราง
^[a-z][a-z0-9_]{0,62}$ห้ามขึ้นต้นcore_,script_,sc_,bak_ - ตอนเผยแพร่ migration ที่ค้างรันก่อนโค้ดใหม่ขึ้นเว็บจริง ถ้าล้ม การเผยแพร่หยุดและโค้ดเดิมทำงานต่อ (DDL ของ MySQL ไม่อยู่ใน transaction — แก้ด้วย migration ใหม่ หรือแก้ไฟล์ที่ล้มแล้วเผยแพร่ใหม่)
- การเปลี่ยนแปลงที่อาจทำให้ข้อมูลหาย (drop / rename / เปลี่ยนชนิดคอลัมน์) ต้องติ๊กยืนยัน "ฉันเข้าใจว่าข้อมูลอาจหายไป" ระบบสำรองตารางเป็น
bak_<table>_<เวลา>ไว้ 7 วันก่อนรัน - ย้อน migration ของชุดล่าสุดได้ที่หน้าฐานข้อมูล (รัน
down())
Query builder (ใน handler)#
const page = db.from('orders as o')
.leftJoin('core_users as u', 'u.id', 'o.user_id')
.select('o.id', 'o.code', 'o.total', 'u.name as customer')
.where('o.status', 'paid').where('o.total', '>', 100)
.orderBy('o.created_at', 'desc')
.paginate(1, 20); // { items, total, page, perPage }
const id = db.table('orders').insert({ code: 'A1', total: 10 });
db.table('orders').where('id', id).update({ total: 12 }); // update/delete ต้องมี where() หรือ .all()
db.transaction((tx) => { tx.table('a').insert({}); tx.table('b').insert({}); }); // throw = rollback
const notes = db.docs('notes'); // เก็บ JSON แบบ document
notes.insert({ title: 'x' });
notes.find({ where: { title: 'x' }, orderBy: '-createdAt' });
- ทุกค่าเป็น bound parameter (กัน SQL injection) — SQL ดิบใช้
db.query(sql, params)/db.raw(...)(เฉพาะฐานข้อมูลแยก) - ผลลัพธ์: DECIMAL → string, DATETIME → ISO string, JSON → object
- ขีดจำกัด: 5 วินาทีต่อคำสั่ง, 10,000 แถว / 10 MB ต่อผลลัพธ์ (ใช้
paginate— ไม่เกิน 100 ต่อหน้า) anasaki-code typesสร้าง type ของแถวจากตารางจริง (OrdersRow) ให้db.table('orders')มี type
ทดสอบ route ใช้ฐานข้อมูลจริง — ข้อมูลที่โค้ดเขียนหรือลบระหว่างทดสอบจะเปลี่ยนจริง
หน้า ฐานข้อมูล#
| ทำอะไรได้ | สิทธิ์ |
|---|---|
ดูตาราง โครงสร้าง ข้อมูล (ค้นหา กรอง เรียง) ส่งออก CSV/JSON, dump .sql, ประวัติ migration, ตารางสำรอง | view_code_data |
| SQL console แบบอ่าน (SELECT/SHOW/EXPLAIN… ใน transaction อ่านอย่างเดียว) | view_code_data |
| เพิ่ม/แก้/ลบแถว, นำเข้า CSV, SQL แบบเขียน, ลบตารางสำรอง | edit_code_data |
| ย้อน migration | edit_code_data + publish_scripts |
ใครเข้าถึงตารางผ่านหน้าออกแบบได้บ้างตั้งที่ สิทธิ์การเข้าถึง (ค่าเริ่มต้นของตาราง = ไม่มีใคร) ดู ผูกข้อมูลกับหน้าออกแบบ
