PHP

PHP — کامنت ها (Comments) در PHP

آخرین بروزرسانی: 1404/07/21

کامنت ها (Comments) در PHP

در زبان برنامه نویسی PHP، کامنت یا «Comment» بخشی از کد است که اجرا نمی شود و فقط برای توضیح یا مستندسازی نوشته می شود. استفاده از کامنت ها باعث خوانایی بهتر کد و درک آسان تر منطق برنامه می شود.

انواع کامنت در PHP

در PHP چند روش برای نوشتن کامنت وجود دارد که شامل کامنت های تک خطی و چندخطی است. هر روش در موقعیت خاصی کاربرد دارد و به شما کمک می کند تا کدتان واضح تر باشد.

کامنت های تک خطی

برای نوشتن کامنت تک خطی می توانید از دو علامت // یا # استفاده کنید. هر متنی بعد از این علائم تا انتهای خط نادیده گرفته می شود.

// این یک کامنت تک خطی است
echo "Welcome Home!"; // چاپ پیام خوش آمد

نکته: در آموزش های سایت ما، معمولاً از // برای کامنت استفاده می شود.

کامنت های چندخطی

برای توضیحات طولانی تر یا زمانی که بخواهید چند خط را از اجرا مستثنی کنید، از کامنت چندخطی استفاده می شود که با /* شروع و با */ تمام می شود.

/* این یک کامنت چندخطی است
که در چند خط توضیح داده می شود */

استفاده از کامنت برای غیرفعال کردن کد

گاهی لازم است بخشی از کد را موقتاً غیرفعال کنید تا اجرا نشود. در این صورت می توانید از کامنت ها برای «نادیده گرفتن» خطوط خاصی از کد استفاده کنید.

// echo "Welcome Home!"; // این خط اجرا نمی شود

نکته: این روش هنگام دیباگ (Debug) یا تست بخش های مختلف برنامه بسیار مفید است.

چرا کامنت مهم است؟

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

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