آموزش کامنت ها در PHP به زبان ساده

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

دو نوع کامنت در php وجود دارد:

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

کامنت های تک خطی برای توضیحات کوتاه به کار می روند. بیان کامنت تک خطی در پی اچ پی به دو صورت انجام می شود:

یک کامنت تک خطی یا با (#) آغاز می شود یا اینکه

با دو بک اسلش (//) شروع می شود.

در مثال بالا، کامنت های خط اول و دوم با علامت هش (#) انجام می شود. در خط سوم کامنت با (//) آغاز شده است.

اگر خروجی مثال داده شده را بررسی کنیم؛ مشاهده می شود که مرورگر یک صفحه خالی را نمایش می دهد. زیرا کامنت ها همیشه غیر قابل اجرا هستند.

از دیگر مثال های کامنت تک خطی

خروجی در مثال بالا؛ به این صورت است: welcome (خوش آمدید)

ما یک متغیر را برای ذخیره سازی یک رشته (“welcome) در خط دوم بیان کرده ایم. در خط سوم نیز رشته ی (“student) را قرار داده ایم؛ اما همان طور که در خروجی مشاهده می کنیم؛ فقط welcome نمایش داده می شود زیرا عبارتی که در خط سوم آمده است؛ به صورت یک کامنت تعریف شده است. بنابراین؛ نمی توان رشته (“student”) را در خروجی نمایش داد.

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

کامنت های چند خطی در واقع از چند خط توضیح تشکیل شده اند. در اینجا می توانید کامنت های بیشتری را به کار ببرید؛ این کامنت ها باید در علامت (/*….*/) محصور شوند.

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

مثال دیگری از کامنت های چند خطی

خروجی مثال بالا به این صورت است: ?Hello user how are you (سلام کاربر، حالت چطور است؟)

نکات کلیدی کامنت‌گذاری در PHP

• نقش امنیتی و تست کد (Debugging): کامنت‌ها صرفاً برای نوشتن یادداشت یا توضیح کدهای شما نیستند؛ طراحان و برنامه‌نویسان اغلب از کامنت کردن (// یا /* ... */) برای غیرفعال کردن موقت خطوطی از کد (مانند متغیر $str .= " student"; در مثال‌ها) هنگام عیب‌یابی و دیباگ کردن برنامه‌ها استفاده می‌کنند.

• تفاوت ساختاری کامنت‌های تک‌خطی: در PHP برای کامنت‌های تک‌خطی دو روش وجود دارد: استفاده از دو اسلش (//) و استفاده از علامت هش (#). هرچند هر دو خروجی یکسانی دارند، اما طبق استانداردهای کدنویسی مدرن، استفاده از // متداول‌تر و خواناتر است.

• عدم نمایش در سورس‌کد نهایی مرورگر: برخلاف زبان‌هایی مثل HTML (که کامنت‌ها با کلید View Source در مرورگر قابل مشاهده هستند)، کامنت‌های PHP به طور کامل در سمت سرور پردازش و حذف می‌شوند و هیچ‌وقت به مرورگر کاربر ارسال نمی‌گردند؛ بنابراین از نظر امنیتی کاملاً مخفی می‌مانند.

جمع‌بندی

کامنت‌ها ابزاری ساده اما حیاتی برای خوانایی، مستندسازی و نگهداری کدهای PHP هستند. چه بخواهید توضیحی برای بخش‌های پیچیده کد خود بنویسید و چه بخواهید بخشی از کد را موقتاً از چرخه اجرا خارج کنید، تسلط بر نحوه استفاده درست از کامنت‌های تک‌خطی (// و #) و چندخطی (/* ... */) به شما کمک می‌کند کدهایی تمیزتر، ساختاریافته‌تر و قابل فهم‌تر برای خود و دیگر توسعه‌دهندگان بنویسید.