أول خادم Express

تبدأ معظم مشاريع Express تقريبًا بملف index.js من أربعين سطرًا، وتنتهي تقريبًا كلها بملف index.js من ألفي سطر تتجاور فيه الاتصال بقاعدة البيانات والتحقق من المدخلات وقواعد العمل وإعدادات الخادم. لا يحدث هذا التحول أبدًا عن قرار واعٍ: فكل إضافة منفردة تبدو معقولة، ثم يأتي يوم لا يجرؤ فيه أحد على لمس الملف لأن كل شيء فيه مرتبط بكل شيء.

والمشكلة ليست جمالية. فالخادم الذي يبدأ الاستماع داخل الوحدة نفسها التي تعرّف المسارات هو خادم لا يمكنك اختباره دون فتح منفذ. والإعداد الذي يُقرأ عبر process.env في منتصف كود قواعد العمل هو إعداد لا تكتشف نقصه إلا في بيئة الإنتاج، عند أول طلب، بعد ثلاث ساعات من النشر. لذلك يبني هذا الدرس خادمًا بسيطًا، لكنه يضع منذ البداية ثلاثة فصول تكلّفك خمس دقائق الآن وتوفّر عليك أسابيع لاحقًا: فصل الإعدادات عن الكود، وفصل التطبيق عن الخادم، وفصل المسارات عن المنطق.

التثبيت

mkdir mon-api && cd mon-api
npm init -y
npm install express
npm install --save-dev nodemon

أضف "type": "module" إلى ملف package.json للعمل بوحدات ES، مع سكربتات التشغيل:

{
  "name": "mon-api",
  "type": "module",
  "engines": { "node": ">=22.0.0" },
  "scripts": {
    "dev": "node --watch --env-file=.env src/serveur.js",
    "start": "node src/serveur.js"
  }
}