آموزش جامع کامنت‌نویسی در PHP

// این یک کامنت تک‌خطی است
# این هم یک کامنت تک‌خطی دیگر (سبک shell)
/*
 * این یک کامنت چندخطی است
 * می‌تواند چندین خط را پوشش دهد
 */

/**
 * محاسبه تخفیف برای کاربران
 *
 * @param float $price قیمت اصلی
 * @param float $discount میزان تخفیف (بین 0 تا 1)
 * @return float قیمت پس از تخفیف
 * @throws InvalidArgumentException اگر تخفیف نامعتبر باشد
 */
function calculateDiscount($price, $discount)
{
    if ($discount < 0 || $discount > 1) {
        throw new InvalidArgumentException('تخفیف باید بین 0 و 1 باشد');
    }
    return $price * (1 - $discount);
}

function calculateBMI($weight, $height)
{
    return $weight / ($height * $height);
}