بعد از این درس دقیقاً چه بلدی؟
- موضوع «PSR-4» را با زبان ساده برای فرد دیگری توضیح میدهی.
- مثال همین درس را خطبهخط میخوانی و خروجی آن را پیشبینی میکنی.
- کد را تغییر میدهی، نتیجه یا ساختار آن را بررسی میکنی و خطا را مرحلهای اصلاح میکنی.
قواعد مشترک جاده
خودروها متفاوتاند اما تابلو و جهت حرکت مشترک است. استاندارد، همکاری تیم و ابزارها را بدون یکسانکردن همه طراحیها ممکن میکند.
PSRها قراردادهای همکاری میان پروژهها هستند. PSR-4 بارگذاری کلاس، PSR-12 سبک کد و PSR-3 رابط Log را استاندارد میکنند.
چرا مهم است؟ این مفهوم یکی از آجرهای مسیر حرفهای PHP است. فعلاً لازم نیست همه جزئیات را حفظ کنی؛ باید دلیل استفاده و اثر هر خط را بفهمی.
اولین تمرین تو: کد به LoggerInterface وابسته است؛ بنابراین میتوان Monolog یا Logger تستی را بدون تغییر منطق سفارش جایگزین کرد.
اول بفهم، بعد کد بنویس
PSR-4
Namespace را به مسیر فایل نگاشت میکند.
PSR-12
قواعد خوانایی و قالب کد را هماهنگ میکند.
PSR-3
رابط مشترک Logger و سطحهای Log را تعریف میکند.
تعویض کتابخانه Log
کد به LoggerInterface وابسته است؛ بنابراین میتوان Monolog یا Logger تستی را بدون تغییر منطق سفارش جایگزین کرد.
قطعهها را به ترتیب درست بچین
روی هر قطعه بزن تا وارد پاسخ شود؛ برای برگرداندن دوباره روی آن بزن. با دکمههای جابهجایی هم میتوانی بدون کشیدن و رهاکردن ترتیب را اصلاح کنی.
کد را کامل کن و ساختار آن را بررسی کن
این درس وارد قابلیتهای سروری یا حرفهای شده است. برای امنیت سایت، کد دلخواه روی سرور اجرا نمیشود؛ بررسیگر، وجود اجزای ضروری و منطق مورد انتظار را کنترل میکند و راهنمای اصلاح میدهد.
کد را کامل کن و «بررسی ساختار» را بزن.
این مثال خطبهخط چه میگوید؟
فعلاً حفظ نکن؛ هر خط را به یک جمله ساده تبدیل کن.
- 1
<?phpاز اینجا مفسر PHP شروع به خواندن کد میکند.
- 2
use Psr\Log\LoggerInterface;این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 3
final class CheckoutService {این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 4
public function __construct(private LoggerInterface $logger) {}یک کار نامگذاریشده تعریف میشود تا منطق آن قابل استفاده دوباره و قابل آزمون باشد.
- 5
public function checkout(): void {یک کار نامگذاریشده تعریف میشود تا منطق آن قابل استفاده دوباره و قابل آزمون باشد.
- 6
$this->logger->info("checkout_started");این خط بخشی از منطق اصلی مثال است؛ نامها و علامتها را از راست به چپ، بخشبهبخش بخوان.
- 7
}مرز یک بلوک یا فراخوانی در اینجا باز یا بسته میشود.
- 8
}مرز یک بلوک یا فراخوانی در اینجا باز یا بسته میشود.
راهنماییها مرحلهای هستند؛ اول خودت پیام خطا را بخوان.
یک Logger ساده تستی بساز که پیامها را داخل آرایه نگه دارد.
از ساده به چالشی، بدون پرش
یکی از مقدارهای مثال را عوض کن، خروجی را روی کاغذ حدس بزن و سپس بررسی کن.
یک Logger ساده تستی بساز که پیامها را داخل آرایه نگه دارد.
سناریوی «تعویض کتابخانه Log» را با نامهای واضحتر و یک حالت تازه گسترش بده.
این سه اشتباه را انجام نده
اشتباهگرفتن استاندارد سبک با معماری
وابستگی مستقیم به کلاس کتابخانه وقتی Interface وجود دارد
نادیدهگرفتن Case-sensitive بودن مسیر PSR-4
5 پرسش کوتاه؛ مطمئن شو واقعاً یاد گرفتهای
برای هر پرسش یک پاسخ انتخاب کن. بعد از هر انتخاب، دلیل پاسخ را همانجا میبینی.
PSR-4 درباره چیست؟
کدام توضیح، «PSR-4» را دقیقتر بیان میکند؟
بهترین قدم بعد از خواندن مثال این درس چیست؟
کدام روش نشان میدهد این درس را واقعاً فهمیدهای؟
کدام رفتار احتمال خطا را در همین موضوع بیشتر میکند؟
درس را فقط وقتی تمام کن که کد را تغییر دادهای
دیدن آموزش کافی نیست؛ یک مقدار را تغییر بده، خروجی را پیشبینی کن و بعد اجرا بزن.