عرض مصدر بي أتش بي دوك

{{لا صندوق معلومات}}
{{يتيمة|تاريخ=فبراير 2016}}

'''بي أتش بي دوك''' {{إنج|PHPDoc}} هو معيار رسمي لصيغة كتابة التعليقات على لغة البرمجة [[بي إتش بي]]، وهو مماثل لمعيار '''جافا دوك''' المتبع في لغة البرمجة [[جافا (لغة برمجة)|جافا]].<ref>[https://www.php.net/manual/fr/language.oop5.typehinting.php Documentation PHP FR : Typage objet] {{Webarchive|url=https://web.archive.org/web/20180119041811/http://php.net/manual/fr/language.oop5.typehinting.php |date=19 يناير 2018}}</ref><ref>{{officiel|https://www.phpdoc.org/docs/latest/index.html}} {{استشهاد ويب |مسار=https://docs.phpdoc.org/index.html |عنوان=نسخة مؤرشفة |تاريخ الوصول=6 نوفمبر 2020 |تاريخ أرشيف=5 مايو 2020 |مسار أرشيف=https://web.archive.org/web/20200505071103/https://docs.phpdoc.org/index.html |url-status=bot: unknown }}</ref> كما يمكن لبرمجيات التوثيق مثل phpDocumentor من إنشاء توثيق للكود مطابق لهذا المعاير ويساعد بعض [[بيئة تطوير متكاملة|بيئات التطوير المتكاملة]] مثل: [[زند ستوديو]]، [[نت بينز]]، بي إتش بي ستورم، [[كومودو إديت|كومودو اديت]]، بي إتش بي اديت، وابتانا ستوديو، في توضيح نوع المتغير وكذلك توضيح أي امر غير مفهوم في الكود، وبإتباع هذا المعيار يكون الكود البرمجي سهل التطوير والتنقيح ويسهل على المبرمجين الآخرين قراءة الكود وفهم فحواه.

كما يدعم PHPDoc [[برمجة كائنية التوجه|البرمجة الكائنية]] بالإضافة إلى [[برمجة إجرائية|البرمجة الإجرائية]].

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

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

== أنواع التعليقات في PHPDoc ==
'''التعليق على أكثر من سطر DocBlock'''

التعليق على أكثر من سطر في [[لغة برمجة|لغة البرمجة]] PHP مشابه تماما للغة البرمجة C++ حيث يبدأ التعليق بـ /** ثم في كل سطر يكون رمز النجمة * وينتهي التعليق بـ */ .

يتم كتابة هذا النوع من التعليقات قبل الكود المراد وصفة.

أي [[سطر جديد]] في التعليق لا يبدأ بعلامة النجمة * يعتبر مخالف لمعيار PHPDoc.

في هذا المثال تم تطبيق التعليق على أكثر من سطر DocBlcok على الدالة المسماة foo() ولاحظ ان التعليق تم كتابته قبل تعريف الدالة.

<syntaxhighlight lang="php">
/**
 * This is a DocBlock comment
 */
function foo()
{
}
</syntaxhighlight>

وفي هذا المثال تم تطبيق التعليق على أكثر من سطر DocBlock على الثابت المسمى aklo، مما يعني ان هذا التعليق لا علاقة له بالدالة foo

<syntaxhighlight lang="php">
/**
 * DocBlock for function foo?
 *
 * No, this will be for the constant aklo!
 */
define('aklo',2);
function foo($param = aklo)
{
}
</syntaxhighlight>

يستخدم التعليق على أكثر من سطر لوصف:

define() statements, functions, classes, class methods, and class vars, include() statements, and global variables

التعليق على أكثر من سطر DocBlock يجب ان يحتوي على النقاط التالية:

* وصف مختصر.
* وصف مفصل.
* عناوين محدده Tags.
== مراجع ==
{{مراجع}}

{{شريط بوابات|برمجة الكمبيوتر|معلوماتية}}

[[تصنيف:بي إتش بي|*]]