WizardsToolkit

ชุดเครื่องมือของพ่อมด (WTK)

กรอบการพัฒนาเต็มรูปแบบที่มีประสิทธิภาพพร้อมการผลิตสำหรับการสร้างเว็บแอปพลิเคชันที่ทันสมัย ระดับองค์กรเกรดพร้อมและดูแลรักษาอย่างต่อเนื่องตั้งแต่ปี 2009

เอกสาร•? บทเรียน•การสาธิตสด•⚡เริ่มต้นอย่างรวดเร็ว

สารบัญ

• ภาพรวม
• คุณสมบัติที่สำคัญ
• เริ่มต้นอย่างรวดเร็วด้วยนักเทียบท่า
  • ข้อกำหนดเบื้องต้น
  • การตั้งค่าพื้นฐาน
  • จุดเชื่อมต่อ
• โครงสร้างโครงการ
• การกำหนดค่า
  • การตั้งค่าการพัฒนาท้องถิ่น
  • การกำหนดค่าฐานข้อมูล
• เครื่องมือพัฒนา
  • สคริปต์ยูทิลิตี้
  • การจัดการฐานข้อมูล
• เอกสารและทรัพยากร
• ใบอนุญาต
• การแก้ไขปัญหา
  • ปัญหาทั่วไป
• ความปลอดภัย

ภาพรวม

Wizard's Toolkit (WTK) เป็นเฟรมเวิร์กการพัฒนาแบบเต็มรูปแบบที่ทรงพลังซึ่งรวม PHP, SQL, JavaScript และ MaterialIZECSS สร้างขึ้นครั้งแรกในปี 2009 และได้รับการดูแลอย่างต่อเนื่อง WTK จะปรับปรุงการพัฒนาเว็บไซต์ที่ขับเคลื่อนด้วยข้อมูลและแอปพลิเคชันมือถือ เฟรมเวิร์กได้พัฒนาผ่าน PHP หลายรุ่นและปัจจุบันได้รับการปรับให้เหมาะสมสำหรับ PHP 8.1 ในขณะที่ยังคงความเข้ากันได้กับเวอร์ชันก่อนหน้า

มันเป็นโซลูชันที่ครอบคลุมสำหรับการสร้างและบำรุงรักษาเว็บไซต์ที่ขับเคลื่อนด้วยข้อมูลเต็มรูปแบบและแอพมือถืออย่างรวดเร็วและมีประสิทธิภาพ ที่เก็บรวมถึงคำจำกัดความของตาราง SQL, ข้อมูลเริ่มต้น, ส่วนประกอบ PHP, เทมเพลต HTML, สไตล์ CSS และฟังก์ชั่น JavaScript พร้อมกับเอกสารที่ครอบคลุมผ่าน PHPDOCs และไฟล์ตัวอย่างมากมาย

เว็บไซต์ : https://wizardstoolkit.com

คุณสมบัติที่สำคัญ

• โซลูชันแบบเต็มสแต็ค : PHP, SQL, JavaScript และ MaterialIZSSS ในตัว
• ความยืดหยุ่นของฐานข้อมูล : การสนับสนุนที่ราบรื่นสำหรับทั้ง MySQL 8.3 และ PostgreSQL
• Docker พร้อม : การตั้งค่าสภาพแวดล้อมการพัฒนาที่สมบูรณ์ภายในไม่ถึง 2 นาที
• สแต็คสมัยใหม่ :
  • Nginx พร้อมอัลไพน์เพื่อประสิทธิภาพที่มีน้ำหนักเบา
  • PHP 8.1 พร้อมการสนับสนุน PDO
  • mysql 8.3 หรือ postgreSql ล่าสุด
  • เครื่องมือพัฒนา (phpmyadmin สำหรับ mySQL)
• ระดับองค์กร : ทดสอบการผลิตตั้งแต่ปี 2552 ด้วยการอัปเดตอย่างต่อเนื่อง
• เอกสารที่กว้างขวาง : รวมถึงเอกสาร API การสาธิตและบทช่วยสอน
• ความเข้ากันได้ของเวอร์ชัน : รองรับ PHP 5.4 ถึง 8.1

