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

نظرة عامة

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

ما هو Adminer

Adminer أداة إدارة قواعد بيانات مكتوبة بلغة PHP وتعمل كملف واحد فقط، تدعم العديد من أنواع قواعد البيانات مثل MySQL، MariaDB، PostgreSQL، SQLite، وMongoDB. وتتفوق على بعض عملاء إدارة قواعد البيانات الضخمة بالعديد من الميزات البارزة:

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

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

الوصول إلى Adminer

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

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 أو استخدم مسار Unix Socket المقدم بواسطة ServBay /Applications/ServBay/tmp/mysql.sock. يكون الاتصال عبر Socket عادةً أسرع.
   • اسم المستخدم: اعثر عليه في قسم "قواعد البيانات" في تطبيق ServBay.
   • كلمة المرور: أيضًا موجودة في نفس القسم بتطبيق ServBay.
   • قاعدة البيانات: (اختياري) أدخل اسم قاعدة بيانات معينة أو اتركها فارغة لعرض جميع القواعد بعد تسجيل الدخول.
4. اضغط على زر تسجيل الدخول.

الاتصال بـ PostgreSQL

ServBay يدعم كذلك PostgreSQL؛ عليك فقط اختيار النوع "PostgreSQL" في Adminer.

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

الاتصال بـ SQLite 3

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

1. افتح المتصفح وادخل إلى Adminer (https://servbay.host/adminer.php).
2. اختر SQLite 3 من قائمة النظام.
3. أدخل مسار ملف قاعدة البيانات:
   • ملف قاعدة البيانات: أدخل المسار الكامل لملف 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. أدخل اسم الجدول وعرّف الأعمدة (اسم العمود، نوع البيانات، الطول، السماح بـNULL، القيمة الافتراضية، الفهارس: المفتاح الأساسي/الفريد/العادي...).
4. اضغط على حفظ لإنشاء الجدول.
5. بعد ذلك، اختر الجدول من القائمة الجانبية أو الصفحة الرئيسية.
6. نفذ عمليات البيانات:
   • إدخال: إضافة صفوف جديدة.
   • تحديد: عرض، بحث، فرز وتصفية البيانات الحالية.
   • تحديث: تعديل صفوف بيانات.
   • حذف: حذف صفوف.
   • استخدم أوامر SQL لاستعلامات وعمليات أكثر تقدّمًا.

تنفيذ أوامر SQL

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

1. اختر قاعدة البيانات التي تريد تنفيذ الأمر عليها.
2. انقر على خيار أوامر SQL.
3. أدخل تعليمات SQL في المربع النصي.
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 الكتابة والقراءة فيه، ويفضل استخدام مجلد البيانات: /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 أسرع وأكثر أمانًا من TCP/IP، ويمكنك اختيار الأنسب لك.

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

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

ملخص

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