يعد ربط MongoDB مع Node.js مهارة حاسمة لمطوري الويب المعاصرين. في هذا الدليل، سنرشدك خلال العملية خطوة بخطوة، مما يضمن أنه يمكنك بسهولة دمج هذه التقنيات القوية.

مقدمة

تشتهر MongoDB، وهي قاعدة بيانات NoSQL رائدة، بمرونتها وقابلية التوسع. يمكنك إنشاء تطبيقات ويب فعالة وقابلة للتطوير باستخدام Node.js، وهو وقت تشغيل JavaScript قوي. دعونا نتعمق في الخطوات اللازمة لإجراء هذا الاتصال بسلاسة.

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

1. المتطلبات الأساسية
2. إعداد MongoDB
3. بدء مشروع Node.js
4. الاتصال بـ MongoDB باستخدام Mongoose
5. اختبار الاتصال
6. خاتمة

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

• الفهم الأساسي لجافا سكريبت وNode.js.
• تم تثبيت Node.js وnpm (Node Package Manager) على نظامك.
• حساب MongoDB وخادم MongoDB المحلي/البعيد.

2. إعداد MongoDB

ابدأ بتثبيت MongoDB على جهازك أو إعداد مثيل سحابي عبر MongoDB Atlas. احفظ سلسلة الاتصال الخاصة بك، حيث ستحتاج إليها قريبًا.

إعداد MongoDB على MongoDB Atlas

2.1 التسجيل أو تسجيل الدخول

• انتقل إلى موقع MongoDB Atlas: https://www.mongodb.com/cloud/atlas
• إذا كنت جديدًا في MongoDB Atlas، فقم بالتسجيل للحصول على حساب جديد. بخلاف ذلك، قم بتسجيل الدخول باستخدام بيانات الاعتماد الخاصة بك.

2.2 إنشاء مجموعة جديدة

• بمجرد تسجيل الدخول، انقر على زر "إنشاء مجموعة جديدة".
• يقدم MongoDB Atlas طبقة مجانية تُعرف باسم M0 Sandbox. هذه نقطة انطلاق جيدة للمبتدئين أو المشاريع الصغيرة.

2.3 اختر موفر السحابة والمنطقة

• حدد موفر السحابة المفضل لديك (AWS أو Google Cloud أو Azure).
• اختر المنطقة. تدعم بعض المناطق الطبقة المجانية، لذا تأكد من اختيار المنطقة الأقرب إلى قاعدة المستخدمين الأساسية لديك لتقليل زمن الاستجابة.

2.4 تكوين إعدادات المجموعة

• على الرغم من أن الإعدادات الافتراضية مناسبة لمعظم حالات الاستخدام، إلا أنه يمكنك تعديل اسم المجموعة والإعدادات الأخرى إذا لزم الأمر.

2.5 إضافة تكوين إضافي (اختياري)

• ضمن الإعدادات الإضافية، يمكنك تكوين النسخ الاحتياطية، أو تمكين المراقبة، أو إجراء تكوينات متقدمة أخرى. بالنسبة لمعظم المبتدئين، الإعدادات الافتراضية كافية.

2.6 إعداد الوصول إلى الشبكة

• انقر على قسم "الوصول إلى قاعدة البيانات" في اللوحة اليمنى.
• إضافة مستخدم جديد باسم مستخدم وكلمة مرور قوية. تذكر بيانات الاعتماد هذه لأنك ستحتاج إليها لتوصيل تطبيقك بـ MongoDB.
• ضمن علامة التبويب "القائمة البيضاء لـ IP"، انقر فوق "إضافة عنوان IP". لأغراض أمنية، قم فقط بإضافة عناوين IP التي تحتاج إلى الوصول إلى القائمة البيضاء. لأغراض التطوير، يمكنك اختيار "السماح بالوصول من أي مكان"، ولكن لا يُنصح بذلك لبيئات الإنتاج بسبب مخاوف أمنية.

2.7 احصل على سلسلة الاتصال الخاصة بك

• بمجرد تشغيل المجموعة، انقر على زر "الاتصال".
• اختر "ربط التطبيق الخاص بك".
• حدد إصدار برنامج التشغيل الخاص بك وانسخ سلسلة الاتصال. هذه هي السلسلة التي ستستخدمها في تطبيقك للاتصال بـ MongoDB. استبدل في سلسلة الاتصال كلمة المرور لمستخدم MongoDB الذي قمت بإنشائه مسبقًا.

2.8 قم بتوصيل التطبيق الخاص بك

• استخدم سلسلة الاتصال المنسوخة في تطبيقك لبدء التفاعل مع مثيل MongoDB السحابي الخاص بك.

2.9 المراقبة والإدارة

• يوفر MongoDB Atlas لوحة تحكم حيث يمكنك مراقبة الاستعلامات والأداء والمقاييس الأخرى. تحقق من ذلك بانتظام لضمان صحة وأداء قاعدة البيانات الخاصة بك.

3. بدء مشروع Node.js

في المحطة الطرفية أو موجه الأوامر:

mkdir mongo-node-connection
cd mongo-node-connection
npm init -y

يقوم الكود أعلاه بإنشاء مشروع Node.js جديد.

4. الاتصال بـ MongoDB باستخدام Mongoose

Mongoose هو ODM (Object Document Mapper) الشهير الذي يسهل الاتصال بين Node.js وMongoDB.

تثبيت النمس:

npm install mongoose

الاتصال بـ MongoDB:

const mongoose = require('mongoose');

// Your MongoDB connection string
const dbURI = 'YOUR_MONGODB_CONNECTION_STRING';

mongoose.connect(dbURI, { useNewUrlParser: true, useUnifiedTopology: true })
  .then(() => console.log('Connected to MongoDB'))
  .catch((error) => console.error('Connection error', error));

ملاحظة: استبدل 'YOUR_MONGODB_CONNECTION_STRING' بسلسلة اتصال MongoDB الفعلية.

5. اختبار الاتصال

للتحقق من الاتصال:

• إنشاء مخطط ونموذج بسيط باستخدام Mongoose.
• أدخل مستندًا في مجموعة MongoDB.
• جلب المستند وتسجيله إلى وحدة التحكم.

const testSchema = new mongoose.Schema({
  name: String,
  testField: String
});

const TestModel = mongoose.model('Test', testSchema);

const testData = new TestModel({
  name: 'Node-Mongo Connection Test',
  testField: 'It works!'
});

testData.save()
  .then(doc => {
    console.log('Test document saved:', doc);
  })
  .catch(error => {
    console.error('Error saving test document:', error);
  });

قم بتشغيل البرنامج النصي Node.js الخاص بك، وإذا تم إعداد كل شيء بشكل صحيح، فيجب أن ترى مستند الاختبار الخاص بك مسجلاً في وحدة التحكم.

6. الاستنتاج

يمكن أن يؤدي ربط MongoDB مع Node.js إلى تحسين تطبيقات الويب الخاصة بك من خلال توفير حل قاعدة بيانات قوي. باتباع هذا الدليل، تكون قد قمت بإعداد اتصال أساسي باستخدام Mongoose، مما يمهد الطريق لمزيد من العمليات والاستعلامات المتقدمة في المستقبل.