عرض مصدر معايير بي إتش بي الموصى بها

{{يتيمة|تاريخ=مايو 2018}}

'''معايير بي إتش بي الموصى بها''' (وتختصر: PSR) {{إنج|PHP Standard Recommendation}} هي مواصفات للغة البرمجة [[بي إتش بي]] وظيفتها توحيد المقاييس للمفاهيم البرمجية المختلفة في بي إتش بي، والهدف الرئيس هو وجود مرجع <nowiki/>[[تشغيل مشترك|توافقي تشغيلي]] بين مكونات ومكتبات <nowiki/>[[إطار عمل (برمجة)|أُطر العمل البرمجية]] ولتقديم أساس تقني عند كتابة مكون برمجي معين لضمان جودة برمجية مُثلى وممارسات أمثل في الاختبارات، وهذه المعايير تقوم عليها «مجموعة<nowiki/>[[تشغيل مشترك|التوافق التشغيلي]] بين أُطر العمل البرمجية البي تش بي» ([[اللغة الإنجليزية|إنج]]: PHP Framework Interop Group، وتختصر PHP-FIG) وهي مجموعة مكونة من عدة مؤسسين لمختلف أطر عمل بي إتش بي.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/members/
| عنوان = PHP-FIG members list
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20180114044638/http://www.php-fig.org:80/members/ | تاريخ أرشيف = 14 يناير 2018 | وصلة مكسورة = yes }}</ref>

