أقواس PHP في سطر جديد

وضع الأقواس في هذه الأداة

للأداة تخطيط واحد لا يوجد له خيار: يبدأ كل { في سطر خاص، ويكون كل } في سطر خاص به، ويُزاح ما بداخله مستوى واحدًا. لذلك تبدأ else وcatch في سطر جديد بعد القوس المغلق.

إدخال بأقواس في نهاية السطر:

<?php if ($age >= 18) { echo "adult"; } else { echo "minor"; }

الناتج:

<?php if ($age >= 18)
{
    echo "adult";
}
else
{
    echo "minor";
}

أي نمط تستخدم؟

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

ملاحظات عملية

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

مثال على فئة

الإدخال:

<?php class User{private $name;public function getName(){return $this->name;}}

الناتج مع 4 مسافات:

<?php class User
{
    private $name;
    public function getName()
    {
        return $this->name;
    }
}

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

الجمع مع أسلوبك الخاص

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