إزاحة كود PHP

كيف تُحسب الإزاحة

تحتفظ الأداة بعداد للعمق. يضيف كل قوس فاتح مستوى واحدًا، ويطرح كل قوس مغلق مستوى واحدًا. يُملأ كل سطر بعدد المسافات المختار مضروبًا في العمق الحالي. الإزاحة دائمًا مسافات وليست تبويبات.

هذه الدالة نفسها بكل إعداد. كان الإدخال هو function total($items){$sum=0;foreach($items as $item){$sum+=$item["price"];}return $sum;}.

مع 4 مسافات:

function total($items)
{
    $sum=0;
    foreach($items as $item)
    {
        $sum+=$item["price"];
    }
    return $sum;
}

مع مسافتين:

function total($items)
{
  $sum=0;
  foreach($items as $item)
  {
    $sum+=$item["price"];
  }
  return $sum;
}

مسافتان أم 4 مسافات

تُعد 4 مسافات العرف الشائع في مشاريع PHP، وهي التي تطلبها معظم أدلة الأسلوب. تُبقي المسافتان الكود المتداخل بعمق أضيق، وهذا مفيد عند اللصق في حقل تذكرة صغير أو رسالة محادثة. طابق ما يستخدمه فريقك.

أمور تحتاج إلى معرفتها

• لا تُحفظ التبويبات الموجودة في المدخل، لأن المسافات حول الأقواس والفواصل المنقوطة تُعاد بناؤها.
• تعتمد الإزاحة على الأقواس فقط. الكود الممتد على عدة أسطر داخل أقواس دائرية، مثل مصفوفة طويلة، لا يُزاح أكثر.
• يُحسب القوس الموجود داخل تعليق أو داخل وثيقة heredoc، ما قد يغيّر العمق لكل ما يليه.
• لا تُبلَّغ الأقواس غير المتوازنة. إذا نفدت الأقواس المغلقة، يتوقف العمق عند الصفر ولا تُزاح الأسطر اللاحقة.

إصلاح كود فقد إزاحته

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

تحقق من النتيجة

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