</>مدرسه زیب‌موجیاد بگیر، تمرین کن، بساز
مدرسهPHPدرس 26
درس 26 از 80 · ۵۵ دقیقه

JSON و CSV؛ تبدیل داده برای تبادل

JSON ساختار داده را برای API و برنامه‌ها نگه می‌دارد. CSV برای جدول‌های ساده مناسب است. هنگام decode باید خطا و شکل داده را بررسی کنیم.

۰امتیاز شما
نقشه این درس

بعد از این درس دقیقاً چه بلدی؟

  • موضوع «json_encode» را با زبان ساده برای فرد دیگری توضیح می‌دهی.
  • مثال همین درس را خط‌به‌خط می‌خوانی و خروجی آن را پیش‌بینی می‌کنی.
  • کد را تغییر می‌دهی، نتیجه یا ساختار آن را بررسی می‌کنی و خطا را مرحله‌ای اصلاح می‌کنی.
به زبان زندگی واقعی

بسته‌بندی برای مقصد

همان کالا برای پست یا قفسه فروشگاه بسته‌بندی متفاوتی می‌خواهد. داده هم برای API با JSON و برای جدول با CSV آماده می‌شود.

نکته مهم برای شروع PHP

JSON ساختار داده را برای API و برنامه‌ها نگه می‌دارد. CSV برای جدول‌های ساده مناسب است. هنگام decode باید خطا و شکل داده را بررسی کنیم.

چرا مهم است؟ این مفهوم یکی از آجرهای مسیر حرفه‌ای PHP است. فعلاً لازم نیست همه جزئیات را حفظ کنی؛ باید دلیل استفاده و اثر هر خط را بفهمی.

اولین تمرین تو: اطلاعات محصول با UTF-8 و بدون تبدیل نویسه فارسی به کدهای ناخوانا، به JSON تبدیل می‌شود.

مفهوم‌های اصلی

اول بفهم، بعد کد بنویس

json_encode

آرایه و شیء را به متن JSON تبدیل می‌کند.

json_decode

JSON معتبر را به ساختار PHP برمی‌گرداند.

JSON_THROW_ON_ERROR

به‌جای سکوت، خطای تبدیل را به Exception تبدیل می‌کند.

سناریوی واقعی

خروجی API محصول

اطلاعات محصول با UTF-8 و بدون تبدیل نویسه فارسی به کدهای ناخوانا، به JSON تبدیل می‌شود.

ورودی روشنقانون قابل توضیحخروجی قابل بررسی
بازی ساختن کد

قطعه‌ها را به ترتیب درست بچین

روی هر قطعه بزن تا وارد پاسخ شود؛ برای برگرداندن دوباره روی آن بزن. با دکمه‌های جابه‌جایی هم می‌توانی بدون کشیدن و رهاکردن ترتیب را اصلاح کنی.

مرحله ۲ از ۳ · مرتب‌کردن کد
بانک قطعه‌هاقطعه مناسب را انتخاب کن
ترتیب پاسخ تواز بالا به پایین اجرا می‌شود

    هنوز پاسخی بررسی نشده است.

    کارگاه تعاملی

    کد را کامل کن و ساختار آن را بررسی کن

    این درس وارد قابلیت‌های سروری یا حرفه‌ای شده است. برای امنیت سایت، کد دلخواه روی سرور اجرا نمی‌شود؛ بررسی‌گر، وجود اجزای ضروری و منطق مورد انتظار را کنترل می‌کند و راهنمای اصلاح می‌دهد.

    lesson-26.php
    گزارش بررسیبررسی‌گر ساختار آماده است
    کد را کامل کن و «بررسی ساختار» را بزن.
    در مثال‌های پیشرفته، اجرای ناامن سروری نداریم؛ اجزای ضروری کد بررسی می‌شوند.
    کدخوانی استاد

    این مثال خط‌به‌خط چه می‌گوید؟

    فعلاً حفظ نکن؛ هر خط را به یک جمله ساده تبدیل کن.

    1. 1<?php

      از اینجا مفسر PHP شروع به خواندن کد می‌کند.

    2. 2$product = ["title" => "کتاب PHP", "price" => 240000];

      یک مقدار با نام $product نگه‌داری می‌شود تا در خط‌های بعد دوباره استفاده شود.

    3. 3$json = json_encode(

      یک مقدار با نام $json نگه‌داری می‌شود تا در خط‌های بعد دوباره استفاده شود.

    4. 4$product,

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    5. 5JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR

      این خط بخشی از منطق اصلی مثال است؛ نام‌ها و علامت‌ها را از راست به چپ، بخش‌به‌بخش بخوان.

    6. 6);

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

    7. 7echo $json;

      نتیجه این عبارت به خروجی پاسخ فرستاده می‌شود.

    منبع رسمی همین درسمستندات اصلی PHP را ببین ←برای عمیق‌ترشدن؛ لازم نیست در شروع همه آن را بخوانی.
    حالا نوبت توست

    آرایه‌ای از دو محصول بساز، JSON را decode کن و خطای JSON ناقص را مدیریت کن.

    تمرین پلکانی

    از ساده به چالشی، بدون پرش

    ۱ · گرم‌کردن

    یکی از مقدارهای مثال را عوض کن، خروجی را روی کاغذ حدس بزن و سپس بررسی کن.

    ۲ · تثبیت

    آرایه‌ای از دو محصول بساز، JSON را decode کن و خطای JSON ناقص را مدیریت کن.

    ۳ · ساختن

    سناریوی «خروجی API محصول» را با نام‌های واضح‌تر و یک حالت تازه گسترش بده.

    دام‌های رایج

    این سه اشتباه را انجام نده

    1

    نادیده‌گرفتن خطای encode/decode

    2

    اعتماد به ساختار JSON فقط چون نحو آن صحیح است

    3

    استفاده از CSV برای داده عمیق و تودرتو

    آزمون پایان درس

    5 پرسش کوتاه؛ مطمئن شو واقعاً یاد گرفته‌ای

    برای هر پرسش یک پاسخ انتخاب کن. بعد از هر انتخاب، دلیل پاسخ را همان‌جا می‌بینی.

    پرسش 1 از 5

    JSON_THROW_ON_ERROR چه فایده‌ای دارد؟

    پرسش 2 از 5

    کدام توضیح، «json_encode» را دقیق‌تر بیان می‌کند؟

    پرسش 3 از 5

    بهترین قدم بعد از خواندن مثال این درس چیست؟

    پرسش 4 از 5

    کدام روش نشان می‌دهد این درس را واقعاً فهمیده‌ای؟

    پرسش 5 از 5

    کدام رفتار احتمال خطا را در همین موضوع بیشتر می‌کند؟

    پایان درس 26

    درس را فقط وقتی تمام کن که کد را تغییر داده‌ای

    دیدن آموزش کافی نیست؛ یک مقدار را تغییر بده، خروجی را پیش‌بینی کن و بعد اجرا بزن.