Comments در PHP
کامنت‌ها در PHP
کامنت یا توضیح، بخشی از کد است که توسط مفسر PHP اجرا نمی‌شود و برای توضیح دادن کد، یادداشت‌گذاری، مشخص کردن بخش‌های مختلف برنامه و افزایش خوانایی کد استفاده می‌شود.
کامنت‌ها چه کاربردی دارند؟
هنگام نوشتن برنامه‌های کوچک، ممکن است توضیح دادن کد چندان ضروری به نظر نرسد؛ اما در پروژه‌های بزرگ، کامنت‌ها کمک می‌کنند برنامه‌نویس بتواند هدف قسمت‌های مختلف برنامه را سریع‌تر درک کند.
مهم‌ترین کاربردهای کامنت عبارت‌اند از:
- توضیح عملکرد یک بخش از برنامه
- افزایش خوانایی کد
- یادداشت‌گذاری برای برنامه‌نویس
- مشخص کردن بخش‌های مهم برنامه
- غیرفعال کردن موقت یک خط یا بخشی از کد
کامنت تک‌خطی در PHP
برای ایجاد کامنت تک‌خطی در PHP می‌توان از علامت // استفاده کرد.
هر چیزی که بعد از این علامت در همان خط قرار بگیرد، توسط PHP اجرا نمی‌شود.
<?php
// This is a comment
echo "Hello PHP";
?>در مثال بالا، خطی که با // شروع شده است، کامنت است و اجرا نمی‌شود.
کامنت در انتهای یک خط کد
می‌توان کامنت را بعد از یک دستور PHP نیز قرار داد. در این حالت، بخش قبل از کامنت اجرا می‌شود و خود کامنت نادیده گرفته خواهد شد.
<?php
echo "Hello"; // Display a message
?>استفاده از علامت # برای کامنت
روش دیگری برای ایجاد کامنت تک‌خطی در PHP استفاده از علامت # است.
<?php
# This is also a comment
echo "Hello PHP";
?>در این روش نیز هر چیزی که بعد از علامت # در همان خط قرار داشته باشد، به‌عنوان کامنت در نظر گرفته می‌شود.
مقایسه دو روش کامنت تک‌خطی
| روش | نمونه | نوع |
|---|---|---|
| علامت دو اسلش | // Comment | تک‌خطی |
| علامت مربع | # Comment | تک‌خطی |
استفاده از کامنت برای غیرفعال کردن کد
یکی از کاربردهای بسیار مفید کامنت این است که بتوانیم موقتاً یک خط از برنامه را غیرفعال کنیم، بدون اینکه آن را حذف کنیم.
<?php
echo "First message";
// echo "Second message";
echo "Third message";
?>در این مثال، دستور دوم اجرا نمی‌شود؛ زیرا با // به کامنت تبدیل شده است.
کامنت در کنار متغیرها
می‌توان برای توضیح هدف یک متغیر نیز از کامنت استفاده کرد.
<?php
$name = "Ali"; // User's name
$age = 25; // User's age
echo $name;
echo $age;
?>کامنت در کدهای ترکیبی PHP و HTML
زمانی که PHP و HTML در یک فایل استفاده می‌شوند، باید توجه داشت که کامنت PHP با کامنت HTML متفاوت است.
برای بخش PHP می‌توان از // یا # استفاده کرد.
اما برای بخش HTML از ساختار مخصوص کامنت HTML استفاده می‌شود.
<!DOCTYPE html>
<html>
<body>