สำหรับนักพัฒนา

Site Code

ฐานข้อมูลของ Site Code

ตาราง MySQL ของเว็บคุณเอง — ฐานข้อมูลแยกที่แตะตาราง CMS ไม่ได้, migration, query builder, db.docs, view core_* และหน้าจัดการฐานข้อมูล

อ่าน 8 นาทีอัปเดตล่าสุด

ดูเป็น Markdown

ในหน้านี้

Site Code มีตาราง MySQL ของตัวเอง ออกแบบด้วย migration และเรียกใช้ด้วย query builder แบบ synchronous จัดการข้อมูลได้ที่ โค้ดของเว็บไซต์ → ฐานข้อมูล

ฐานข้อมูลแยก (แนะนำ)#

MySQL
├── anasaki        ตารางของ CMS — ผู้ใช้ของโค้ดไม่มีสิทธิ์ใด ๆ ที่นี่
└── anasaki_code   ตารางของนักพัฒนา + view core_* แบบอ่านอย่างเดียว
  • โค้ดทั้งหมด (migration, db.*, SQL console) รันด้วยผู้ใช้ MySQL anasaki_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_postsid, type, title, slug, status, excerpt, author_id, featured_media_id, published_at, created_at, updated_at (เฉพาะที่เผยแพร่)
core_termsid, taxonomy, name, slug
core_post_termspost_id, term_id (ของโพสต์ที่เผยแพร่)
core_usersid, 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
ย้อน migrationedit_code_data + publish_scripts

ใครเข้าถึงตารางผ่านหน้าออกแบบได้บ้างตั้งที่ สิทธิ์การเข้าถึง (ค่าเริ่มต้นของตาราง = ไม่มีใคร) ดู ผูกข้อมูลกับหน้าออกแบบ