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

Enum، readonly و مدل‌کردن حالت معتبر

Enum مجموعه بسته‌ای از حالت‌های معتبر می‌سازد. readonly مانع تغییر دوباره Property پس از مقداردهی می‌شود و برای Value Objectها مفید است.

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

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

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

منوی انتخاب محدود

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

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

Enum مجموعه بسته‌ای از حالت‌های معتبر می‌سازد. readonly مانع تغییر دوباره Property پس از مقداردهی می‌شود و برای Value Objectها مفید است.

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

اولین تمرین تو: سفارش فقط Draft، Paid یا Sent است؛ Enum اجازه ثبت متن ناشناخته را نمی‌دهد.

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

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

Backed enum

هر حالت یک مقدار string یا int پایدار دارد.

readonly

پس از مقداردهی اولیه، Property دوباره تغییر نمی‌کند.

Value Object

مقدار معتبر و رفتار مرتبط را در یک شیء کوچک نگه می‌دارد.

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

وضعیت سفارش معتبر

سفارش فقط Draft، Paid یا Sent است؛ Enum اجازه ثبت متن ناشناخته را نمی‌دهد.

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

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

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

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

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

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

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

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

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

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

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

    1. 1<?php

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

    2. 2enum OrderStatus: string {

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

    3. 3case Draft = "draft";

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

    4. 4case Paid = "paid";

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

    5. 5case Sent = "sent";

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

    6. 6}

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

    7. 7final readonly class OrderView {

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

    8. 8public function __construct(

      یک کار نام‌گذاری‌شده تعریف می‌شود تا منطق آن قابل استفاده دوباره و قابل آزمون باشد.

    9. 9public int $id,

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

    10. 10public OrderStatus $status,

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

    11. 11) {}

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

    12. 12}

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

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

    متد label فارسی برای Enum و یک Value Object برای Money بساز.

    تمرین پلکانی

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

    ۱ · گرم‌کردن

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

    ۲ · تثبیت

    متد label فارسی برای Enum و یک Value Object برای Money بساز.

    ۳ · ساختن

    سناریوی «وضعیت سفارش معتبر» را با نام‌های واضح‌تر و یک حالت تازه گسترش بده.

    دام‌های رایج

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

    1

    استفاده از Enum برای داده باز مانند نام کاربر

    2

    تصور عمیقاً immutable بودن شیء دارای اشیای قابل تغییر

    3

    ذخیره نام case به‌جای value پایدار بدون تصمیم

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

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

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

    پرسش 1 از 5

    Enum برای چه داده‌ای مناسب است؟

    پرسش 2 از 5

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

    پرسش 3 از 5

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

    پرسش 4 از 5

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

    پرسش 5 از 5

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

    پایان درس 39

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

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