Coding standards

1. 1. معايير البرمجة في MediaWiki

تهدف هذه المقالة إلى تقديم دليل شامل حول معايير البرمجة المتبعة في تطوير MediaWiki، موجهة خصيصاً للمطورين الجدد والمساهمين المحتملين. الالتزام بهذه المعايير يضمن قابلية قراءة الكود، سهولة صيانته، وتجنب الأخطاء، مما يساهم في الحفاظ على جودة النظام واستقراره. تعتبر معايير البرمجة جزءاً أساسياً من عملية التطوير التعاوني، فهي توفر إطاراً موحداً للجميع للعمل ضمنه.

أهمية معايير البرمجة

قبل الخوض في التفاصيل، من المهم فهم لماذا تعتبر معايير البرمجة ضرورية:

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

لغة البرمجة المستخدمة

يعتمد MediaWiki بشكل أساسي على لغة PHP، بالإضافة إلى استخدام JavaScript، HTML، و CSS. تغطي هذه المقالة بشكل أساسي معايير PHP، ولكن سيتم التطرق إلى بعض الجوانب المتعلقة باللغات الأخرى عند الضرورة. يجب على المطورين أيضاً أن يكونوا على دراية بـ SQL، حيث يتم استخدامها للتفاعل مع قاعدة البيانات.

معايير PHP

1. 1. 1. التنسيق العام

• المسافات البادئة: استخدم أربع مسافات للمسافات البادئة بدلاً من علامات الجدولة. هذا يضمن الاتساق بغض النظر عن إعدادات المحرر.
• الأقواس: استخدم الأقواس المتطابقة (curly braces) لتعريف نطاقات الكود (مثل الدوال، الفئات، الحلقات، الشروط). يجب أن تكون الأقواس على نفس السطر مثل العبارة التي تبدأ بها.
• الأسطر الفارغة: استخدم الأسطر الفارغة لفصل الأقسام المنطقية من الكود. ضع سطرين فارغين بين الدوال والفئات، وسطر فارغ واحد داخل الدوال لفصل أقسام الكود المختلفة.
• طول السطر: حاول ألا يتجاوز طول السطر 80 حرفاً. يمكن تقسيم الأسطر الطويلة باستخدام علامة الخط المائل العكسي (\\).
• التعليقات: اكتب تعليقات واضحة وموجزة لشرح الكود المعقد أو غير الواضح. استخدم تعليقات PHPDoc لتوثيق الدوال والفئات.

1. 1. 1. تسمية المتغيرات والدوال والفئات

• المتغيرات: استخدم أسماء وصفية وذات معنى للمتغيرات. استخدم نظام camelCase (على سبيل المثال، `$userCount`, `$firstName`).
• الدوال: استخدم أسماء وصفية وذات معنى للدوال. استخدم نظام `camelCase` أيضاً (على سبيل المثال، `getUserName()`, `calculateTotal()`).
• الفئات: استخدم أسماء ذات معنى للفئات، ابدأ بحرف كبير (PascalCase) (على سبيل المثال، `UserManager`, `DatabaseConnection`).
• الثوابت: استخدم أسماء ذات أحرف كبيرة مفصولة بشرطة سفلية (UPPER_SNAKE_CASE) (على سبيل المثال، `MAX_USERS`, `DEFAULT_TIMEOUT`).

1. 1. 1. هياكل التحكم

• عبارات `if` و `else` و `elseif` : استخدم دائماً الأقواس حول الشروط في عبارات `if` و `else` و `elseif`.
• الحلقات `for` و `while` : استخدم الأقواس حول الشروط في الحلقات `for` و `while`.
• عبارة `switch` : استخدم عبارة `break` في نهاية كل `case` لتجنب السقوط إلى الحالات التالية.

1. 1. 1. معالجة الأخطاء

• الاستثناءات: استخدم الاستثناءات لمعالجة الأخطاء بدلاً من استخدام `error_reporting` أو `set_error_handler`.
• تسجيل الأخطاء: سجل الأخطاء في ملف سجل لتسهيل عملية التصحيح.
• معالجة الأخطاء: تعامل مع الأخطاء بشكل صحيح لمنع توقف البرنامج بشكل غير متوقع.

1. 1. 1. أمان الكود

• التحقق من صحة الإدخال: تحقق من صحة جميع المدخلات من المستخدمين لمنع هجمات SQL Injection و Cross-Site Scripting (XSS).
• الهروب من البيانات: قم بتهريب البيانات قبل عرضها في HTML لمنع هجمات XSS.
• التشفير: استخدم التشفير لحماية البيانات الحساسة.
• تجنب استخدام الدوال الخطرة: تجنب استخدام الدوال التي تعتبر خطرة، مثل `eval()` و `system()`.

معايير JavaScript

• المسافات البادئة: استخدم مسافتين للمسافات البادئة.
• الأقواس: استخدم الأقواس المتطابقة لتعريف نطاقات الكود.
• الأسماء: استخدم نظام `camelCase` للمتغيرات والدوال.
• التعليقات: اكتب تعليقات واضحة لشرح الكود.
• أمان الكود: تحقق من صحة جميع المدخلات من المستخدمين لمنع هجمات XSS.

معايير HTML و CSS

