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

Composer و Autoload؛ فایل‌ها را دستی دنبال نکن

با بزرگ‌شدن پروژه، require کردن ده‌ها فایل شکننده می‌شود. Composer وابستگی‌ها را مدیریت می‌کند و Autoload کلاس‌ها را هنگام نیاز پیدا می‌کند.

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

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

  • می‌توانی «composer.json» را با مثال همین درس توضیح بدهی.
  • می‌دانی «Namespace» کجای مسئله به کار می‌آید.
  • تغییر پیشنهادی درس را اجرا می‌کنی و از روی نتیجه، اشتباه را پیدا می‌کنی.
به زبان زندگی واقعی

فهرست کتابخانه

برای پیدا کردن هر کتاب کل انبار را نمی‌گردیم. نام و دسته‌بندی، جای آن را مشخص می‌کند. Namespace و PSR-4 همین نظم را برای کلاس‌ها می‌سازند.

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

با بزرگ‌شدن پروژه، require کردن ده‌ها فایل شکننده می‌شود. Composer وابستگی‌ها را مدیریت می‌کند و Autoload کلاس‌ها را هنگام نیاز پیدا می‌کند.

چرا مهم است؟ قانون PSR-4 می‌گوید کلاس‌های فضای نام App از پوشه src خوانده شوند؛ پس مسیر کلاس از نام آن قابل پیش‌بینی است.

اولین تمرین تو: قانون PSR-4 می‌گوید کلاس‌های فضای نام App از پوشه src خوانده شوند؛ پس مسیر کلاس از نام آن قابل پیش‌بینی است.

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

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

composer.json

وابستگی‌ها و قانون Autoload پروژه را تعریف می‌کند.

Namespace

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

vendor/autoload.php

فایل ورودی Autoload است و معمولاً یک‌بار در ابتدای برنامه بار می‌شود.

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

پیداکردن کلاس TaskService

قانون PSR-4 می‌گوید کلاس‌های فضای نام App از پوشه src خوانده شوند؛ پس مسیر کلاس از نام آن قابل پیش‌بینی است.

موقعیتتصمیم برنامهنتیجه قابل دیدن
بازی ساختن کد

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

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

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

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

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

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

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

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

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

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

    1. 1{

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

    2. 2"autoload": {

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

    3. 3"psr-4": {

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

    4. 4"App\\": "src/"

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

    5. 5}

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

    6. 6}

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

    7. 7}

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

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

    بعد از تعریف Autoload دستور composer dump-autoload را اجرا کن. سپس نام فایل را با نام کلاس ناهماهنگ کن و خطای Class not found را ردیابی کن.

    تمرین پلکانی

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

    ۱ · گرم‌کردن

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

    ۲ · تثبیت

    بعد از تعریف Autoload دستور composer dump-autoload را اجرا کن. سپس نام فایل را با نام کلاس ناهماهنگ کن و خطای Class not found را ردیابی کن.

    ۳ · ساختن

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

    دام‌های رایج

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

    1

    بعد از تغییر composer.json، dump-autoload را اجرا نمی‌کنی.

    2

    حروف بزرگ و کوچک نام کلاس و مسیر یکسان نیستند.

    3

    پوشه vendor را دستی ویرایش می‌کنی.

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

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

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

    پرسش 1 از 5

    فایل vendor/autoload.php چه کاری می‌کند؟

    پرسش 2 از 5

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

    پرسش 3 از 5

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

    پرسش 4 از 5

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

    پرسش 5 از 5

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

    پایان درس 19

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

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