PHPDoc، قسمت سوم – Tags

۱۳۹۰/۰۲/۱۷

مستند سازیبرچسپ ها ( tags ) کلمات منفردی هستند که با نماد @ پیشوند شده اند. اطاعات برچسپ ها برای کسب کردن اطلاعات و تنظیم نمایش مستند سازی، همچنین اجازه می دهند محیط های برنامه نویسی بتنواند کد ها بخصوص متغییر ها را تجزیه و تحلیل کنند.

تمام برچسپ ها اختیاری هستند اما اگر از یک برچسپ استفاده کردید باید خصوصیات آن برچسپ را رعایت کنید.

ادامه ی مطلب



PHPDoc، قسمت دوم – DocBlock

۱۳۹۰/۰۱/۰۹

مستند سازی

DocBlock یک گسترش برای توضیحات نویسی سبک C++ در PHP است که با ‘/**’ شروع می شود و هیشه در ابتدار هر خط یک ‘*’ قرار می گیرد. در مستند سازی DocBlock بر همه عناصر مقدم است. هر خط در DocBlock که با ‘*’ شروع نشده باشد نادیده گرفته می شود. این یک نمونه مثال برای DocBlock است: ادامه ی مطلب