เริ่มต้นอย่างรวดเร็วด้วยนักเทียบท่า

ข้อกำหนดเบื้องต้น

1. สำหรับผู้ใช้ Windows :

   • WSL2 กับ Ubuntu 20.04 LTS
   • Docker Desktop
   • บัญชี Docker Hub (ฟรี)

2. สำหรับผู้ใช้ Mac :

   • Docker Desktop
   • บัญชี Docker Hub (ฟรี)

การตั้งค่าพื้นฐาน

1. โคลนที่เก็บ :

   git clone https://github.com/AlecBS/WizardsToolkit.git
   cd WizardsToolkit

2. เริ่มต้นสภาพแวดล้อม :

   ./WTK.sh

3. เลือกและตั้งค่าฐานข้อมูล :

   • สำหรับ mysql:

     ./SETUP_MYSQL.sh

   • สำหรับ PostgreSQL: การตั้งค่าอัตโนมัติเมื่อเปิดตัวครั้งแรก

4. ตรวจสอบการติดตั้ง : เยี่ยมชม http://127.0.0.1/devutils/testwtk.php เพื่อยืนยัน:

   • การเชื่อมต่อฐานข้อมูล
   • ตัวแปรสภาพแวดล้อม
   • ฟังก์ชั่นอีเมล
   • ตั้งรหัสผ่านผู้ดูแลระบบ

จุดเชื่อมต่อ

• แอปพลิเคชันหลัก : http://127.0.0.1/ หรือ http://dev.wtk.com/
• ผู้ดูแลระบบฐานข้อมูล :
  • mysql: http://127.0.0.1:8080/ (phpmyadmin)
  • PostgreSQL: ใช้ dbeaver (แนะนำ)
• ผู้ดูแลระบบเริ่มต้น :
  • อีเมล: [email protected]
  • ตั้งรหัสผ่าน: /wtk/passwordReset.php?u=needToset

โครงสร้างโครงการ

 WizardsToolkit/
├── app/                # Application source files
├── config/             # Configuration settings
├── SQL/                # Database scripts and migrations
│   ├── mySQL/          # MySQL specific scripts
│   └── postgresql/     # PostgreSQL specific scripts
├── Mounts/             # Docker volume mount points
└── *.sh                # Utility scripts

การกำหนดค่า

การตั้งค่าการพัฒนาท้องถิ่น

1. การกำหนดค่าโฮสต์ (เป็นทางเลือก แต่แนะนำ):

    # Add to /etc/hosts
   127.0.0.1   dev.wtk.com
   

2. การตั้งค่าสภาพแวดล้อม : แก้ไขการกำหนดค่าฐานข้อมูลเฉพาะ:

    # In phpMySQL.env or phpPG.env
   URL = "http://dev.wtk.com"  # or http://127.0.0.1

การกำหนดค่าฐานข้อมูล

เลือกฐานข้อมูลที่คุณต้องการ:

MySQL (ค่าเริ่มต้น) :

• ใช้การกำหนดค่าที่มีอยู่
• ตำแหน่งข้อมูล: /Mounts/mydata
• เข้าถึงผ่าน phpmyadmin หรือ CLI

PostgreSQL :

• เปลี่ยนชื่อ docker-composePG.yml เป็น docker-compose.yml
• ตำแหน่งข้อมูล: /Mounts/pgdata
• เชื่อมต่อโดยใช้ dbeaver หรือไคลเอนต์ที่ต้องการ
• รายละเอียดการเชื่อมต่อ:

   Database: pgwiztools
  Username: wizdba
  Password: See docker-compose.yml
  

เครื่องมือพัฒนา

สคริปต์ยูทิลิตี้

• WTK.sh : เริ่มต้นสภาพแวดล้อม
• START_CONTAINERS.sh : เปิดตัวบริการ
• STOP_CONTAINERS.sh : หยุดคอนเทนเนอร์ทั้งหมด
• REBUILD_CONTAINERS.sh : สร้างสภาพแวดล้อมใหม่
• RESTART_WEBSITE.sh : รีสตาร์ทบริการด่วน
• SETUP_MYSQL.sh : เริ่มต้นฐานข้อมูล MySQL
• MYSQL.sh : MySQL CLI Access

