انتقل إلى المحتوى

منسّق PHP

نسّق شيفرة PHP بأسلوب متّسق وسهل القراءة باستخدام إضافة Prettier PHP، بما يقارب قواعد PSR-12. الصق ملفًا يبدأ بـ <?php لتحصل على مسافات وأقواس ومصفوفات وسلاسل استدعاء للطرائق منسّقة، وقوائم وسائط طويلة موزّعة وفق عرض الطباعة الذي تحدده. تُعرض أخطاء الصياغة مع رسالة المحلّل ورقم السطر والعمود، ما يساعد مطوري PHP على تنظيف الشيفرة القديمة قبل مراجعتها.

إعادة تعيين

الأسئلة الشائعة

ما المنسّق المستخدم؟

تشغّل الأداة Prettier 3 باستخدام @prettier/plugin-php 0.26 على الخادم. يتبع الناتج أسلوبًا قريبًا من PSR-12: أربع مسافات لكل مستوى افتراضيًا، وأقواس فتح الأصناف والدوال في أسطر مستقلة، وتعليمة واحدة في كل سطر.

هل تحتاج شيفرتي إلى وسم فتح <?php؟

نعم. تنسّق الإضافة الشيفرة الموجودة داخل وسوم PHP. أما ما يقع خارجها فيُعامل على أنه HTML مضمّن ويُحفظ كما هو، لذا يعود المقتطف الذي لا يحتوي على <?php دون تغيير.

ما إصدارات PHP المدعومة؟

تُفهم صياغة PHP 8 الحديثة، بما في ذلك السمات والتعدادات وتعبيرات match والدوال السهمية والوسائط المسماة وتعزيز خصائص المُنشئ والأصناف ذات الخصائص readonly. كما تُنسّق شيفرة PHP 5 و7 الأقدم.

هل سيغيّر المنسّق ما تفعله شيفرتي؟

لا. يغيّر التنسيق فقط. وقد تحدث بعض التعديلات الشكلية البحتة، مثل تحويل صياغة array() الطويلة إلى الصياغة المكافئة القصيرة []، لكن سلوك الشيفرة يبقى كما هو.

ماذا يحدث عند وجود خطأ في الصياغة؟

يتوقف التنسيق وتعرض الأداة رسالة المحلّل مع السطر والعمود، مثل موضع قوس إغلاق مفقود. أصلح ذلك الموضع ثم أعد التنسيق.

هل يمكنني استخدام علامات الجدولة أو مسافتين؟

نعم. اختر مسافتين أو 4 مسافات، أو فعّل علامات الجدولة. يتحكم عرض الطباعة، من 40 إلى 200 حرفًا، والافتراضي 80، في مواضع التفاف استدعاءات الدوال والمصفوفات والشروط.

هل تُحفظ التعليقات وكتل التوثيق؟

نعم. تبقى التعليقات السطرية والتعليقات الكتلية وكتل PHPDoc في مواضعها بجوار الشيفرة التي تصفها. ولا يُعاد تنسيق نصوصها.

هل يمكنه تنسيق القوالب التي تمزج HTML وPHP؟

ينسّق كتل PHP داخل هذه القوالب ويحافظ على HTML بينها دون تغيير. وقد تظل النتيجة بحاجة إلى تعديلات يدوية في ملفات القوالب الكبيرة.

ما مقدار الشيفرة التي يمكنني تنسيقها دفعة واحدة؟

حتى 1 MB من الشيفرة لكل طلب، ويتوقف التنسيق بعد 10 ثوانٍ. وهذا يكفي حتى للملفات المفردة الكبيرة جدًا.

هل تُحفظ شيفرتي على الخادم؟

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

نبذة عن OneClick Pro

OneClick Pro مجموعة مجانية تضم أكثر من 150 أداة ويب للمهام اليومية: تحويل الصور والوحدات، وتنسيق الأكواد والتحقق من صحتها، وفحص النطاقات وSEO، والعمل مع النصوص والتواريخ والأرقام. تعمل كل أداة دون تسجيل أو اشتراك، ولا تُستخدم البيانات التي تُدخلها إلا لحساب النتيجة ولا تُخزّن مطلقًا. استخدمها كصندوق أدوات سريع للمهام المنفردة، أو أضف الأدوات التي تعتمد عليها يوميًا إلى إشاراتك المرجعية.