ساختار کامنت چندخطی

برای ایجاد کامنت چندخطی در PHP از علامت /* برای شروع و علامت */ برای پایان کامنت استفاده می‌شود.

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

<?php

/*
This is a multiline comment.
It can contain several lines.
PHP will ignore this text.
*/

echo "Hello PHP";

?>

خروجی

Hello PHP

تفاوت کامنت تک‌خطی و چندخطی

اگر توضیح فقط در یک خط باشد، استفاده از کامنت تک‌خطی ساده‌تر است؛ اما برای توضیحاتی که چند خط دارند، ساختار /* … */ مناسب‌تر است.

نوشتن توضیحات چندخطی

یکی از کاربردهای اصلی کامنت چندخطی، توضیح دادن عملکرد یک قسمت از برنامه است. برای مثال، می‌توانیم در ابتدای یک بخش از کد، توضیحی درباره هدف آن بنویسیم.

<?php

/*
Calculate the total price.
The product price is stored
in the $price variable.
*/

$price = 250000;
$quantity = 3;

$total = $price * $quantity;

echo $total;

?>

خروجی

750000

غیرفعال کردن چند خط کد

یکی دیگر از کاربردهای مهم کامنت چندخطی، غیرفعال کردن موقت چندین دستور است. در این حالت لازم نیست خطوط موردنظر را حذف کنیم.

<?php

echo "Start";

/*
echo "Message 1";
echo "Message 2";
echo "Message 3";
*/

echo "End";

?>

خروجی

StartEnd

استفاده در یک برنامه واقعی

در پروژه‌های واقعی می‌توان از کامنت چندخطی برای توضیح یک الگوریتم، مشخص کردن هدف یک بخش از برنامه یا ثبت نکات مهم مربوط به یک قسمت از کد استفاده کرد.

<?php

/*
Get the user's score
and determine whether
the student has passed.
*/

$score = 85;

if ($score >= 50) {
echo "Passed";
} else {
echo "Failed";
}

?>

خروجی

Passed

نکات مهم این درس

تمرین

جمع‌بندی

در این درس با کامنت‌های چندخطی در PHP آشنا شدیم. ساختار /* … */ به ما اجازه می‌دهد توضیحات چندخطی بنویسیم یا چندین خط از کد را بدون حذف کردن، به‌صورت موقت غیرفعال کنیم.