• التحقق من الصحة: تحقق من صحة HTML و CSS باستخدام أدوات التحقق من الصحة عبر الإنترنت.
• التنسيق: استخدم تنسيقاً متسقاً لـ HTML و CSS.
• التعليقات: اكتب تعليقات واضحة لشرح الكود.
• إمكانية الوصول: تأكد من أن HTML الخاص بك يمكن الوصول إليه من قبل الأشخاص ذوي الإعاقة.

أدوات التحقق من معايير الكود

هناك العديد من الأدوات المتاحة التي يمكن أن تساعدك في التحقق من أن الكود الخاص بك يلتزم بمعايير البرمجة:

• PHP CodeSniffer: أداة للتحقق من معايير PHP.
• ESLint: أداة للتحقق من معايير JavaScript.
• HTMLHint: أداة للتحقق من معايير HTML.
• CSS Lint: أداة للتحقق من معايير CSS.

أمثلة على استراتيجيات الخيارات الثنائية ذات الصلة

لفهم أهمية التحليل والتنظيم، إليك بعض الاستراتيجيات والاستراتيجيات ذات الصلة بالخيارات الثنائية والتي تتطلب تطبيقًا دقيقًا:

• استراتيجية 60 ثانية: تتطلب مراقبة دقيقة لتقلبات الأسعار.
• استراتيجية مارتينجال: تتطلب إدارة صارمة لرأس المال.
• استراتيجية بينديكت: تتطلب فهمًا عميقًا للمؤشرات الفنية.
• استراتيجية بولينجر باندز: تعتمد على تحليل الانحرافات المعيارية.
• استراتيجية المتوسطات المتحركة: تتطلب تحديد فترات زمنية مناسبة.
• استراتيجية الاختراق: تتطلب تحديد مستويات الدعم والمقاومة.
• استراتيجية الارتداد: تتطلب تحديد نقاط انعكاس الاتجاه.
• استراتيجية النمط السعري: تتطلب التعرف على أنماط الشموع اليابانية.
• استراتيجية التداول المتزامن: تتطلب تحليل حجم التداول.
• استراتيجية التداول على الأخبار: تتطلب متابعة الأحداث الاقتصادية.
• استراتيجية RSI: تستخدم مؤشر القوة النسبية.
• استراتيجية MACD: تستخدم مؤشر التقارب والتباعد للمتوسطات المتحركة.
• استراتيجية ستوكاستيك: تستخدم مؤشر التذبذب العشوائي.
• استراتيجية فيبوناتشي: تستخدم نسب فيبوناتشي لتحديد نقاط الدعم والمقاومة.
• استراتيجية Ichimoku Cloud: تستخدم نظام Ichimoku لتحديد الاتجاهات.
• استراتيجية التداول الليلي: تستهدف تقلبات الأسعار خلال الليل.
• استراتيجية التداول قصير الأجل: تركز على صفقات سريعة.
• استراتيجية التداول طويل الأجل: تركز على صفقات طويلة الأمد.
• استراتيجية التداول بناءً على التوقعات: تعتمد على تحليل التوقعات الاقتصادية.
• استراتيجية التداول بناءً على الأخبار: تعتمد على تحليل الأخبار الاقتصادية.
• استراتيجية التداول بناءً على المشاعر: تعتمد على تحليل معنويات السوق.
• استراتيجية التداول بناءً على حجم التداول: تعتمد على تحليل حجم التداول.
• استراتيجية التداول بناءً على تقلبات الأسعار: تعتمد على تحليل تقلبات الأسعار.
• استراتيجية التداول بناءً على الأنماط السعرية: تعتمد على تحليل الأنماط السعرية.
• استراتيجية التداول بناءً على المؤشرات الفنية: تعتمد على تحليل المؤشرات الفنية.

الخلاصة

الالتزام بمعايير البرمجة ليس مجرد مسألة تفضيل شخصي، بل هو ضرورة للحفاظ على جودة MediaWiki واستقراره. باتباع هذه المعايير، يمكنك المساهمة في إنشاء كود قابل للقراءة والصيانة والتوسع، مما يضمن نجاح المشروع على المدى الطويل. تذكر أن الهدف هو كتابة كود ليس فقط يعمل، بل يعمل بشكل جيد ويسهل فهمه وتعديله من قبل الآخرين.

PHP، JavaScript، HTML، CSS، SQL، PHPDoc، SQL Injection، Cross-Site Scripting (XSS)، استراتيجية 60 ثانية، استراتيجية مارتينجال، استراتيجية بولينجر باندز، استراتيجية المتوسطات المتحركة، استراتيجية RSI، استراتيجية MACD، استراتيجية فيبوناتشي، استراتيجية Ichimoku Cloud

الفئة:برمجة - معايير

ابدأ التداول الآن

سجّل في IQ Option (الحد الأدنى للإيداع 10 دولار) افتح حساباً في Pocket Option (الحد الأدنى للإيداع 5 دولار)

انضم إلى مجتمعنا

اشترك في قناة Telegram الخاصة بنا @strategybin لتصلك: ✓ إشارات تداول يومية ✓ تحليلات استراتيجية حصرية ✓ تنبيهات اتجاهات السوق ✓ مواد تعليمية للمبتدئين