كيف تقوم بتشغيل العمليات الخارجية باستخدام child_process؟

Question

Accepted Answer

يتيح لك وحدة **`child_process`** لـ Node تشغيل **برامج/أوامر أخرى** (أوامر shell، scripts، binaries أخرى) كعمليات نظام تشغيل منفصلة. مفيدة لاستدعاء أدوات النظام، تشغيل العمل الثقيل على المعالج خارج العملية الرئيسية، أو تنسيق برامج أخرى.

## الطرق الأربع الرئيسية

```text
exec      → run a shell command, buffer all output (simple, small output)
execFile  → run a file directly (no shell — safer, faster)
spawn     → stream output (for large output / long-running processes)
fork      → spawn a new NODE process with an IPC channel (Node-to-Node)
```

## exec — بسيطة، مخزنة مؤقتاً

```js
import { exec } from "child_process";

exec("ls -la", (err, stdout, stderr) => {
  if (err) return console.error(err);
  console.log(stdout); // the entire output, buffered into memory
});
```

`exec` مريحة للأوامر القصيرة لكنها تخزن كل المخرجات مؤقتاً — خطيرة للأوامر التي تنتج مخرجات كبيرة (قد تتجاوز حد المخزن المؤقت).

## spawn — streaming (للمخرجات الكبيرة/المستمرة)

```js
import { spawn } from "child_process";

`spawn` تبث المخرجات أثناء إنتاجها (ذاكرة ثابتة) وتأخذ الحجج كـ **array** (ليس string shell) — الخيار الصحيح للعمليات طويلة الأجل أو عالية المخرجات.

## تحذير الأمان: حقن الأوامر

```js
// ❌ DANGEROUS — user input in a shell command enables injection
exec(`convert ${userFilename} out.png`); // userFilename = "; rm -rf /" → disaster

// ✅ use execFile/spawn with an args array — no shell interpolation
execFile("convert", [userFilename, "out.png"]); // args passed safely, not parsed by a shell
```

لا تقم أبداً بإدراج input غير موثوق في string shell `exec` — فهذا يفعّل **حقن الأوامر**. استخدم `execFile`/`spawn` مع array من الحجج بحيث يتم تمرير المدخلات كبيانات، وليس كـ syntax shell.

## الاستخدام القائم على Promise

```js
import { promisify } from "util";
const execAsync = promisify(exec);
const { stdout } = await execAsync("git rev-parse HEAD");
```

## لماذا يهم

يتيح `child_process` لـ Node التكامل مع النظام الأوسع — تشغيل أدوات CLI (git، ffmpeg، imagemagick)، نقل المهام الثقيلة على المعالج إلى عمليات منفصلة (تجنب حجب event loop)، وتنسيق برامج أخرى.

معرفة الطريقة المناسبة للاستخدام (`spawn` للـ streaming/المخرجات الكبيرة، `exec` للأوامر البسيطة، `fork` لـ Node subprocesses) و — الأهم — **خطر حقن الأوامر** من `exec` مع user input (يتم تخفيفه بواسطة `execFile`/`spawn` مع arg arrays) ضروري لاستخدامه بكفاءة وأماناً.