ضبط إعدادات قاعدة بيانات MariaDB في ServBay

يتيح ServBay للمطورين بيئة تطوير ويب محلية قوية تشمل قاعدة بيانات MariaDB مدمجة وسهلة الإدارة. توضح هذه الوثيقة بالتفصيل كيفية تعديل إعدادات MariaDB في ServBay، مع التركيز على الطريقة الموصى بها عبر واجهة ServBay الرسومية، كما تشرح دور ملف التكوين وبعض الخيارات الشائعة.

الجمهور المستهدف: مطورو الويب الذين يستخدمون ServBay في التطوير المحلي، خصوصًا من يحتاج لتخصيص سلوك قاعدة بيانات MariaDB.

نظرة عامة

تحدد إعدادات MariaDB طريقة عمل خادم قاعدة البيانات، مثل الاستماع إلى الشبكة، وقيود الاتصالات، وأحجام التخزين المؤقت، وتفعيل السجلات وغير ذلك. من خلال ServBay، يمكنك تعديل هذه الإعدادات بسهولة عبر واجهة المستخدم الرسومية دون الحاجة لتحرير ملفات التكوين المعقدة يدويًا. ورغم أن ملفات التكوين (مثل my.cnf) هي الطريقة القياسية لضبط إعدادات MariaDB، إلا أنه في بيئة ServBay نوصي بشدة باستخدام الواجهة الرسومية لضمان الاستقرار وديمومة التغييرات.

حسب إصدار MariaDB، يكون ملف التكوين غالبًا في مجلد تثبيت ServBay تحت المسار /Applications/ServBay/etc/mariadb/<version>.

تنبيه هام: الأفضلية لاستخدام واجهة ServBay

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

تعديل الإعدادات عبر واجهة ServBay (موصى به)

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

1. افتح واجهة إدارة ServBay: شغّل تطبيق ServBay.

2. انتقل إلى إعدادات قواعد البيانات: من الشريط الجانبي الأيسر في ServBay، افتح قائمة قواعد البيانات ثم اختر MariaDB.

3. اختر إصدار MariaDB: إذا كان لديك عدة إصدارات مثبتة من MariaDB، اختر الإصدار الذي ترغب في ضبط إعداداته.

4. عدّل معايير التكوين: من خلال واجهة MariaDB يمكنك ضبط العديد من الخيارات، مثل:

   • اسم المستخدم الافتراضي وكلمة مرور Root: يمكنك عرض أو (في بعض الإصدارات) إعادة تعيين كلمة مرور المستخدم root الافتراضية.
   • عنوان الاستماع (bind-address): يتحكم في واجهات الشبكة التي تستمع إليها MariaDB. يكون الافتراضي غالبًا 0.0.0.0 (أي جميع الواجهات، شاملًا الاتصالات المحلية وربما البعيدة في حال سمحت إعدادات جدار الحماية بذلك). يمكنك تعيينها إلى 127.0.0.1 أو localhost لاقتصار الاتصال على الجهاز المحلي فقط.
   • المنفذ (port): يسمح لك بضبط منفذ الاتصال بـ MariaDB، والقيمة الافتراضية هي 3306.
   • أقصى عدد للاتصالات (max_connections): لتحديد الحد الأعلى لعدد العملاء المتصلين في آن واحد. اختر القيمة وفقًا لاحتياجات تطبيقك وموارد النظام.
   • أقصى حجم للحزمة الواحدة (max_allowed_packet): يحدد أقصى حجم لرسالة بيانات مفردة، ما يؤثر على حجم استعلامات SQL (خصوصًا عند التعامل مع بيانات BLOB كبيرة).
   • تفعيل سجل الاستعلامات البطيئة (slow_query_log): لتفعيل تسجيل الاستعلامات ذات الأداء المنخفض من أجل التشخيص والتحسين.
   • ملف سجل الاستعلامات البطيئة (slow_query_log_file): لتحديد مسار ملف السجل (عادة ضمن /Applications/ServBay/logs/mariadb/).
   • حد الزمن للاستعلامات البطيئة (long_query_time): الزمن (بالثواني) الذي إذا تجاوزه الاستعلام يُسجّل في سجل الاستعلامات البطيئة.
   • حجم تجمع المتغيرات المؤقتة (innodb_buffer_pool_size): واحد من أهم خيارات InnoDB لتخزين بيانات الجداول والفهارس مؤقتًا. زيادته الملائمة ترفع الأداء بشكل ملحوظ ولكنها تستهلك ذاكرة أكبر.
   • المجموعة والضبط الافتراضي للأحرف (character-set-server, collation-server): يحدد الإعداد الافتراضي لترميز الأحرف ومقارنة القيم النصية. الترميز الموصى به هو utf8mb4 لدعم أفضل، شاملاً رموز الإيموجي وغيرها.

