JSON: لغة تبادل البيانات

١لماذا JSON؟

حتى الآن كان الخادم يرد بصفحات HTML يقرؤها الإنسان. لكن كثيرًا من «العملاء» ليسوا بشرًا: تطبيق جوال (مقرر 251)، أو واجهة React (مقرر 242)، أو خادم آخر. هؤلاء يريدون بيانات منظمة لا صفحة منسّقة. وأشهر صيغة لذلك JSON (تُنطق «جيسون»): نص بسيط يشبه كائنات JavaScript التي عرفتها في 131:

{  "id": 7,  "name": "قهوة عربية",  "price": 35.5,  "available": true,  "tags": ["مشروبات", "سعودي"],  "supplier": { "name": "مزارع جازان", "city": "جازان" }}

قواعد JSON صارمة: المفاتيح بين علامتي تنصيص مزدوجتين دائمًا، ولا فاصلة زائدة بعد آخر عنصر، ولا تعليقات.

٢من PHP إلى JSON: json_encode

<?php$product = [    'id' => 7,    'name' => 'قهوة عربية',    'price' => 35.5,    'available' => true,    'tags' => ['مشروبات', 'سعودي'],]; echo json_encode($product) . "\n\n";echo json_encode($product, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

• بلا خيارات تُكتب الحروف العربية بصيغة \u0642…: صحيحة لكنها غير مقروءة وأطول.
• JSON_UNESCAPED_UNICODE تبقي العربية كما هي، و JSON_PRETTY_PRINT تنسّق بأسطر ومسافات (للقراءة فقط).
• العلامة | تجمع الخيارين معًا.

٣استجابة JSON حقيقية

الواجهة التي ترد بـ JSON تخبر العميل بنوع المحتوى عبر الترويسة Content-Type: application/json، وإلا ظنها HTML. هذه أول «واجهة برمجة» API تكتبها:

<?phpheader('Content-Type: application/json; charset=utf-8'); $products = [    ['id' => 1, 'name' => 'قهوة عربية', 'price' => 35],    ['id' => 2, 'name' => 'تمر سكري', 'price' => 45],    ['id' => 3, 'name' => 'شاي أخضر', 'price' => 18],]; $max = isset($_GET['max']) ? (float) $_GET['max'] : null;if ($max !== null) {    $products = array_values(array_filter($products, fn($p) => $p['price'] <= $max));} echo json_encode(['count' => count($products), 'data' => $products], JSON_UNESCAPED_UNICODE);

٤من JSON إلى PHP: json_decode

والاتجاه المعاكس: نص JSON يصل من طلب أو ملف أو خدمة أخرى، فنحوّله إلى مصفوفة PHP. لاحظ المعامل الثاني true: بدونه تعيد الدالة كائنات بدل مصفوفات ترابطية:

<?php$text = '{"student":"نورة","grades":[90, 85, 77],"active":true}'; $data = json_decode($text, true);echo $data['student'] . "\n";echo array_sum($data['grades']) / count($data['grades']) . "\n"; // JSON معطوب$bad = json_decode('{"name": "سعود",}', true);var_dump($bad);echo json_last_error_msg();

إن كان النص غير صالح تعيد json_decode القيمة null، وتشرح json_last_error_msg() السبب. وفي PHP الحديث يمكنك طلب استثناء بالخيار JSON_THROW_ON_ERROR.

٥استقبال JSON في الطلب

التطبيقات الحديثة ترسل بياناتها JSON في جسم الطلب بدل النماذج. هنا لا تملأ PHP مصفوفة $_POST؛ بل تقرأ الجسم الخام من php://input وتفك ترميزه بنفسك:

<?phpheader('Content-Type: application/json; charset=utf-8'); $in = json_decode(file_get_contents('php://input'), true);if (!is_array($in) || empty($in['items'])) {    http_response_code(400);    echo json_encode(['error' => 'أرسل JSON فيه items'], JSON_UNESCAPED_UNICODE);    exit;} $total = 0;foreach ($in['items'] as $it) {    $total += $it['price'] * $it['qty'];}http_response_code(201);echo json_encode(['customer' => $in['customer'] ?? 'زائر', 'total' => $total], JSON_UNESCAPED_UNICODE);