การจัดการฐานข้อมูล

mysql (ผ่าน phpmyadmin)

เข้าถึง phpmyadmin ที่ http://127.0.0.1:8080/ หรือ http://dev.wtk.com:8080/

1. เข้าสู่ระบบ :

   • ชื่อผู้ใช้: รูท
   • รหัสผ่าน: (ดู Docker-compose.yml)

2. การดำเนินการขั้นพื้นฐาน :

   • เลือกฐานข้อมูล wiztools จากแถบด้านข้างซ้าย
   • เรียกดูตารางและข้อมูลโดยใช้อินเทอร์เฟซ GUI
   • ดำเนินการสืบค้น SQL โดยใช้แท็บ "SQL"
   • นำเข้า/ส่งออกข้อมูลโดยใช้แท็บที่เกี่ยวข้อง

3. งานทั่วไป :

   • ดูโครงสร้างตาราง: คลิกชื่อตาราง→ "โครงสร้าง"
   • เรียกดูข้อมูล: คลิกชื่อตาราง→ "เรียกดู"
   • เพิ่มระเบียน: คลิกชื่อตาราง→ "แทรก"
   • ฐานข้อมูลสำรอง: ส่งออก→ "ด่วน" หรือ "กำหนดเอง"

PostgreSQL

รายละเอียดการเชื่อมต่อ:

• ฐานข้อมูล: pgwiztools
• ชื่อผู้ใช้: Wizdba
• รหัสผ่าน: (ดู Docker-compose.yml)

ไคลเอนต์ PostgreSQL GUI ที่แนะนำ: DBeaver (ฟรี)

หมายเหตุ: ตรวจสอบให้แน่ใจว่าไม่มีเซิร์ฟเวอร์ PostgreSQL ในพื้นที่ทำงานก่อนที่จะเริ่มคอนเทนเนอร์ Docker

เอกสารและทรัพยากร

• เอกสารอย่างเป็นทางการ
• คู่มือการตั้งค่า
• วิกิ
• บทเรียน
• ไฟล์สาธิต
• แบบฟอร์มการติดต่อ

ใบอนุญาต

โครงการนี้ได้รับอนุญาตภายใต้ Apache License 2.0 - ดูไฟล์ใบอนุญาตสำหรับรายละเอียด

การแก้ไขปัญหา

ปัญหาทั่วไป

1. Docker Build Failure :

    export DOCKER_BUILDKIT=0
   ./WTK.sh  # Retry build

2. รีเซ็ตฐานข้อมูล :

   ./STOP_CONTAINERS.sh
   rm -rf /Mounts/mydata  # For MySQL
   # or
   rm -rf /Mounts/pgdata  # For PostgreSQL
   ./START_CONTAINERS.sh
   ./SETUP_MYSQL.sh  # MySQL only

3. พอร์ตความขัดแย้ง :

   • ตรวจสอบให้แน่ใจว่ามีพอร์ต 80 และ 443
   • หยุดเว็บเซิร์ฟเวอร์ที่กำลังทำงานอยู่ (Apache, Nginx)
   • เลือกระหว่าง MAMP หรือ Docker ไม่ใช่ทั้งสองอย่าง

4. การตั้งค่าครั้งแรก :

   • การเริ่มต้นฐานข้อมูลใช้เวลา ~ 1-2 นาที
   • ตรวจสอบความคืบหน้าใน Dockerdesktop
   • รอให้คอนเทนเนอร์ฐานข้อมูลพร้อมอย่างเต็มที่

5. ปัญหาการเชื่อมต่อ :

   • ตรวจสอบว่าคอนเทนเนอร์ Docker กำลังทำงานอยู่
   • ตรวจสอบพอร์ตจะไม่ถูกบล็อกด้วยไฟร์วอลล์
   • ตรวจสอบการกำหนดค่า URL ที่ถูกต้องในไฟล์ Env

ความปลอดภัย

สำหรับปัญหาที่เกี่ยวข้องกับความปลอดภัยโปรดใช้แบบฟอร์มการติดต่อของเรา

---

สร้างและบำรุงรักษาด้วย❤ตั้งแต่ปี 2009