NodeJS یک محیط اجرای جاوااسکریپتی است که امکان ساخت سرویس‌های مقیاس‌پذیر و منعطفی را در اختیارتان قرار می‌دهد. این محیط، از دیتابیس‌های مختلفی از جمله MySQL پشتیبانی می‌کند. شما می‌توانید به‌راحتی اپلیکیشن NodeJS خود را به MySQL مدیریت‌شده‌ی آروان‌کلاد متصل کنید.

در این راهنما، پس از نصب NodeJS، یک پروزه‌ی نمونه می‌سازیم و با استفاده از کتاب‌خانه‌ی mysql2 آن را به دیتابیس ابری آروان متصل می‌کنیم.

پیش‌نیازها

پیش از شروع لازم است:

گام نخست: نصب NodeJS

برای نصب NodeJS روی سرور می‌توانید بر اساس سیستم‌عامل‌تان از لینک زیر استفاده کنید:

در این راهنما روش نصب NodeJS در Ubuntu 22.04 را بررسی خواهیم کرد.

پس از اتصال به سرور از طریق SSH، دستور زیر را اجرا کنید:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

این دستور ‍nvm را که یک ابزار برای مدیریت نسخه‌ی NodeJS است نصب می‌‌کند.

سپس برای نصب NodeJS، از دستور زیر استفاده کنید:

nvm install 20

این کامند NodeJS را دریافت و نصب می‌کند. توجه داشته باشید ممکن است پیش از اجرای این دستور نیاز به راه‌اندازی مجدد ترمینال داشته باشید.

در پایان برای بررسی صحت فرآیند نصب، این دستورها را اجرا کنید:

node -v
npm -v

خروجی این دستورها، نسخه‌‌ی محیط‌های NodeJS و npm است.

گام دوم: راه‌اندازی پروژه

یک دایرکتوری جدید برای پروژه بسازید:

mkdir project

وارد دایرکتوری project شوید:

cd project

با استفاده از npm مقداردهی اولیه‌ی پروژه را انجام دهید:

npm init -y

دستور بالا یک فایل جدید به نام package.json ایجاد می‌کند که شامل جزییات و وابستگی‌های پروژه است.

پس از آن وابستگی‌های پروژه را نصب کنید:

npm i mysql2 dotenv

این دستور، کتابخانه‌ها‌ی mysql2 و dotenv را که به اپلیکیشن NodeJS اجازه می‌دهد با دیتابیس MySQL ارتباط برقرار کند، نصب می‌کند.

در گام بعد، فایل package.json را باز کرده و بررسی کنید که تمام وابستگی‌های مورد نیاز نصب شده‌اند:

cat package.json

خروجی باید مشابه زیر باشد:

"dependencies": {
    "dotenv": "^16.3.1",
    "mysql2": "^3.6.0"
}

سپس فایل اصلی یا index.js پروژه را ایجاد کنید:

touch index.js

با استفاده از ویرایشگری مانند Nano، یک فایل 

env.
ایجاد کنید تا اطلاعات دیتابیس را ذخیره کنید:

nano .env

متغیرهای زیر را در فایل اضافه کنید. مقادیر نمونه را با جزئیات اتصال دیتابیس MySQL مدیریت‌شده‌ی آروان جایگزین کنید:

DB_HOSTNAME = example.db.arvandbaas.ir
DB_PORT = 3306
DB_USER = base-user
DB_PASSWORD = 'password'
DB_NAME = default

فایل را ذخیره کرده و ببندید.

اتصال به دیتابیس

برای اتصال اپلیکیشن NodeJS به دیتابیس MySQL، از کتابخانه‌ی mysql2 و فایل env. استفاده می‌کنیم.

فایل index.js را باز کرده و ویرایش کنید:

nano index.js

کد زیر را به فایل اضافه کنید:

require('dotenv').config();
const mysql = require('mysql2');

const dbConfig = {
    host: process.env.DB_HOSTNAME,
    port: process.env.DB_PORT,
    user: process.env.DB_USER,
    password: process.env.DB_PASSWORD,
    database: process.env.DB_NAME,
};

let db;
const connectToDB = async () => {
    const pool = mysql.createPool(dbConfig);
    const poolPromise = pool.promise();

    return poolPromise;
};

const main = async () => {
    db = await connectToDB();
    console.log('Connected to database');
};

main();

فایل index.js بالا، اپلیکیشن NodeJS شما را به دیتابیس MySQL متصل کرده و اجرای عملیات‌ CRUD را ممکن می‌کند.

برای اجرای فایل index.js و شروع اپلیکیشن Node.js، دستور زیر را اجرا کنید:

node index.js

اگر تنظیمات به‌درستی اعمال شده باشند، باید خروجی زیر را دریافت کنید:

Connected to database

ارتباط با دیتابیس

برای بررسی عملکرد اپلیکیشن NodeJS، می‌توانید یک جدول جدید ایجاد کرده و عملیات‌ CRUD را با استفاده از دستورهای SQL انجام دهید.

ایجاد جدول جدید

فایل index.js را باز کنید:

nano index.js

قبل از دستور ;return poolPromise در متد ()connectToDB، یک کوئری SQL اضافه کنید که یک جدول جدید به نام posts ایجاد کند:

