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

معايير بي إتش بي الموصى بها (وتختصر: PSR)  هي مواصفات للغة البرمجة بي إتش بي وظيفتها توحيد المقاييس للمفاهيم البرمجية المختلفة في بي إتش بي، والهدف الرئيس هو وجود مرجع توافقي تشغيلي بين مكونات ومكتبات أُطر العمل البرمجية ولتقديم أساس تقني عند كتابة مكون برمجي معين لضمان جودة برمجية مُثلى وممارسات أمثل في الاختبارات، وهذه المعايير تقوم عليها «مجموعةالتوافق التشغيلي بين أُطر العمل البرمجية البي تش بي» (إنج: PHP Framework Interop Group، وتختصر PHP-FIG) وهي مجموعة مكونة من عدة مؤسسين لمختلف أطر عمل بي إتش بي.

يتم اقتراح معيار ما «يسمى اختصارا: PSR» من أي عضو ويتم التصويت عليه وفقا لبروتوكول معين معمول به لضمان العمل وفق آلية يحترمها الجميع.
الرمز الاسم الوصف المحرر المُنسق الراعي Status PSR-0 معيار التحميل التلقائيوصف للمتطلبات الإجبارية التي يجب إتباعها في مكون التحميل التلقائي لضمان تشغيل توافقي.  لا أحد  لا أحد  لا أحد  ملغاة وحل محلها PSR-4 PSR-1 معيار البرمجة الأساسيةيشمل العناصر المطلوبة كمعايير برمجية لضمان حالة مُثلى من التوافقية التشغيلية التقنية بين الأكواد المشتركة.  لا أحد  لا أحد  لا أحد  مقبولة PSR-2 دليل الأسلوب البرمجييشمل PSR-1 والمقصد منه هو تقليل التعقيد عند القراءة السريعة لكود من مختلف المبرمجين، حيث يشمل عناصر عدة لكيفية كتابة كود بشكل أفضل.  لا أحد  لا أحد  لا أحد  مقبولة PSR-3 واجهة مُسجل البياناتيصف المعايير لمكون واجهة مسجل بيانات عامة.  Jordi Boggiano  لا أحد  لا أحد  مقبولة PSR-4 معيار التحميل التلقائي يصف مواصفات كلاسات (class) التحميل التقائي للملفات من مساراتها (مكانها في المجلدات)، حيث يعتبر ذو توافقية تشغيلية عالية ويمكن إستخدامه بالإضافة للمواصفات الأخرى للتحميل التلقائي بالإضافة لـPSR-0. ويصف هذا المعيار أيضاً أين يجب وضع الملفات التي سيتم تحميلها تلقائياً بناءاً على المواصفات.  Paul M. Jones  Phil Sturgeon  Larry Garfield  مقبولة PSR-5 معيار منسق التعليقات البرمجة (PHPDoc)الغاية الأساسية من هذا المعيار هو توفير تعريف كامل ورسمي لمعيار تنسيق التعليقات PHPDoc. هذا المعيار يختلف عن سابقه phpDocumentor بأنه يقدم دعماً لمميزات جديدة في البي اتش بي ويسد فجوات نقص سابقة.  Mike van Riel  Phil Sturgeon  Donald Gilbert  مسودة PSR-6 واجهة التخزين المؤقتالهدف من هذا المعيار هو السماح للمطورين بإنشاء مكتبات تخزين مؤقت (cache) يمكن تضمينها في أطر عمل 
وأنظمة موجودة بالفعل ودون تغيير في بنيتها.  Larry Garfield  Paul Dragoonis  Robert Hafner  مقبولة PSR-7 واجهة رسائل بروتوكول نقل النص الفائقتصف الواجهات العامة لعرض رسائل HTTP كما تم وصفها في المعايير الرسمية RFC 7230 و RFC 7231 والروابط المستخدمه كما في المعيار RFC 3986.  Matthew Weier O'Phinney  Beau Simensen  Paul M. Jones  مقبولة PSR-8 واجهة قابيلة العناقتؤسس لطريقة مشتركة للكائنات (مكتبات) لتقدير ومساندة بعضها البعض عن طريق العناق. حيث تسمح للكائنات لدعم بعضها البعض بطريقة مبنية حديثة تسمح لاحقاً بالتعاون بين مكتبات ومشاريع بي إتش بي فيما بينها.  Larry Garfield  Cal Evans  Paul M. Jones  متخلى عنها PSR-9 تبيين المشاكل الأمنيةتعطي مسؤولي مشروع ما طريقة مُعرفة بشكل واضح لتمكين مستخدميهم من إكتشاف المشاكل الأمنية بإستخدام صيغة بناء واضحة لهذه الإنذارات.  Lukas Kahwe Smith  Korvin Szanto  Larry Garfield  متخلى عنها PSR-10 الإنذار بالمشاكل الأمنيةتعطي الباحثين ومسؤولي المشاريع والمستخدمين طريقة واضحة للإنذار عن مشاكل أمنية وثغرات محتملة.  Lukas Kahwe Smith  Larry Garfield  Korvin Szanto  متخلى عنها PSR-11 واجهة الحاويةتصف الواجهة العامة للحاويات وحقن التوابع (dependency injection) فيها. الهدف هو وجود معيار قياسي لأطر العمل والمكتبات التي تستخدم الحاويات بكيفية جلب وتحميل الكائنات والمتغيرات فيها.   Matthieu Napoli, David Négrier  Paul M. Jones  Jeremy Lindblom  مقبولة PSR-12 دليل الأسلوب البرمجي الأشمل تستبدل وتعطي أموراً أشمل لمعيار PSR-2 ، ويتطلب هذا المعيار إحترام المعيار PSR-1.  Michael Cullum  Korvin Szanto  Alexander Makarov  مسودةPSR-13روابط هيبرميديا تعطي وصف للواجهات الشائعة لتقديم روابط هيبرميديا.Larry GarfieldMatthew Weier O’PhinneyMarc AlexanderمقبولةPSR-14 مدير الأحداث تعطي وصف للواجهات الشاعة لإطلاق والتعامل مع الأحداث.Larry GarfieldمقبولةPSR-15متحكمات طلبات http (بروتوكول نقل النص التشعبي) تعطي وصف للواجهات الشائعة لمتحكمات طلبات بروتوكول http وبرمجيات http الوسيطة (middleware) التي تستخدم الرسائل النصية لنتائج بروتوكل http.Woody GilkMatthew Weier O’PhinneyمقبولةPSR-16الذاكرة المخبئة (الكاش) البسيطة تعطي وصف لواجهة بسيطة لكنها قابلة للتوسع لمحرك الكاش وقيم الكاش.Paul DragoonisJordi BoggianoFabien PotencierمقبولةPSR-17مصانع (مُولدات) HTTP (بروتوكول نقل النص التشعبي)تعطي وصف معياري لمولدات (مصانع) كائنات (كلاسات) بروتوكول HTTP متوافقة مع معيار PSR-7 Woody GilkMatthew Weier O’PhinneyمقبولةPSR-18عميل HTTP (بروتوكول نقل النص التشعبي)تعطي وصف لواجهة عامة لإرسال طلبات وتلقي ردود HTTP (بروتوكول نقل النص التشعبي)Tobias NyholmSara GolemonمقبولةPSR-19وسوم PHPDoc (معيار التعليقات البرمجية ووصفها) تعطي دليل كامل للوسوم في معيار PHPDoc.Chuck Burgessمسودة
|}

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

 المراجع 

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