توضیحات اضافه در پی‌اچ‌پی

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

برای انجام این کار در زبان پی‌اچ‌پی (در بسیاری از زبان‌های دیگر نیز این روش ثبت توضیحات مورد قبول است) می‌توانید به یکی از سه روش زیر عمل کنید:

روش اول: نظر یا توضیحات چند خطی خود را بین دو علامت ‌*/ و ‌/*‌ قرار دهید. به‌عبارت دیگر در ابتدای جمله یا پاراگراف موردنظر خود که می‌خواهید به‌عنوان توضیحات اضافه ثبت شود و بخشی از برنامه به‌شمار نرود، ‌باید در ابتدای جملات خود *‌/‌ و در انتهای آن نیز ‌/*‌ را قرار دهید.

روش دوم: اگر نظر یا توضیح شما به‌صورت یک خطی است می‌توانید از دو علامت ‌/‌ به‌صورت ‌/‌‌/‌ کمک بگیرید. چنانچه این علامت در خطی وارد شود تمامی عبارات موجود در سمت راست آن نادیده گرفته شده و به‌صورت توضیحات اضافه به‌شمار می‌رود (توجه داشته باشید این علامت موجب می‌شود فقط عبارات موجود در سمت راست همان خط نادیده گرفته شوند و از خط بعدی همه عبارات داخل برنامه محسوب می‌شوند).

روش سوم: این روش نیز همچون روش دوم برای نادیده گرفتن عبارات موجود در یک خط کاربرد دارد و استفاده از آن نیز به کمک علامت # امکان‌پذیر است. به‌این ترتیب هر عبارتی که در سمت راست این علامت قرار بگیرد به‌عنوان توضیحات اضافه درنظر گرفته شده و هنگام اجرای برنامه نادیده گرفته می‌شود.