WizardsToolkit

Wizard's Toolkit (WTK)

Kerangka kerja pengembangan full-stack yang kuat dan siap-produksi untuk membangun aplikasi web modern. Perusahaan-tingkat, siap Docker, dan terus dipelihara sejak 2009.

Dokumentasi •? Tutorial • Demo Langsung • ⚡ Mulai Cepat

Daftar isi

• Ringkasan
• Fitur utama
• Mulai cepat dengan Docker
  • Prasyarat
  • Pengaturan Dasar
  • Titik akses
• Struktur proyek
• Konfigurasi
  • Pengaturan Pengembangan Lokal
  • Konfigurasi Basis Data
• Alat pengembangan
  • Skrip utilitas
  • Manajemen Basis Data
• Dokumentasi & Sumber Daya
• Lisensi
• Pemecahan masalah
  • Masalah umum
• Keamanan

Ringkasan

Wizard's Toolkit (WTK) adalah kerangka kerja pengembangan tumpukan penuh yang kuat yang menggabungkan PHP, SQL, JavaScript, dan Materialisasi. Awalnya dibuat pada tahun 2009 dan terus dipelihara, WTK merampingkan pengembangan situs web berbasis data dan aplikasi seluler. Kerangka kerja ini telah berkembang melalui beberapa versi PHP dan saat ini dioptimalkan untuk PHP 8.1 sambil mempertahankan kompatibilitas dengan versi sebelumnya.

Ini memberikan solusi komprehensif untuk membangun dan memelihara situs web dan aplikasi seluler yang digerakkan oleh data penuh dengan cepat dan efisien. Repositori mencakup definisi tabel SQL, data awal, komponen PHP, templat HTML, gaya CSS, dan fungsionalitas JavaScript, bersama dengan dokumentasi ekstensif yang dibuat melalui PHPDOCS dan banyak file demo.

Situs web : https://wizardstoolkit.com

Fitur utama

• Solusi Full-Stack : PHP terintegrasi, SQL, JavaScript, dan MaterizeCss
• Fleksibilitas Basis Data : Dukungan mulus untuk MySQL 8.3 dan PostgreSQL
• Docker-Ready : Pengaturan lingkungan pengembangan lengkap dalam waktu kurang dari 2 menit
• Tumpukan Modern :
  • Nginx dengan alpine untuk kinerja ringan
  • PHP 8.1 dengan Dukungan PDO
  • MySQL 8.3 atau PostgreSQL Terbaru
  • Alat pengembangan (phpMyadmin untuk mysql)
• Perusahaan-Kelas : Tes produksi sejak 2009 dengan pembaruan berkelanjutan
• Dokumentasi yang luas : Termasuk dokumen API, demo, dan tutorial
• Kompatibilitas Versi : Mendukung PHP 5.4 hingga 8.1

Mulai cepat dengan Docker

Prasyarat

1. Untuk pengguna Windows :

   • WSL2 dengan Ubuntu 20.04 LTS
   • Desktop Docker
   • Akun Hub Docker (Gratis)

2. Untuk pengguna Mac :

   • Desktop Docker
   • Akun Hub Docker (Gratis)

Pengaturan Dasar

1. Klon Repositori :

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

2. Inisialisasi Lingkungan :

   ./WTK.sh

3. Pilih dan Mengatur Basis Data :

   • Untuk mysql:

     ./SETUP_MYSQL.sh

   • Untuk PostgreSQL: Pengaturan Otomatis pada Peluncuran Pertama

4. Verifikasi Instalasi : Kunjungi http://127.0.0.1/devutils/testwtk.php untuk mengonfirmasi:

   • Konektivitas Basis Data
   • Variabel Lingkungan
   • Fungsi email
   • Atur kata sandi admin

Titik akses

• Aplikasi Utama : http://127.0.0.1/ atau http://dev.wtk.com/
• Admin database :
  • Mysql: http://127.0.0.1:8080/ (phpMyadmin)
  • PostgreSQL: Gunakan DBeaver (Direkomendasikan)