const connectToDB = async () => {
    const pool = mysql.createPool(dbConfig);
    const poolPromise = pool.promise();

    await poolPromise.query("CREATE TABLE IF NOT EXISTS `posts` (`id` int NOT NULL AUTO_INCREMENT, `title` varchar(255) NOT NULL, `body` varchar(255) NOT NULL, `author` varchar(255), PRIMARY KEY (`id`) );");

    const [allPosts, fields] = await poolPromise.query('SELECT * FROM posts;');
    console.log(`Posts Table: ${JSON.stringify({ allPosts, fields })}`);

    return poolPromise;
};

فایل را ببندید و ذخیره کنید. سپس اپلیکیشن را اجرا کنید:

node index.js

خروجی باید مشابه زیر باشد:

34,0]},"_clientEncoding":"utf8","_catalogLength":3,"_catalogStart":167,"_schemaLength":9,"_schemaStart":171,"_tableLength":5,"_tableStart":181,"_orgTableLength":5,"_orgTableStart":187,"_orgNameLength":6,"_orgNameStart":200,"characterSet":224,"encoding":"utf8","name":"author","columnLength":1020,"columnType":253,"type":253,"flags":0,"decimals":0}]}

 Connected to database

ایجاد یک پست جدید

فایل index.js را ویرایش کنید:

nano index.js

یک متد جدید به نام ()createNewPost تعریف کنید تا یک پست جدید در جدول posts ایجاد کند:

const createNewPost = async (postData) => {
    const { title, body, author } = postData;
    const [newPost, fields] = await db.query('INSERT INTO posts (title, body, author) VALUES (?,?,?);', [title, body, author]);
    console.log(`New post created: ${JSON.stringify(newPost)}`);
};

متد ()createNewPost را با داده‌های مثال در متد ()main فراخوانی کنید تا یک پست جدید ایجاد شود:

await createNewPost({ title: "Test Title", body: "This is the return of test body.", author: "Tommy Shelby" });

فایل را ببندید و ذخیره کنید. سپس اپلیکیشن را اجرا کنید:

node index.js

خروجی باید مشابه زیر باشد:

New post created: {"fieldCount":0,"affectedRows":1,"insertId":4,"info":"","serverStatus":2,"warningStatus":0,"changedRows":0}

دریافت یک پست با ID

فایل index.js را ویرایش کنید:

nano index.js

یک متد جدید به نام ()getPostById اضافه کنید که داده‌های یک پست را با استفاده از id دریافت کند:

const getPostById = async (postId) => {
    const [post, fields] = await db.query('SELECT * FROM posts WHERE id=?;', [postId]);
    console.log(`Post: ${JSON.stringify(post)}`);
};

در متد ()main، متد ()getPostById را با یک postId فراخوانی کنید تا داده‌های پست دریافت شود:

await getPostById(1);

فایل را ببندید و ذخیره کنید. سپس اپلیکیشن را اجرا کنید:

node index.js

خروجی باید مشابه زیر باشد:

Post: [{"id":1,"title":"Test Title","body":"This is the return of test body.","author":"Tommy Shelby"}]

به‌روزرسانی یک پست با ID

فایل index.js را ویرایش کنید:

nano index.js

یک متد جدید به نام ()updatePostById اضافه کنید که پست را به‌روزرسانی کند:

const updatePostById = async (postId, postData) => {
    const { title, body } = postData;
    const [updatePost, fields] = await db.query('UPDATE posts SET title=?, body=? WHERE id=?;', [title, body, postId]);
    console.log(`Post updated: ${JSON.stringify(updatePost)}`);
};

در متد ()main، متد ()updatePostById را با یک postId موجود و داده‌های جدید فراخوانی کنید. برای مثال:

await updatePostById(1, { title: 'Updated Title', body: "This is updated post body" });

فایل را ببندید و ذخیره کنید. سپس اپلیکیشن را اجرا کنید:

node index.js

خروجی باید مشابه زیر باشد:

Post updated: {"fieldCount":0,"affectedRows":1,"insertId":0,"info":"Rows matched: 1  Changed: 0  Warnings: 0","serverStatus":2,"warningStatus":0,"changedRows":0}

حذف یک پست با ID

فایل index.js را ویرایش کنید:

nano index.js

یک متد جدید به نام ()deletePostById اضافه کنید که یک پست را با id حذف کند:

const deletePostById = async (postId) => {
    const [post, fields] = await db.query('DELETE FROM posts WHERE id=?;', [postId]);
    console.log(`Post deleted : ${JSON.stringify(post)}`);
};

در متد ()main، متد ()deletePostById را برای حذف یک پست فراخوانی کنید. برای مثال، پست با آی‌دی 2 را حذف کنید:

await deletePostById(2);

فایل را ببندید و ذخیره کنید. سپس اپلیکیشن را اجرا کنید:

node index.js

خروجی باید مشابه زیر باشد:

Post deleted : {"fieldCount":0,"affectedRows":1,"insertId":0,"info":"","serverStatus":2,"warningStatus":0,"changedRows":0}

برای آشنایی بیش‌تر با شیوه‌ی استفاده از کتابخانه‌ی mysql2 در NodeJS، مستندات MySQL2 را بررسی کنید.