معايير الشيفرة المصدرية
هذه المعايير متفق عليها عالمياً واعتمدت من قبل PEAR, Joomla, Drupal. فهذه المعايير تريحك كثيراً بالعمل ومن يعمل بعدك على نفس الشيفرة المصدرية.
الهامش:
استخدم هامش بمقدار فراغين أو أربعة فراغات.
الجمل الشرطية:
يجب أن يترك فراغ بين كلمة الشرط والقوس الذي بداخله الشرط لتمييزهم عن استدعاء التوابع. واستخدم دائماً الأقواس المعقوفة {} داخل الجمل الشرطية حيث أنها أفضل للعين وأجمل بالترتيب.
if (condition1 || condition2) {
action1;
}
elseif (condition3 && condition4) {
action2;
}
else {
defaultaction;
}
switch (condition) {
case 1:
action1;
break;
case 2:
action2;
break;
default:
defaultaction;
}
استدعاءات التوابع:
لاتترك فراغ عند الاستدعاء بين اسم التابع والقوس الدائري وأول وسيط (parameter)، ضع فراغاً بعد الفاصلة والموسط التالي ولاتضع فراغاً بين آخر وسيط والقوس الدائري والفاصلة المنقوطة:
$var = foo($bar, $baz, $quux);
اترك فراغاً قبل وبعد المساواة دائماً.
تعريف التوابع:
function foo($bar) {
$foo = $bar;
return $foo;
}
الموسطات التي تأخذ قيماً افتراضية نضعها في آخر الموسطات وحاول دائماً أن تجعل التابع يعيد قيمة.
المصفوفات:
كما العادة بين عناصر المصفوفة يوجد فواصل وبعد الفاصلة فراغ بينها وبين العنصر التالي:
$some_array = array('hello', 'world', 'foo' => 'bar');
عندما تكون المصفوفة طويلة يفضل فصلها على عدة أسطر بحيث طل سطر يحتوي على عنصر:
$form['title'] = array(
'#type' => 'textfield',
'#title' => t('Title'),
'#size' => 60,
'#maxlength' => 128,
'#description' => t('The title of your field.'),
);
المسميات:
- أسماء التوابع:
يجب أن تكون بأحرف صغيرة وإذا كانت مؤلفة من أكثر من كلمة تفصل بـ (_):
- الثوابت:
يكتب كل الاسم بأحرف كبيرة
- الصنف (class):
$type = new stdClass();
يبدأ بحرف صغير ومابعده من كلمات بأحرف كبيرة لايفصل بينها شيء
جيد
مستنين ال Specification بتاعت ال PHPDocumentor حاليا هو ال Standard
PHPDocumentor والـ Oxygen بمواضيع لاحقة
هي مجرد مقدمة
هل هذه المعايير عامة لكل لغات البرمجة
أم هي خاصة بـ php
في كل الحالات لي عودة على الموضوع
لأني الآن شبه نائم
تحياتي
تقريباً هي عامة وتبقى لخيار المبرمج ولكن في بعض تطبيقات المصدر المفتوح أصبحت إجبارية أي أنك إذا شاركت ببناء هذا التطبيق فيجب أن تتقيد بهذا النمط كي يخرج التطبيق كله بسمت واحد.
بالنسبة للجافا فالموضوع يختلف
مثلاً عندك موضوع الفئات
الفئة في جافا تبدأ بحرف كبير
وكل حرف في الكلمات يبدأ بحرف كبير
بالنسبة لأسماء الدوال(التوابع على رأيك)
فإنها تبدأ بحرف صغير
ويفصل بين الكلمات بحرف كبير في بداية كل كلمة
لكن يبدو لي أني استفدت من المقال
فأنا من الأناس الذين لا يعرفون شيئاً عن الترتيب
تحياتي
اهه معلومات جميلة … هي معايير الصن؟
والتوابع ليس على رأيي ولكن هكذا تسمى عندنا
أنا سمعت هذه الترجمة مسبقاً
لكني أراها سيئة
لأنها لا تمت للكلمة الإنجليزية method or function
لهذا أجد استخدام كلمة دالة
أحسن الخيارات المتاحة
هل هناك سبب لاختيار هذه الترجمة؟
من أي ناحية من النواحي
ربما أكون مخطئ
بالتأكيد هي معايير صن
بالمناسبة أجدها جيدة جداً في موضوع القراءة
تحياتي
بلغة الرياضيات:
f(y) = x
يسمى تابع لأن y تتبع لقيمة x
على كل بعد فترة سأتابع الموضوع بشكل جدي مع عرب آيز
[...] معايير الشيفرة المصدرية [...]
أسأل الله أن يتبعك بالسعادة بعد كل موضوع تكتبه =)
جزيت خيراً ..
إستفدت منك الكثير =)
بالتوفيق أخي الكريم وأسعدني وجودك وتعليقك.