5. احفظ وطبّق التعديلات: بعد إجراء التعديلات، اضغط زر حفظ أسفل الواجهة. سيقوم ServBay بتحديث التكوين تلقائيًا وإعادة تحميل أو تشغيل خدمة MariaDB في الخلفية لتصبح التغييرات فعّالة فورًا.

توضيح: واجهة ضبط إعدادات MariaDB من خلال ServBay UI

التعديل عبر تحرير ملفات التكوين يدويًا (غير موصى به - للتجارب المؤقتة فقط)

رغم عدم التوصية بذلك، إلا أن معرفة أماكن وهيكلية ملفات MariaDB تفيد في حالات التصحيح المؤقتة أو الفهم الأعمق لنظام التكوين.

تنبيه المخاطر : التعديلات اليدوية معرضة للفقدان

أي تعديل يدوي لملفات التكوين التي يديرها ServBay (مثل my.cnf) غير موصى به، إذ من الممكن أن يعيد ServBay إنشاء هذه الملفات عند إدارة الخدمات أو تحديثها، وستُفقد بذلك التعديلات التي قمت بها يدويًا. استخدم دومًا واجهة ServBay لضبط التكوينات الدائمة، وإذا اضطررت لتعديل يدوي فكن على علم بأنه مؤقت وحاول البحث عن خيارات تعبئة مخصصة عبر الواجهة لضمان البقاء.

موقع ملف التكوين

الملف الرئيسي لإعدادات MariaDB في ServBay هو my.cnf، ويختلف مساره حسب إصدار MariaDB.

• الملف الرئيسي: /Applications/ServBay/etc/mariadb/<version>/my.cnf

على سبيل المثال، الجملة الخاصة بإصدار MariaDB 11.5 ستكون: /Applications/ServBay/etc/mariadb/11.5/my.cnf.

بنية ملف my.cnf وأهم إعداداته الشائعة

my.cnf هو ملف نصي بتنسيق INI، وتوزع الإعدادات ضمن أقسام [section] مختلفة، أهمها لمهام الخادم هو القسم [mysqld].

فيما يلي أمثلة لبعض الإعدادات شائعة الاستخدام (وتقابل الخيارات الظاهرة في الواجهة الرسومية):

1. تعديل عنوان الاستماع (bind-address)

   [mysqld]
   bind-address = 0.0.0.0

   تعيين القيمة إلى 0.0.0.0 يسمح بالاتصالات من أي واجهة شبكة، بينما 127.0.0.1 أو localhost يتيح الاتصالات المحلية فقط.

2. تعديل المنفذ (port)

   [mysqld]
   port = 3306

   رقم المنفذ الذي تستمع عليه خدمة MariaDB.

3. تعديل الحد الأقصى للاتصالات (max_connections)

   [mysqld]
   max_connections = 200

   الحد الأقصى لعدد العملاء المتصلين في نفس الوقت.

4. تغيير حجم تجمع الذاكرة المؤقتة لـInnoDB (innodb_buffer_pool_size)

   [mysqld]
   innodb_buffer_pool_size = 256M

   حجم الذاكرة المؤقتة لتخزين البيانات والفهارس لدى InnoDB. الوحدات: K أو M أو G.

5. تعديل مسار سجل الأخطاء (log_error)

   [mysqld]
   log_error = /Applications/ServBay/logs/mariadb/error.log

   يحدد موقع ملف سجل أخطاء MariaDB.

6. تفعيل سجل الاستعلامات البطيئة وإعداداته (slow_query_log, slow_query_log_file, long_query_time)

   [mysqld]
   slow_query_log = 1
   slow_query_log_file = /Applications/ServBay/logs/mariadb/slow.log
   long_query_time = 2  # بوحدة الثانية، يتم تسجيل الاستعلامات التي تتجاوز هذا الزمن

   slow_query_log = 1 لتشغيل السجل، slow_query_log_file يحدد اسم ملف السجل، وlong_query_time يحدد حد الزمن.

