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

Service، Repository، DTO و مرز داده

Service جریان یک کاربرد را اجرا می‌کند، Repository دسترسی به مدل‌های دامنه را پنهان و DTO داده عبوری را بدون رفتار پیچیده حمل می‌کند.

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

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

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

شرکت با واحدهای تخصصی

مدیر عملیات ترتیب کار را مشخص می‌کند و بایگانی مسئول نگهداری پرونده است. هر واحد مرز و زبان خودش را دارد.

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

Service جریان یک کاربرد را اجرا می‌کند، Repository دسترسی به مدل‌های دامنه را پنهان و DTO داده عبوری را بدون رفتار پیچیده حمل می‌کند.

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

اولین تمرین تو: Service ایمیل تکراری را بررسی، Password Hasher را صدا و Entity را از طریق Repository ذخیره می‌کند.

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

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

Application Service

یک Use Case را هماهنگ می‌کند.

Repository

رابط مجموعه‌ای برای ذخیره و بازیابی Entity است.

DTO

داده عبوری و شکل مرز را به‌صورت صریح نگه می‌دارد.

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

ثبت‌نام کاربر

Service ایمیل تکراری را بررسی، Password Hasher را صدا و Entity را از طریق Repository ذخیره می‌کند.

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

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

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

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

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

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

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

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

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

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

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

    1. 1<?php

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

    2. 2final readonly class RegisterUser {

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

    3. 3public function __construct(

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

    4. 4private UserRepository $users,

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

    5. 5private PasswordHasher $hasher,

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

    6. 6) {}

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

    7. 7public function handle(RegisterData $data): User {

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

    8. 8if ($this->users->existsByEmail($data->email)) {

      یک پرسش درست/نادرست بررسی می‌شود و مسیر اجرای بعدی را تعیین می‌کند.

    9. 9throw new EmailAlreadyUsed();

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

    10. 10}

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

    11. 11$user = User::register($data->email, $this->hasher->hash($data->password));

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

    12. 12$this->users->save($user);

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

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

    رابط UserRepository و پیاده‌سازی حافظه‌ای برای تست بساز.

    تمرین پلکانی

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

    ۱ · گرم‌کردن

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

    ۲ · تثبیت

    رابط UserRepository و پیاده‌سازی حافظه‌ای برای تست بساز.

    ۳ · ساختن

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

    دام‌های رایج

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

    1

    Repository عمومی برای هر Query ممکن

    2

    DTO دارای منطق دامنه سنگین

    3

    Service فقط به‌عنوان Wrapper بی‌فایده

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

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

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

    پرسش 1 از 5

    Repository چه چیزی را پنهان می‌کند؟

    پرسش 2 از 5

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

    پرسش 3 از 5

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

    پرسش 4 از 5

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

    پرسش 5 از 5

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

    پایان درس 47

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

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