• Admin default :
  • Email: [email protected]
  • Atur kata sandi: /wtk/passwordreset.php?u=NeedToSet

Struktur proyek

 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

Konfigurasi

Pengaturan Pengembangan Lokal

1. Konfigurasi host (opsional tetapi disarankan):

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

2. Pengaturan Lingkungan : Edit konfigurasi khusus database Anda:

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

Konfigurasi Basis Data

Pilih database pilihan Anda:

Mysql (default) :

• Gunakan konfigurasi yang ada
• Lokasi Data: /Mounts/mydata
• Akses melalui phpMyadmin atau CLI

PostgreSQL :

• Ganti nama docker-composePG.yml menjadi docker-compose.yml
• Lokasi Data: /Mounts/pgdata
• Hubungkan menggunakan DBeaver atau klien yang disukai
• Detail Koneksi:

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

Alat pengembangan

Skrip utilitas

• WTK.sh : inisialisasi lingkungan
• START_CONTAINERS.sh : layanan peluncuran
• STOP_CONTAINERS.sh : hentikan semua wadah
• REBUILD_CONTAINERS.sh : membangun kembali lingkungan
• RESTART_WEBSITE.sh : restart layanan cepat
• SETUP_MYSQL.sh : inisialisasi database mysql
• MYSQL.sh : akses mysql cli

Manajemen Basis Data

Mysql (melalui phpMyadmin)

Akses PhpMyAdmin di http://127.0.0.1:8080/ atau http://dev.wtk.com:8080/

1. Login :

   • Nama pengguna: Root
   • Kata sandi: (lihat Docker-Compose.yml)

2. Operasi Dasar :

   • Pilih wiztools Database dari bilah sisi kiri
   • Jelajahi Tabel dan Data Menggunakan Antarmuka GUI
   • Jalankan kueri SQL menggunakan tab "SQL"
   • Impor/Ekspor Data menggunakan tab yang sesuai

3. Tugas Umum :

   • Lihat Struktur Tabel: Klik Nama Tabel → "Struktur"
   • Jelajahi Data: Klik Nama Tabel → "Jelajahi"
   • Tambahkan Catatan: Klik Nama Tabel → "Masukkan"
   • Database Cadangan: Ekspor → "Cepat" atau "Kustom"

PostgreSQL

Detail Koneksi:

• Database: pgwizTools
• Nama pengguna: Wizdba
• Kata sandi: (lihat Docker-Compose.yml)

Klien GUI PostgreSQL yang Direkomendasikan: DBeaver (Gratis)

Catatan: Pastikan tidak ada server PostgreSQL lokal yang berjalan sebelum memulai wadah Docker.

Dokumentasi & Sumber Daya

• Dokumentasi resmi
• Panduan Pengaturan
• Wiki
• Tutorial
• File demo
• Formulir Kontak

Lisensi

Proyek ini dilisensikan di bawah Lisensi Apache 2.0 - lihat file lisensi untuk detailnya.

Pemecahan masalah

Masalah umum

1. Docker membangun kegagalan :

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

2. Reset database :

   ./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. Konflik Port :

   • Pastikan port 80 dan 443 tersedia
   • Hentikan setiap server web yang sedang berjalan (Apache, nginx)
   • Pilih antara mamp atau docker, bukan keduanya

4. Pengaturan pertama kali :

   • Inisialisasi database memakan waktu ~ 1-2 menit
   • Pantau Kemajuan di Dockerdesktop
   • Tunggu wadah basis data siap sepenuhnya

5. Masalah Koneksi :

   • Verifikasi wadah Docker sedang berjalan
   • Periksa port tidak diblokir oleh firewall
   • Pastikan konfigurasi URL yang benar di file env

Keamanan

Untuk masalah yang berhubungan dengan keamanan, silakan gunakan formulir kontak kami.

---

Dibangun dan dipelihara dengan ❤️ sejak 2009