7. تغيير الإعداد الافتراضي لترميز الأحرف والقواعد (character-set-server, collation-server)

   [mysqld]
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci

   يعين الترميز والترتيب الافتراضي على مستوى الخادم.

تطبيق التعديلات: إعادة تشغيل خدمة MariaDB

سواءً قمت بالحفظ عبر واجهة ServBay أو أجريت تعديلًا يدويًا (غير موصى به)، غالبًا ستحتاج لإعادة تشغيل خدمة MariaDB ليتم تطبيق الإعدادات الجديدة بالكامل. ServBay يوفر طريقتين سهلتين لإعادة التشغيل.

إعادة التشغيل من خلال واجهة إدارة ServBay

إليك أسهل طريقة:

1. افتح واجهة إدارة ServBay.
2. من الشريط الجانبي، افتح قائمة الحزم (لاحظ: في الإصدارات القديمة تظهر كـ الخدمات).
3. حدد حزمة MariaDB ذات الإصدار المطلوب.
4. اضغط على زر إعادة التشغيل المجاور لها.

إعادة التشغيل عبر أداة الأوامر servbayctl

servbayctl هي أداة سطر أوامر تقدمها ServBay لإدارة الحزم والخدمات.

افتح تطبيق الطرفية ونفّذ الأمر التالي لإعادة تشغيل خدمة MariaDB لإصدار معين:

servbayctl restart mariadb <version>

استبدل <version> برقم إصدار MariaDB الحقيقي الذي تستخدمه، مثلًا 11.5.

# مثال: إعادة تشغيل MariaDB إصدار 11.5
servbayctl restart mariadb 11.5

الأسئلة المتكررة (FAQ)

س: لماذا يوصي ServBay بتعديل الإعدادات عبر الواجهة الرسومية بدلاً من تحرير ملف my.cnf يدويًا؟

ج: ServBay هو مدير تكامل بيئة تطوير محلية، إذ يدير إعدادات الحزم البرمجية عبر واجهة UI ويقوم بإنشاء أو تحديث ملفات التكوين تلقائيًا بناءً على اختياراتك. إذا عدلت my.cnf يدويًا، يمكن أن تتم إعادة ضبط تغييراتك عند ترقية أو إعادة تشغيل الخدمة أو حفظ أي إعداد آخر عبر الواجهة. استخدام الواجهة الرسومية يضمن ثبات وديمومة الإعدادات واتساق البيئة.

س: هل يمكن ضبط جميع معايير MariaDB عبر واجهة ServBay الرسومية؟

ج: توفر واجهة ServBay معظم الخيارات الحيوية التي يحتاجها المطورون عادةً. بالنسبة للإعدادات المتقدمة جدًا أو النادرة، قد تضطر لتعديل الملف يدويًا بغرض التجربة المؤقتة. في هذه الحالة، حاول قدر الإمكان استخدام خاصية "الإعدادات الإضافية" ضمن الواجهة لإضافة معايير مخصصة، وكن على علم بأن التعديلات اليدوية مؤقتة.

س: أين أجد سجلات أخطاء MariaDB وسجلات الاستعلامات البطيئة ضمن ServBay؟

ج: وفقًا للتكوين الافتراضي وبنية ملفات ServBay، توجد السجلات غالبًا بمجلد /Applications/ServBay/logs/mariadb/. يمكنك التحقق من المسارات الفعلية عبر واجهة ServBay أو من ملف my.cnf.

الخلاصة

أفضل وأأمن طريقة لضبط إعدادات قاعدة بيانات MariaDB في ServBay هي عبر واجهة المستخدم الرسومية المخصصة. يمكنك تعديل الخيارات الأساسية مثل عنوان الاستماع والمنفذ وعدد الاتصالات والسجلات بسهولة مع ضمان ديمومة التغييرات ضمن إدارة ServBay. أما التعديلات اليدوية لملف my.cnf المباشر في المسار /Applications/ServBay/etc/mariadb/<version>/my.cnf فهي معرضة للفقدان ومخصصة للتجربة المؤقتة فقط. عند إجراء تغييرات يُمكنك إعادة تشغيل الخدمة بسهولة عبر واجهة ServBay أو الأداة الطرفية servbayctl. استيعاب هذه الخيارات يتيح لك تحسين أداء MariaDB وسلوكها في بيئة التطوير المحلية بأفضل شكل.