Connecter MongoDB à Node.js est une compétence cruciale pour les développeurs Web modernes. Dans ce guide, nous vous guiderons pas à pas tout au long du processus, afin que vous puissiez facilement intégrer ces technologies puissantes.

Introduction

MongoDB, une base de données NoSQL leader, est réputée pour sa flexibilité et son évolutivité. Vous pouvez créer des applications Web efficaces et évolutives avec Node.js, un puissant moteur d'exécution JavaScript. Passons en revue les étapes permettant d'établir cette connexion de manière transparente.

Table des matières

1. Conditions préalables
2. Configuration de MongoDB
3. Lancement d'un projet Node.js
4. Connexion à MongoDB à l'aide de Mongoose
5. Test de la connexion
6. Conclusion

1. Conditions préalables

• Compréhension de base de JavaScript et de Node.js.
• Node.js et npm (Node Package Manager) sont installés sur votre système.
• Un compte MongoDB et un serveur MongoDB local/distant.

2. Configuration de MongoDB

Commencez par installer MongoDB sur votre machine ou configurez une instance cloud via MongoDB Atlas. Enregistrez votre chaîne de connexion, car vous en aurez besoin sous peu.

Configuration de MongoDB sur MongoDB Atlas

2.1 S'inscrire ou se connecter

• Accédez au site Web MongoDB Atlas : https://www.mongodb.com/cloud/atlas
• Si vous êtes nouveau sur MongoDB Atlas, créez un nouveau compte. Sinon, connectez-vous avec vos identifiants.

2.2 Créer un nouveau cluster

• Une fois connecté, cliquez sur le bouton « Créer un nouveau cluster ».
• MongoDB Atlas propose un niveau gratuit connu sous le nom de M0 Sandbox. C'est un bon point de départ pour les débutants ou les petits projets.

2.3 Choisissez un fournisseur de cloud et une région

• Sélectionnez votre fournisseur de cloud préféré (AWS, Google Cloud ou Azure).
• Choisissez une région. Certaines régions prennent en charge l'offre gratuite, alors assurez-vous de choisir la région la plus proche de votre base d'utilisateurs principale afin de réduire la latence.

2.4 Configurer les paramètres du cluster

• Bien que les paramètres par défaut conviennent à la plupart des cas d'utilisation, vous pouvez modifier le nom du cluster et d'autres paramètres si nécessaire.

2.5 Ajouter une configuration supplémentaire (facultatif)

• Sous paramètres supplémentaires, vous pouvez configurer des sauvegardes, activer la surveillance ou effectuer d'autres configurations avancées. Pour la plupart des débutants, les paramètres par défaut sont suffisants.

2.6 Configurer l'accès au réseau

• Cliquez sur la section « Accès à la base de données » dans le panneau de gauche.
• Ajoutez un nouvel utilisateur avec un nom d'utilisateur et un mot de passe fort. N'oubliez pas ces informations d'identification car vous en aurez besoin pour connecter votre application à MongoDB.
• Sous l'onglet « Liste blanche IP », cliquez sur « Ajouter une adresse IP ». Pour des raisons de sécurité, ajoutez uniquement aux adresses IP auxquelles vous avez besoin d'accéder. À des fins de développement, vous pouvez choisir « Autoriser l'accès depuis n'importe où », mais cela n'est pas recommandé pour les environnements de production en raison de problèmes de sécurité.

2.7 Obtenez votre chaîne de connexion

• Une fois le cluster opérationnel, cliquez sur le bouton « CONNECT ».
• Choisissez « Connecter votre application ».
• Sélectionnez la version de votre pilote et copiez la chaîne de connexion. C'est la chaîne que vous utiliserez dans votre application pour vous connecter à MongoDB. Remplacez la chaîne de connexion par le mot de passe de l'utilisateur MongoDB que vous avez créé précédemment.

2.8 Connectez votre application

• Utilisez la chaîne de connexion copiée dans votre application pour commencer à interagir avec votre instance cloud MongoDB.

2.9 Surveiller et gérer

• MongoDB Atlas fournit un tableau de bord dans lequel vous pouvez surveiller les requêtes, les performances et d'autres mesures. Vérifiez-le régulièrement pour garantir la santé et les performances de votre base de données.

3. Lancement d'un projet Node.js

Dans votre terminal ou invite de commande :

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

Le code ci-dessus crée un nouveau projet Node.js.

4. Connexion à MongoDB à l'aide de Mongoose

Mongoose est un ODM (Object Document Mapper) populaire qui facilite la connexion entre Node.js et MongoDB.

Installer la mangouste :

npm install mongoose

Connectez-vous à 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));

Remarque : remplacez 'YOUR_MONGODB_CONNECTION_STRING' par votre chaîne de connexion MongoDB réelle.

5. Test de la connexion

Pour vérifier la connexion :

• Créez un schéma et un modèle simples à l'aide de Mongoose.
• Insérez un document dans la collection MongoDB.
• Récupérez et enregistrez le document sur la console.

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);
  });

Exécutez votre script Node.js, et si tout est correctement configuré, vous devriez voir votre document de test enregistré dans la console.

6. Conclusion

La connexion de MongoDB à Node.js peut améliorer vos applications Web en fournissant une solution de base de données robuste. En suivant ce guide, vous avez établi une connexion fondamentale à l'aide de Mongoose, ouvrant la voie à des opérations et des requêtes plus avancées à l'avenir.