WizardsToolkit

مجموعة أدوات Wizard (WTK)

إطار عمل قوي ومجهول الإنتاج جاهز للإنتاج لبناء تطبيقات الويب الحديثة. على مستوى المؤسسات ، جاهزة للرسوم ، وصيانتها بشكل مستمر منذ عام 2009.

الوثائق •؟ الدروس • العرض التوضيحي المباشر • ⚡ بداية سريعة

جدول المحتويات

• ملخص
• الميزات الرئيسية
• بداية سريعة مع Docker
  • المتطلبات الأساسية
  • الإعداد الأساسي
  • نقاط الوصول
• هيكل المشروع
• إعدادات
  • إعداد التنمية المحلية
  • تكوين قاعدة البيانات
• أدوات التطوير
  • البرامج النصية فائدة
  • إدارة قاعدة البيانات
• الوثائق والموارد
• رخصة
• استكشاف الأخطاء وإصلاحها
  • القضايا المشتركة
• حماية

ملخص

تعد مجموعة أدوات Wizard's (WTK) إطارًا قويًا لتطوير المكاسب الكاملة يجمع بين PHP و SQL و JavaScript و MaterioSecss. تم إنشاؤه في الأصل في عام 2009 وصيانته بشكل مستمر ، يقوم WTK بتبسيط تطوير مواقع الويب التي تعتمد على البيانات وتطبيقات الأجهزة المحمولة. تطور الإطار من خلال إصدارات متعددة PHP ويتم تحسينه حاليًا لـ PHP 8.1 مع الحفاظ على التوافق مع الإصدارات السابقة.

يوفر حلاً شاملاً لبناء وصيانة مواقع الويب التي تعتمد على البيانات وتطبيقات الأجهزة المحمولة بالكامل بسرعة وكفاءة. يتضمن المستودع تعريفات جدول SQL ، والبيانات الأولية ، ومكونات PHP ، وقوالب HTML ، وتصميم CSS ، ووظائف JavaScript ، إلى جانب وثائق مكثفة تم إنشاؤها عبر PHPDOCS والعديد من الملفات التجريبية.

الموقع الإلكتروني : https://wizardstoolkit.com

الميزات الرئيسية

• حل الكامل : PHP متكامل ، SQL ، JavaScript ، و MaterioSecss
• مرونة قاعدة البيانات : دعم سلس لكل من MySQL 8.3 و PostgreSQL
• Docker جاهز : إعداد بيئة التطوير الكاملة في أقل من دقيقتين
• المكدس الحديث :
  • Nginx مع جبال الألب للأداء الخفيف الوزن
  • PHP 8.1 بدعم PDO
  • MySQL 8.3 أو PostgreSQL الأحدث
  • أدوات التطوير (phpmyadmin لـ MySQL)
• درجة المؤسسة : تم اختبار الإنتاج منذ عام 2009 مع تحديثات مستمرة
• وثائق مكثفة : يشمل مستندات API ، والعروض التوضيحية ، والدروس التعليمية
• توافق الإصدار : يدعم PHP 5.4 إلى 8.1

بداية سريعة مع Docker

المتطلبات الأساسية

1. لمستخدمي Windows :

   • WSL2 مع Ubuntu 20.04 LTS
   • سطح المكتب Docker
   • حساب Docker Hub (مجاني)

2. لمستخدمي Mac :

   • سطح المكتب Docker
   • حساب 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

إدارة قاعدة البيانات

MySQL (عبر phpmyadmin)

الوصول إلى phpmyadmin على http://127.0.0.1:8080/ أو http://dev.wtk.com:8080/

1. تسجيل الدخول :

   • اسم المستخدم: الجذر
   • كلمة المرور: (انظر Docker-corm.yml)

2. العمليات الأساسية :

   • حدد قاعدة بيانات wiztools من الشريط الجانبي الأيسر
   • تصفح الجداول والبيانات باستخدام واجهة واجهة المستخدم الرسومية
   • قم بتنفيذ استعلامات SQL باستخدام علامة التبويب "SQL"
   • استيراد/تصدير بيانات باستخدام علامات التبويب المقابلة

3. المهام الشائعة :

   • عرض بنية الجدول: انقر فوق اسم الجدول ← "الهيكل"
   • تصفح البيانات: انقر فوق اسم الجدول → "تصفح"
   • إضافة السجلات: انقر فوق اسم الجدول → "إدراج"
   • قاعدة بيانات النسخ الاحتياطي: التصدير → "سريع" أو "مخصص"

postgresql

تفاصيل الاتصال:

• قاعدة البيانات: pgwiztools
• اسم المستخدم: Wizdba
• كلمة المرور: (انظر Docker-corm.yml)

العميل الموصى به PostgreSQL GUI: DBEAVER (مجاني)

ملاحظة: تأكد من تشغيل خادم PostgreSQL المحلي قبل بدء حاويات Docker.

الوثائق والموارد

• الوثائق الرسمية
• دليل الإعداد
• ويكي
• دروس
• الملفات التجريبية
• نموذج الاتصال

رخصة

تم ترخيص هذا المشروع بموجب ترخيص Apache 2.0 - راجع ملف الترخيص للحصول على التفاصيل.

استكشاف الأخطاء وإصلاحها

القضايا المشتركة

1. فشل بناء Docker :

    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. الإعداد لأول مرة :

   • يستغرق تهيئة قاعدة البيانات ~ 2-2 دقيقة
   • مراقبة التقدم في Dockerdesktop
   • انتظر حتى تكون حاوية قاعدة البيانات جاهزة تمامًا

5. قضايا الاتصال :

   • تحقق من أن حاويات العرف تعمل
   • لا يتم حظر المنافذ بواسطة جدار الحماية
   • تأكد من تكوين عنوان URL الصحيح في ملفات ENV

حماية

للمشكلات المتعلقة بالأمان ، يرجى استخدام نموذج الاتصال الخاص بنا.

---

بنيت وصيانتها مع ❤ منذ عام 2009