PHPDoc، قسمت سوم – Tags

۱۳۹۰/۰۲/۱۷

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

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

ادامه ی مطلب



PHPDoc، قسمت دوم – DocBlock

۱۳۹۰/۰۱/۰۹

مستند سازی

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



PHPDoc، قسمت اول – معرفی

۱۳۸۹/۱۲/۲۲

مستند سازیهر برنامه نویسی که در سطح مبتدی برنامه نویسی می کنه وقتی یه واژه جدید بگوشش می خوره شاخکاش تیز می شه تا با افزایش دانش خودش سطح برنامه نویسیش رو ارتقاع بده… “مستند سازی” هم می تونه یک واژه جدید باشه. با یک جستجوی کوچیک می شه یه چیزایی راجع به مستند سازی متوجه شد. اما این دانش ابتدایی سوالاتی رو در ذهن ایجاد می کنه که پاسخ به اون سوالات می تونه به پیشرفت در این دانش جدید کمک کنه! ادامه ی مطلب