يتم اقتراح معيار ما «يسمى اختصارا: PSR» من أي عضو ويتم التصويت عليه وفقا لبروتوكول معين معمول به لضمان العمل وفق آلية يحترمها الجميع.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/bylaws/
| عنوان = PHP-FIG voting protocol
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190306044414/https://www.php-fig.org/bylaws/ | تاريخ أرشيف = 6 مارس 2019 }}</ref>
{| class="wikitable" style="margin-bottom: 1354px;"
!الرمز
! الاسم
! الوصف
! المحرر
! المُنسق
! الراعي
! Status
|-
| PSR-0 
|معيار التحميل التلقائي
|وصف للمتطلبات الإجبارية التي يجب إتباعها في مكون التحميل التلقائي لضمان تشغيل توافقي.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-0/
| عنوان = PSR-0: Autoloading Standard
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190331021330/https://www.php-fig.org/psr/psr-0/ | تاريخ أرشيف = 31 مارس 2019 }}</ref> 
| لا أحد 
| لا أحد 
| لا أحد 
| ملغاة وحل محلها PSR-4<ref name="status">{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/
| عنوان = PSR status list
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190329100125/https://www.php-fig.org/psr/ | تاريخ أرشيف = 29 مارس 2019 }}</ref>
|-
| PSR-1 
|معيار البرمجة الأساسية
|يشمل العناصر المطلوبة كمعايير برمجية لضمان حالة مُثلى من التوافقية التشغيلية التقنية بين الأكواد المشتركة.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-1/
| عنوان = PSR-1: Basic Coding Standard
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190331041848/https://www.php-fig.org/psr/psr-1/ | تاريخ أرشيف = 31 مارس 2019 }}</ref> 
| لا أحد 
| لا أحد 
| لا أحد 
| مقبولة
|-
| PSR-2 
|دليل الأسلوب البرمجي
|يشمل PSR-1 والمقصد منه هو تقليل التعقيد عند القراءة السريعة لكود من مختلف المبرمجين، حيث يشمل عناصر عدة لكيفية كتابة كود بشكل أفضل.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-2/
| عنوان = PSR-2: Coding Style Guide
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190517113045/https://www.php-fig.org/psr/psr-2/ | تاريخ أرشيف = 17 مايو 2019 }}</ref> 
| لا أحد 
| لا أحد 
| لا أحد 
| مقبولة
|-
| PSR-3 
|واجهة مُسجل البيانات
|يصف المعايير لمكون واجهة مسجل بيانات عامة.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-3/
| عنوان = PSR-3: Logger Interface
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190517113043/https://www.php-fig.org/psr/psr-3/ | تاريخ أرشيف = 17 مايو 2019 }}</ref> 
| Jordi Boggiano 
| لا أحد 
| لا أحد 
| مقبولة
|-
| PSR-4 
|معيار التحميل التلقائي 
|يصف مواصفات كلاسات (class) التحميل التقائي للملفات من مساراتها (مكانها في المجلدات)، حيث يعتبر ذو توافقية تشغيلية عالية ويمكن إستخدامه بالإضافة للمواصفات الأخرى للتحميل التلقائي بالإضافة لـPSR-0. ويصف هذا المعيار أيضاً أين يجب وضع الملفات التي سيتم تحميلها تلقائياً بناءاً على المواصفات.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-4/
| عنوان = PSR-4: Autoloading Standard
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190331055101/https://www.php-fig.org/psr/psr-4/ | تاريخ أرشيف = 31 مارس 2019 }}</ref> 
| Paul M. Jones 
| Phil Sturgeon 
| Larry Garfield 
| مقبولة
|-
| PSR-5 
|معيار منسق التعليقات البرمجة (PHPDoc)
|الغاية الأساسية من هذا المعيار هو توفير تعريف كامل ورسمي لمعيار تنسيق التعليقات PHPDoc. هذا المعيار يختلف عن سابقه phpDocumentor بأنه يقدم دعماً لمميزات جديدة في البي اتش بي ويسد فجوات نقص سابقة.<ref>{{استشهاد ويب
| مسار = https://github.com/phpDocumentor/fig-standards/tree/master/proposed
| عنوان = PSR-5: PHPDoc Standard
| ناشر = PHP Documentor official git repository at Github.
| تاريخ الوصول = 10 January 2016
|مسار أرشيف= https://web.archive.org/web/20191213201000/https://github.com/phpDocumentor/fig-standards/tree/master/proposed|تاريخ أرشيف=2019-12-13}}</ref> 
| Mike van Riel 
| Phil Sturgeon 
| Donald Gilbert 
| مسودة
|-
| PSR-6 
|واجهة التخزين المؤقت
|
الهدف من هذا المعيار هو السماح للمطورين بإنشاء مكتبات تخزين مؤقت (cache) يمكن تضمينها في أطر عمل 
وأنظمة موجودة بالفعل ودون تغيير في بنيتها.<ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-6/
| عنوان = PSR-6: Caching Interface
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190518165445/https://www.php-fig.org/psr/psr-6/ | تاريخ أرشيف = 18 مايو 2019 }}</ref> 
| Larry Garfield 
| Paul Dragoonis 
| Robert Hafner 
| مقبولة
|-
| PSR-7 
|واجهة رسائل [[بروتوكول نقل النص الفائق]]
|تصف الواجهات العامة لعرض رسائل HTTP كما تم وصفها في المعايير الرسمية <nowiki>RFC 7230</nowiki> و <nowiki>RFC 7231</nowiki> والروابط المستخدمه كما في المعيار <nowiki>RFC 3986</nowiki>.<br /><ref>{{استشهاد ويب
| مسار = https://www.php-fig.org/psr/psr-7/
| عنوان = PSR-7: HTTP Message Interface
| ناشر = PHP-FIG official website.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190508142138/https://www.php-fig.org/psr/psr-7/ | تاريخ أرشيف = 8 مايو 2019 }}</ref> 
| Matthew Weier O'Phinney 
| Beau Simensen 
| Paul M. Jones 
| مقبولة
|-
| PSR-8 
|واجهة قابيلة <font color="#0645ad">العناق</font>
|تؤسس لطريقة مشتركة للكائنات (مكتبات) لتقدير ومساندة بعضها البعض عن طريق العناق. حيث تسمح للكائنات لدعم بعضها البعض بطريقة مبنية حديثة تسمح لاحقاً بالتعاون بين مكتبات ومشاريع بي إتش بي فيما بينها.<ref>{{استشهاد ويب
| مسار = https://github.com/php-fig/fig-standards/blob/master/proposed/psr-8-hug/psr-8-hug.md
| عنوان = PSR-8: Huggable Interface
| ناشر = PHP-FIG official git repository at Github.
| تاريخ الوصول = 10 January 2016
|مسار أرشيف= https://web.archive.org/web/20191213201002/https://github.com/php-fig/fig-standards/blob/master/proposed/psr-8-hug/psr-8-hug.md|تاريخ أرشيف=2019-12-13}}</ref> 
| Larry Garfield 
| Cal Evans 
| Paul M. Jones 
| متخلى عنها
|-
| PSR-9 
|تبيين المشاكل الأمنية
|تعطي مسؤولي مشروع ما طريقة مُعرفة بشكل واضح لتمكين مستخدميهم من إكتشاف المشاكل الأمنية بإستخدام صيغة بناء واضحة لهذه الإنذارات.<ref>{{استشهاد ويب
| مسار = https://github.com/php-fig/fig-standards/blob/master/proposed/security-disclosure-publication.md
| عنوان = PSR-9: Security Disclosure
| ناشر = PHP-FIG official git repository at Github.
| تاريخ الوصول = 10 January 2016
|مسار أرشيف= https://web.archive.org/web/20191213201005/https://github.com/php-fig/fig-standards/blob/master/proposed/security-disclosure-publication.md|تاريخ أرشيف=2019-12-13}}</ref> 
| Lukas Kahwe Smith 
| Korvin Szanto 
| Larry Garfield 
| متخلى عنها
|-
| PSR-10 
|الإنذار بالمشاكل الأمنية
|تعطي الباحثين ومسؤولي المشاريع والمستخدمين طريقة واضحة للإنذار عن مشاكل أمنية وثغرات محتملة.<ref>{{استشهاد ويب
| مسار = https://github.com/php-fig/fig-standards/blob/master/proposed/security-reporting-process.md
| عنوان = PSR-10: Security Advisories
| ناشر = PHP-FIG official git repository at Github.
| تاريخ الوصول = 10 January 2016
|مسار أرشيف= https://web.archive.org/web/20191213201007/https://github.com/php-fig/fig-standards/blob/master/proposed/security-reporting-process.md|تاريخ أرشيف=2019-12-13}}</ref> 
| Lukas Kahwe Smith 
| Larry Garfield 
| Korvin Szanto 
| متخلى عنها
|-
| PSR-11 
|واجهة الحاوية
|تصف الواجهة العامة للحاويات وحقن التوابع (dependency injection) فيها. الهدف هو وجود معيار قياسي لأطر العمل والمكتبات التي تستخدم الحاويات بكيفية جلب وتحميل الكائنات والمتغيرات فيها. <br /><ref>{{استشهاد ويب
| مسار = https://github.com/container-interop/fig-standards/blob/master/proposed/container.md
| عنوان = PSR-11: Container Interface
| ناشر = PHP-FIG PSR-11 official git repository at Github.
| تاريخ الوصول = 10 January 2016
|مسار أرشيف= https://web.archive.org/web/20191213201008/https://github.com/container-interop/fig-standards/blob/master/proposed/container.md|تاريخ أرشيف=2019-12-13}}</ref> 
| Matthieu Napoli, David Négrier 
| Paul M. Jones 
| Jeremy Lindblom 
| مقبولة
|-
| PSR-12 
|دليل الأسلوب البرمجي الأشمل 
|تستبدل وتعطي أموراً أشمل لمعيار PSR-2 ، ويتطلب هذا المعيار إحترام المعيار PSR-1.<ref>{{استشهاد ويب
| مسار = https://github.com/php-fig/fig-standards/blob/master/proposed/extended-coding-style-guide.md
| عنوان = PSR-12: Extended Coding Style Guide
| ناشر = PHP-FIG official git repository at Github.
| تاريخ الوصول = 10 January 2016
| مسار أرشيف = https://web.archive.org/web/20190131173559/https://github.com/php-fig/fig-standards/blob/master/proposed/extended-coding-style-guide.md | تاريخ أرشيف = 31 يناير 2019 | وصلة مكسورة = yes }}</ref> 
| Michael Cullum 
| Korvin Szanto 
| Alexander Makarov 
| مسودة
|-)
|PSR-13
|روابط [[هيبرميديا]]
| تعطي وصف للواجهات الشائعة لتقديم روابط هيبرميديا.<ref>{{استشهاد ويب|مسار=https://www.php-fig.org/psr/psr-13/|عنوان=PSR-13: Link definition interfaces - PHP-FIG|موقع=www.php-fig.org|تاريخ الوصول=2019-02-04| مسار أرشيف = https://web.archive.org/web/20190729010448/https://www.php-fig.org/psr/psr-13/ | تاريخ أرشيف = 29 يوليو 2019 }}</ref>
|Larry Garfield
|Matthew Weier O’Phinney
|Marc Alexander
|مقبولة<ref name="status" />
|-
|PSR-14
| مدير الأحداث
| تعطي وصف للواجهات الشاعة لإطلاق والتعامل مع الأحداث.<ref>{{استشهاد ويب |مسار=https://github.com/php-fig/fig-standards/blob/master/proposed/event-dispatcher.md |عنوان=PSR-14: Event Dispatcher |ناشر=PHP-FIG official git repository at Github. |تاريخ الوصول=4 February 2019| مسار أرشيف = https://web.archive.org/web/20200426150043/https://github.com/php-fig/fig-standards/blob/master/proposed/event-dispatcher.md | تاريخ أرشيف = 26 أبريل 2020 | وصلة مكسورة = yes }}</ref>
|Larry Garfield
|
|
|مقبولة<ref name="status" />
|-
|PSR-15
|متحكمات طلبات http ([[بروتوكول نقل النص الفائق|بروتوكول نقل النص التشعبي]])
| تعطي وصف للواجهات الشائعة لمتحكمات طلبات بروتوكول http و[[برمجيات وسيطة|برمجيات http الوسيطة]] (middleware) التي تستخدم الرسائل النصية لنتائج بروتوكل http.<ref>{{استشهاد ويب|مسار=https://www.php-fig.org/psr/psr-15/|عنوان=PSR-15: HTTP Server Request Handlers - PHP-FIG|موقع=www.php-fig.org|تاريخ الوصول=2019-02-04| مسار أرشيف = https://web.archive.org/web/20190729010451/https://www.php-fig.org/psr/psr-15/ | تاريخ أرشيف = 29 يوليو 2019 }}</ref>
|Woody Gilk
|
|Matthew Weier O’Phinney
|مقبولة<ref name="status" />
|-
|PSR-16
|[[ذاكرة مخبئية|الذاكرة المخبئة]] (الكاش) البسيطة 
|تعطي وصف لواجهة بسيطة لكنها قابلة للتوسع لمحرك الكاش وقيم الكاش.<ref>{{استشهاد ويب|مسار=https://www.php-fig.org/psr/psr-16/|عنوان=PSR-16: Common Interface for Caching Libraries - PHP-FIG|موقع=www.php-fig.org|تاريخ الوصول=2019-02-04| مسار أرشيف = https://web.archive.org/web/20190729010457/https://www.php-fig.org/psr/psr-16/ | تاريخ أرشيف = 29 يوليو 2019 }}</ref>
|Paul Dragoonis
|Jordi Boggiano
|Fabien Potencier
|مقبولة<ref name="status" />
|-
|PSR-17
|مصانع (مُولدات) HTTP ([[بروتوكول نقل النص الفائق|بروتوكول نقل النص التشعبي]])
|تعطي وصف معياري لمولدات (مصانع) كائنات (كلاسات) بروتوكول HTTP متوافقة مع معيار PSR-7 <ref>{{استشهاد ويب|مسار=https://www.php-fig.org/psr/psr-17/|عنوان=PSR-17: HTTP Factories - PHP-FIG|موقع=www.php-fig.org|تاريخ الوصول=2019-02-04| مسار أرشيف = https://web.archive.org/web/20190718131143/https://www.php-fig.org/psr/psr-17/ | تاريخ أرشيف = 18 يوليو 2019 }}</ref>
|Woody Gilk
|
|Matthew Weier O’Phinney
|مقبولة<ref name="status" />
|-
|PSR-18
|[[عميل (حوسبة)|عميل]] HTTP ([[بروتوكول نقل النص الفائق|بروتوكول نقل النص التشعبي]])
|تعطي وصف لواجهة عامة لإرسال طلبات وتلقي ردود HTTP ([[بروتوكول نقل النص الفائق|بروتوكول نقل النص التشعبي]])<ref>{{استشهاد ويب|مسار=https://www.php-fig.org/psr/psr-18/|عنوان=PSR-18: HTTP Client - PHP-FIG|موقع=www.php-fig.org|تاريخ الوصول=2019-02-04| مسار أرشيف = https://web.archive.org/web/20190718131142/https://www.php-fig.org/psr/psr-18/ | تاريخ أرشيف = 18 يوليو 2019 }}</ref>
|Tobias Nyholm
|
|Sara Golemon
|مقبولة<ref name="status" />
|-
|PSR-19
|وسوم PHPDoc (معيار التعليقات البرمجية ووصفها)
| تعطي دليل كامل للوسوم في معيار PHPDoc.<ref>{{استشهاد ويب |مسار= https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md |عنوان=PSR-19: PHPDoc tags |ناشر=PHP-FIG official git repository at Github. |تاريخ الوصول=4 February 2019|مسار أرشيف= https://web.archive.org/web/20191213201030/https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md|تاريخ أرشيف=2019-12-13}}</ref>
|Chuck Burgess
|
|
|مسودة<ref name="status" />
|}
|}

موقع مجموعة «PHP-FIG» يملك الوثائق الكاملة للمعايير «PSR» حيث تتبع صيغة المعيار <nowiki>RFC 2119</nowiki> المكتوب بواسطة «سكوت برادنير» في شهر مارس من عام 1997 في [[جامعة هارفارد]].

== المراجع ==

{{مراجع}}
{{شريط بوابات|إنترنت|تقانة|علم الحاسوب}}

{{بذرة إنترنت}}

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