وثائق ServBay: إدارة قواعد البيانات باستخدام Adminer

نظرة عامة

ServBay هي بيئة تطوير ويب محلية قوية تدعم macOS وWindows، وتدمج بين خوادم ويب متعددة، بيئات لغات البرمجة المختلفة، وأنظمة قواعد البيانات. ولتسهيل إدارة قواعد البيانات المدمجة للمطورين، يأتي ServBay مثبتًا ومُعدًّا مسبقًا مع Adminer - أداة خفيفة وفعّالة لإدارة قواعد البيانات. يوضح هذا الدليل كيفية استخدام Adminer للاتصال وإدارة قواعد البيانات ضمن ServBay.

ما هو Adminer

Adminer هي أداة إدارة قواعد بيانات مكتوبة بلغة PHP، تتكون من ملف واحد فقط، وتدعم العديد من أنظمة قواعد البيانات مثل MySQL وMariaDB وPostgreSQL وSQLite وMongoDB وغيرها. بالمقارنة مع برامج إدارة قواعد البيانات الأكبر حجمًا، تتميز Adminer بالخصائص التالية:

1. خفة وسهولة النشر: Adminer عبارة عن ملف PHP واحد فقط، لا يتطلب عملية تثبيت معقدة. في ServBay يكون جاهزًا للاستخدام فورًا.
2. دعم عدة أنواع قواعد بيانات: من خلال واجهة موحدة، يمكنك إدارة أنواع قواعد بيانات متعددة دون الحاجة لتثبيت أو تعلم أدوات مختلفة.
3. واجهة مستخدم بسيطة وواضحة: توفر وظيفة تصفح سهلة ومفهومة تمكن المطورين الجديدين من الاستفادة بسرعة.
4. ميزات شاملة: تدعم أبرز العمليات الشائعة مثل إنشاء وتعديل وحذف قواعد البيانات والجداول والفهارس والمستخدمين وتشغيل استعلامات SQL واستيراد/تصدير البيانات.

بالنسبة للمطورين الذين يستخدمون ServBay للتطوير المحلي، تعد Adminer حلًا فعالًا وسريعًا لإدارة قواعد البيانات.

الوصول إلى Adminer

عند تشغيل ServBay، يتم تشغيل Adminer تلقائيًا ويمكن الوصول إليها عبر خادم ServBay المحلي المدمج. يمكنك زيارتها عن طريق استخدام اسم النطاق المحلي الخاص بـ ServBay مع اسم ملف Adminer:

https://servbay.host/adminer.php

تأكد من أن تطبيق ServBay يعمل، وخوادم الويب المطلوبة (مثل Caddy أو Nginx) وخدمة قواعد البيانات التي ترغب بالاتصال بها نشطة.

الاتصال بقواعد البيانات في ServBay

واجهة تسجيل الدخول لأداة Adminer سلسة جدًا. اختر نوع قاعدة البيانات، وأدخل عنوان الخادم واسم المستخدم وكلمة المرور (وأحيانًا اسم قاعدة البيانات). يقوم ServBay بإنشاء اسم المستخدم وكلمة مرور افتراضيين لكل قاعدة بيانات مدمجة - ويمكنك العثور عليهما ضمن تبويب "قاعدة البيانات" في تطبيق ServBay.

الاتصال بـ MariaDB / MySQL

عادةً ما يأتي ServBay مدمجًا مع MariaDB أو MySQL بشكل افتراضي. في Adminer، اختر عادةً "MySQL" للاتصال.

