کامنت‌ها در PHP

انواع کامنت در PHP، کاربردها و بهترین روش‌های کامنت‌گذاری برای کدهای تمیز و خوانا

کامنت چیست؟

کامنت (Comment) یادداشت‌هایی هستند که داخل کد می‌نویسید اما PHP آن‌ها را اجرا نمی‌کند. کامنت‌ها فقط برای انسان‌ها هستند — نه برای کامپیوتر.

PHP سه نوع کامنت دارد:

<?php
// این یک کامنت تک‌خطی است
echo "سلام";
?>

<?php
# این هم یک کامنت تک‌خطی است (سبک Shell)
echo "سلام";
?>

<?php
/*
این یک کامنت چندخطی است
می‌تواند چند خط ادامه داشته باشد
مناسب برای توضیحات طولانی
*/
echo "سلام";
?>

می‌توانید کامنت را در همان خط کد بنویسید:

<?php
$x = 5; // تعریف متغیر x
$y = 10; // تعریف متغیر y
$sum = $x + $y; // محاسبه جمع
?>

بله ✅:

// بررسی اینکه آیا کاربر وارد شده است
if ($isLoggedIn) {
    // نمایش داشبورد
    showDashboard();
}

خیر ❌:

// اگر x بزرگتر از 5 باشد
if ($x > 5) {
    // متغیر y را برابر 10 قرار بده
    $y = 10;
}

این کامنت‌ها بی‌فایده هستند چون کد خودش واضح است!

این مبحث بخشی از دوره آموزش کامل PHP است.