فهم حقيقة بي أتش بي دوك

بي أتش بي دوك (بالإنجليزية: PHPDoc) هو معيار رسمي لصيغة كتابة التعليقات على لغة البرمجة بي إتش بي، وهو مماثل لمعيار جافا دوك المتبع في لغة البرمجة جافا. كما يمكن لبرمجيات التوثيق مثل phpDocumentor من إنشاء توثيق للكود مطابق لهذا المعاير ويساعد بعض بيئات التطوير المتكاملة مثل: زند ستوديو، نت بينز، بي إتش بي ستورم، كومودو اديت، بي إتش بي اديت، وابتانا ستوديو، في توضيح نوع المتغير وكذلك توضيح أي امر غير مفهوم في الكود، وبإتباع هذا المعيار يكون الكود البرمجي سهل التطوير والتنقيح ويسهل على المبرمجين الآخرين قراءة الكود وفهم فحواه.

كما يدعم PHPDoc البرمجة الكائنية بالإضافة إلى البرمجة الإجرائية.

تم إصدار PHPDoc في 3 من ديسمبر عام 2000 ويمكن الاستعانة ببعض البرمجيات لكتابة معيار التعليقات هذا مثل phpDocumentor ودي أكسجين.

في 13 أغسطس من عام 2013 بدأت اطر العمل PHP Framework بالأعتماد على PHPDoc كمعيار لكتابة التعليقات.

قراءة المقال الكامل على ويكيبيديا ←