PHP Izoh

Izoh (comment) — PHP interpretatori e’tiborga olmaydigan, faqat inson uchun mo’ljallangan matn. Havaskor dasturchi izohni ortiqcha deb bilsa, tajribali muhandis undan kodni tushuntirish uchun foydalanadi. Katta loyihada kodni oylab keyin qaytib o’qiganingizda, aynan izohlar sizni qutqaradi.

Izoh — dastur ijrosiga ta’sir qilmaydigan, faqat kodni tushuntiruvchi matn. PHP bir qatorli va ko’p qatorli izohlarni qo’llab-quvvatlaydi.

Bir qatorli izoh

PHP bir qatorli izohning ikki shaklini beradi: // va #. Ikkovi ham qator oxirigacha ishlaydi:

<?php
// Bu foydalanuvchini salomlaydigan dastur
echo "Salom, UzbekDevs!";  // izoh kod yonida ham bo'lishi mumkin
# Bu ham izoh (kamroq ishlatiladi)
?>

Salom, UzbekDevs!

// bilan boshlangan matn natijaga chiqmadi. // keng tarqalgan, # esa kamroq ishlatiladi, ammo ikkovi ham to’g’ri.

Ko’p qatorli izoh

Bir necha qatorni qamrab oluvchi izoh /* va */ orasiga yoziladi:

<?php
/*
  Bu dastur mahsulot narxini hisoblaydi.
  Muallif: Farrux Sherkulov
*/
$narx = 15000;
echo $narx;
?>

15000

/* ... */ orasidagi hamma narsa, necha qator bo’lishidan qat’i nazar, e’tiborga olinmaydi.

Izoh turlari

PHP izoh shakllarini jadvalda jamlaymiz:

Kodni vaqtincha o’chirish

Izohning yana bir amaliy foydasi — kodni o’chirmasdan turib, vaqtincha ishlamas qilish. Bu xatoni izlaganda juda qo’l keladi:

<?php
$ism = "Master Sherkulov";
// echo "Bu qator hozir ishlamaydi";
echo $ism;
?>

Master Sherkulov

Ikkinchi echo izohga aylantirildi, shuning uchun faqat oxirgisi ishladi. Kodni butunlay o’chirmasdan sinash — professional ish uslubi.

Yaxshi izohning qoidasi

Muhim tamoyil: izoh kod nima qilishini emas, nega shunday qilinganini tushuntirishi kerak. $narx = $narx + 1; // narxga bir qo'shamiz — bu yomon izoh. $narx = $narx + 1; // yaxlitlashdagi kamomadni qoplash uchun — bu yaxshi izoh. Aynan shu farq havaskorni professionaldan ajratadi.

Xulosa

Bu bo’limda // va # bir qatorli, /* */ ko’p qatorli izohlarni, kodni vaqtincha o’chirishni va yaxshi izohning tamoyilini ko’rib chiqdik. Izoh — kodning hujjati. Keyingi darsda o’zgaruvchilarga o’tamiz.