Laravel Code Formatter

هذا الأداة تُنسيق كود Laravel PHP من خلال تطبيق مجموعة موحدة من قواعد التنسيق التي تحافظ على السلوك وتحسن قابلية القراءة. يستهدف المطورين الذين يديرون تطبيقات Laravel، ومراجعي الشيفرة وخطوط أنابيب CI التي تُفرض نمطاً معيّناً. من خلال محاذاة التباعد والمسافات وتعليمات use إلى معيار مشترك، يقلل من الانحرافات بين الملفات والفرق. لا تُغيّر منطق الأعمال أو سلوك التشغيل.

تبدأ العملية الأساسية بتجزئة PHP، تليها تحويلات قائمة على القواعد. يتم تطبيق أساسيات PSR-12 وتوجيهات Laravel محددة، مثل تجميع تعليمات-use، وتنسيق المصفوفات بشكل متسق، ووضوح الرؤية عند الاقتضاء. تتيح الملفات الشخصية الاختيارية تحكماً أعمق: المسافة بين الأسطر 2 أو 4، الحد الأقصى لطول السطر، تفضيلات الفواصل المتبقية، وتنسيق يعتمد على إصدار PHP. الناتج عبارة عن كتلة كود جديدة بنفس الدلالات لكنها تقديم موحّد.

تشمل المدخلات سلسلة الكود، ملف تعريف التنسيق المختار وتفضيلات اختيارية. المخرجات تشمل formatted_code وdiff/patch اختياري. التحقّق يلتقط المدخلات الفارغة ومشكلات الصياغة الأساسية؛ إخفاقات الصياغة تُعيد تشخيصاً دون تطبيق تغييرات. القيم الافتراضية تضمن سلوكاً متوقعاً عند إغفال الخيارات، مما يسهل الاعتماد السريع في مستودعات مختلفة.

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