Node.js: أول خادم
Node.js يشغّل JavaScript خارج المتصفح، على جهازك أو على خادم. بهذا تستعمل نفس اللغة للواجهة والخادم معًا.
تثبيت Node.js و npm
حمّل النسخة LTS من الموقع الرسمي nodejs.org؛ هي الأكثر استقرارًا. يأتي معها npm، مدير الحزم الذي تثبّت به المكتبات. تأكد من التثبيت:
node -v
npm -v
ثم أنشئ مشروعًا جديدًا:
mkdir tasks-api
cd tasks-api
npm init -y
الأمر الأخير ينشئ package.json، بطاقة هوية المشروع: اسمه، ومكتباته، وأوامره.
أول خادم HTTP
افتح package.json وأضف السطر "type": "module" لتستعمل import الحديثة، ثم أنشئ server.js:
import http from "node:http";
const server = http.createServer((req, res) => {
res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
res.end(JSON.stringify({ message: "مرحبًا من الخادم", path: req.url }));
});
server.listen(3000, () => {
console.log("الخادم يعمل على http://localhost:3000");
});
node server.js
افتح http://localhost:3000 في المتصفح: ترى رد خادمك الأول. لإيقافه اضغط Ctrl+C في الطرفية.
الوحدات والحزم
قسّم الكود إلى ملفات (وحدات) تصدّر وتستورد:
// format.js
export function formatPrice(amount) {
return `${amount.toLocaleString("en-US")} دج`;
}
// server.js
import { formatPrice } from "./format.js";
والحزم مكتبات جاهزة من npm:
npm install express
تُضاف إلى package.json تحت dependencies، وتُحمَّل في مجلد node_modules. لا ترفع هذا المجلد إلى Git أبدًا؛ من ينزّل مشروعك يكتب npm install فيُعاد إنشاؤه.
متغيرات البيئة وملف .env
الإعدادات التي تختلف بين جهازك والخادم، والأسرار، لا تُكتب في الكود. ضعها في ملف .env:
PORT=3000
DATABASE_URL=postgres://user:password@localhost:5432/tasks
JWT_SECRET=اكتب-هنا-نصا-طويلا-عشوائيا
ونسخ Node.js الحديثة تقرؤه مباشرة:
node --env-file=.env --watch server.js
const port = process.env.PORT ?? 3000;
الخيار --watch يعيد تشغيل الخادم تلقائيًا كلما حفظت ملفًا. وأضف .env إلى .gitignore، وارفع بدله ملف .env.example فيه أسماء المتغيرات دون قيمها.
مهمتك
أنشئ مشروع tasks-api، واكتب خادمًا يرد على / برسالة ترحيب، وعلى /time بالوقت الحالي، وعلى أي مسار آخر بكود 404 ورسالة خطأ بصيغة JSON. اجعل المنفذ يُقرأ من .env.