1. افتح المتصفح، وانتقل إلى رابط Adminer (https://servbay.host/adminer.php).
2. في شاشة تسجيل الدخول، من قائمة النظام اختر MySQL.
3. أدخل بيانات الاتصال:
   • الخادم: أدخل localhost أو مسار Socket الذي يوفره ServBay /Applications/ServBay/tmp/mysql.sock. استخدام Socket غالبًا أسرع وأكثر أمانًا.
   • اسم المستخدم: راجع قسم "قاعدة البيانات" للاطلاع على اسم المستخدم الخاص بـ MariaDB/MySQL.
   • كلمة المرور: راجع القسم نفسه للعثور على كلمة المرور.
   • قاعدة البيانات: (اختياري) لتوصيل قاعدة بيانات معينة مباشرةً، أدخل اسمها هنا. إذا تركته فارغًا، ستتصل بالخادم ويمكنك إدارة جميع قواعد البيانات بعد تسجيل الدخول.
4. اضغط على زر تسجيل الدخول.

الاتصال بـ PostgreSQL

يدعم ServBay أيضًا PostgreSQL. في Adminer، اختر "PostgreSQL".

1. افتح المتصفح، وانتقل إلى رابط Adminer (https://servbay.host/adminer.php).
2. من قائمة النظام اختر PostgreSQL.
3. أدخل بيانات الاتصال:
   • الخادم: أدخل /Applications/ServBay/tmp.
   • اسم المستخدم: ابحث عن اسم المستخدم الخاص بـ PostgreSQL في قسم "قاعدة البيانات" بتطبيق ServBay.
   • كلمة المرور: ابحث عن كلمة مرور PostgreSQL هناك.
   • قاعدة البيانات: أدخل اسم قاعدة البيانات المطلوب الاتصال بها مثل postgres الافتراضية أو قاعدة بيانات أخرى أنشأتها.
4. اضغط على زر تسجيل الدخول.

الاتصال بـ SQLite 3

يدعم ServBay قاعدة بيانات SQLite 3، وهي عبارة عن ملف، لذلك عند الاتصال حدد مسار الملف.

1. افتح المتصفح، وانتقل إلى رابط Adminer (https://servbay.host/adminer.php).
2. من قائمة النظام اختر SQLite 3.
3. أدخل مسار ملف قاعدة البيانات:
   • ملف قاعدة البيانات: أدخل المسار الكامل للملف الخاص بـ SQLite. يُنصح بوضع ملفات قواعد SQLite في دليل البيانات الخاص بـ ServBay، مثل /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • إذا أشرت إلى ملف غير موجود، سيطلب Adminer منك إنشائه.
4. اضغط على زر تسجيل الدخول.

تنفيذ العمليات الشائعة لإدارة قواعد البيانات

بعد تسجيل الدخول بنجاح إلى الخادم أو إلى قاعدة بيانات معينة، يمكنك عبر واجهة Adminer تنفيذ مجموعة من مهام إدارة قواعد البيانات. قد تختلف الواجهة والميزات قليلاً حسب نوع قاعدة البيانات لكن سير العمل الأساسي متشابه.

إنشاء قاعدة بيانات

(ينطبق على MariaDB/MySQL، PostgreSQL)

1. سجل الدخول إلى الخادم (دون تحديد قاعدة بيانات معينة).
2. ابحث في الشريط الجانبي أو الشاشة الرئيسية عن خيار إنشاء قاعدة بيانات أو ما يُشابه ذلك.
3. أدخل اسم قاعدة البيانات الجديدة.
4. اختر الترميز ونمط الترتيب (إذا لزم الأمر).
5. اضغط على زر حفظ أو إنشاء.

(بالنسبة لـ SQLite 3، يتم إنشاء قاعدة البيانات أثناء تسجيل الدخول عن طريق تحديد مسار ملف غير موجود.)

إدارة الجداول والبيانات

1. اختر قاعدة البيانات (إذا لم تحددها أثناء تسجيل الدخول).
2. في شاشة ملخص قاعدة البيانات، ابحث عن خيار إنشاء جدول.
3. أدخل اسم الجدول وعرّف الحقول (الأعمدة) - مثل اسم العمود ونوع البيانات والطول وهل يقبل القيم الفارغة والقيمة الافتراضية والفهارس (مفتاح أساسي، فهرس فريد، فهرس عادي) إلخ.
4. اضغط على زر حفظ لإنشاء الجدول.
5. بعد إنشاء الجدول، اختره من الشريط الجانبي أو من شاشة الملخص.
6. نفذ العمليات على البيانات:
   • إدراج: إضافة صف بيانات جديد.
   • اختيار: عرض أو بحث أو ترتيب أو تصفية البيانات الموجودة.
   • تحديث: تعديل صف بيانات موجود.
   • حذف: إزالة صف بيانات موجود.
   • استخدام أوامر SQL لتنفيذ استعلامات وإجراءات أكثر تعقيدًا.

تنفيذ أوامر SQL

يوفر Adminer واجهة إدخال أوامر SQL تتيح لك تنفيذ استعلامات وعمليات متقدمة مباشرة داخل قاعدة البيانات.

1. اختر قاعدة البيانات التي تريد تنفيذ الأوامر عليها.
2. انقر على خيار أوامر SQL.
3. أدخل الاستعلام في مربع النص.
4. اضغط على زر تنفيذ.

استيراد وتصدير البيانات

يمكنك بواسطة Adminer تصدير هيكل أو بيانات قاعدة البيانات إلى ملف SQL أو صيغ أخرى مثل CSV، وكذلك استيراد البيانات منها، ما يفيد في النسخ الاحتياطي أو مشاركة البيانات أو نقلها.

1. اختر قاعدة البيانات أو الجدول المطلوب للاستيراد أو التصدير.
2. ابحث عن خيار تصدير أو استيراد.
3. اتبع التعليمات لاختيار الصيغة المناسبة وتنفيذ العملية.

حذف قاعدة بيانات

(ينطبق على MariaDB/MySQL، PostgreSQL)

1. سجل الدخول إلى الخادم (دون تحديد قاعدة بيانات).
2. من قائمة قواعد البيانات، اختر القاعدة التي تود حذفها.
3. اضغط على خيار حذف وأكد. انتبه: هذه العملية غير قابلة للاسترجاع وستحذف القاعدة وكل بياناتها بشكل دائم.

(بالنسبة لـ SQLite 3، حذف قاعدة البيانات يعني حذف ملف الـ .sqlite يدوياً من النظام.)

ملاحظات هامة

• أمان بيانات الدخول: حافظ على بيانات اسم المستخدم وكلمة المرور التي حصلت عليها من إعدادات ServBay ولا تشاركها.
• حالة تشغيل ServBay: Adminer متاح عبر خادم الويب المدمج في ServBay ويتطلب عمل خدمات قواعد البيانات ذات الصلة. إذا لم تتمكن من الوصول إلى Adminer أو قاعدة البيانات، تحقق من أن ServBay والتطبيقات المرتبطة (Caddy/Nginx، MariaDB/MySQL، PostgreSQL إلخ) قيد التشغيل.
• مسار ملفات SQLite: تأكد من تحديد مسار يسمح لمستخدم ServBay بالقراءة والكتابة على ملفات SQLite، ويفضل استخدام دليل البيانات /Applications/ServBay/db/sqlite/.
• الأداء: Adminer أداة خفيفة - لكن إذا كنت تدير قواعد بيانات ضخمة أو تحتاج مزايا متقدمة، قد تجد أدوات سطح المكتب مثل TablePlus أو DBeaver أو pgAdmin أسرع أو أكثر تطورًا.

الأسئلة الشائعة (FAQ)

س: لا أستطيع الوصول إلى https://servbay.host/adminer.php، ما العمل؟

ج: تأكد من أن تطبيق ServBay قيد التشغيل، وأن خادم الويب (Caddy أو Nginx عادةً) بدأ العمل. تحقق من أن المتصفح يسمح بالوصول إلى https://servbay.host.

س: نسيت اسم المستخدم أو كلمة المرور لقاعدة البيانات، أين أجدها؟

ج: يمكنك العثور على اسم المستخدم وكلمة المرور الافتراضية لجميع قواعد البيانات ضمن تبويب "قاعدة البيانات" في واجهة تطبيق ServBay.

س: ما عنوان الخادم والمنفذ عند الاتصال بـ PostgreSQL؟

ج: غالبًا ما يكون العنوان هو localhost والمنفذ الافتراضي 5432. يمكنك التأكد من عنوان الاستماع والمنفذ ضمن إعدادات ServBay. إذا كنت تستخدم طريقة Unix Domain Socket، أدخل /Applications/ServBay/tmp (ملاحظة: لا حاجة لـ .sock مع PostgreSQL).

س: ما الفرق بين عنوان الخادم ومسار socket عند الاتصال بـ MariaDB/MySQL؟

ج: إستخدام localhost يعني اتصال TCP/IP (المنفذ الافتراضي 3306)، أما المسار /Applications/ServBay/tmp/mysql.sock يعني اتصال عبر Unix Domain Socket. في البيئة المحلية، الاتصال عبر Socket غالبًا أسرع وأعلى أمانًا، ويمكنك اختيار الأنسب لك.

س: هل يمكنني إدارة قواعد بيانات غير مدمجة في ServBay عبر Adminer؟

ج: Adminer تدعم أنواعًا متعددة من قواعد البيانات. إذا قمت بتثبيت قاعدة بيانات خارج ServBay (مثل MongoDB منفصلة أو قاعدة بيانات عن بعد)، يمكنك نظريًا استخدام ملف Adminer ضمن ServBay للاتصال بها بشرط توفر اتصال الشبكة وبيانات الدخول الصحيحة، لكن قيمة دمج Adminer الأكبر تكمن في إدارة قواعد بيانات ServBay الداخلية.

الملخص

Adminer أداة قوية وسهلة الاستخدام يوفرها ServBay وتتميز بخفة الحجم ودعمها لعدة أنواع قواعد بيانات. تسهّل إدارة قواعد بيانات MariaDB/MySQL وPostgreSQL وSQLite في بيئة تطويرك المحلية إلى حد بعيد. باتباع الإرشادات السابقة، ستكون قادرًا على الاتصال بقواعد البيانات وإدارة بياناتك اليومية بسلاسة وكفاءة عالية عبر Adminer.