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

کد خوانا، مرز مسئولیت و تغییر امن

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

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

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

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

نقشه راه با تابلوهای روشن

مسیر شاید طولانی باشد، اما تابلو درست باعث می‌شود بدون حدس به مقصد برسی. نام و مرز تابع همان تابلوها هستند.

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

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

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

اولین تمرین تو: تابع ۲۰۰خطی به اعتبارسنجی، محاسبه، ذخیره و اعلان تقسیم می‌شود؛ هر بخش مستقل‌تر آزمون می‌شود.

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

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

Naming

نام دلیل وجود مقدار یا رفتار را بیان می‌کند.

Cohesion

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

Coupling

میزان وابستگی اجزا به جزئیات یکدیگر است.

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

بازنویسی تابع ثبت سفارش

تابع ۲۰۰خطی به اعتبارسنجی، محاسبه، ذخیره و اعلان تقسیم می‌شود؛ هر بخش مستقل‌تر آزمون می‌شود.

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

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

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

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

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

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

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

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

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

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

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

    1. 1<?php

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

    2. 2final class CheckoutService {

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

    3. 3public function checkout(CheckoutData $data): Order {

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

    4. 4$this->validator->validate($data);

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

    5. 5$order = $this->factory->create($data);

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

    6. 6$this->orders->save($order);

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

    7. 7$this->events->dispatch(new OrderPlaced($order->id));

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

    8. 8return $order;

      نتیجه این بخش به محل فراخوانی برگردانده می‌شود.

    9. 9}

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

    10. 10}

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

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

    برای هر خط مسئولیت و نوع خطای احتمالی بنویس؛ سپس یک نام مبهم را بهتر کن.

    تمرین پلکانی

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

    ۱ · گرم‌کردن

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

    ۲ · تثبیت

    برای هر خط مسئولیت و نوع خطای احتمالی بنویس؛ سپس یک نام مبهم را بهتر کن.

    ۳ · ساختن

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

    دام‌های رایج

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

    1

    توابع کوتاه اما با نام مبهم

    2

    Abstraction زودهنگام بدون نیاز واقعی

    3

    ترکیب منطق دامنه با HTML و SQL

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

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

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

    پرسش 1 از 5

    Cohesion بالا یعنی چه؟

    پرسش 2 از 5

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

    پرسش 3 از 5

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

    پرسش 4 از 5

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

    پرسش 5 از 5

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

    پایان درس 45

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

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