Loading…

حول منسق PHP هذا منسق PHP على الإنترنت

هل لديك كود PHP فوضوي من مشاريع قديمة، أو تعديلات سريعة، أو مقاطع منسوخة؟ هذا المنسق الإلكتروني لـ PHP يشغل كودك عبر Prettier مع الإضافة الرسمية لـ PHP، مما يمنحك مخرجات بنمط PSR-12 مع مسافات بادئة وتباعد ومصفوفات متناسقة في ثوانٍ. مثالي لـ Laravel وSymfony وWordPress وواجهات برمجة التطبيقات وأوامر السطر.

لماذا تستخدم منسق PHP هذا؟

  • تنسيق متوافق مع PSR-12 لقواعد كود PHP الحديثة
  • مدعوم بـ Prettier + @prettier/plugin-php لإخراج مستقر وموحد
  • خيارات لحجم المسافة البادئة، المسافات مقابل علامات الجدولة، والالتفاف / طول السطر
  • يوحد المسافات، المسافات البادئة، المصفوفات، هياكل التحكم والأقواس
  • يعمل مع ملفات .php و .phtml و .php5 و .php4 و .inc
  • تنسيق سريع في المتصفح مع تراجع تلقائي إلى خلفية آمنة عند الحاجة
  • ممتاز لـ Laravel و Symfony و WordPress والأطر المخصصة والتطبيقات القديمة

🔧 كيفية تجميل كود PHP في 4 خطوات for php-formatter

1

1. الصق أو أسقط الكود الخاص بك

الصق كود PHP الخاص بك في المحرر، أو اسحب وأسقط ملف `.php` / `.phtml` / `.inc`. الأداة تكتشف تلقائيًا بناء جملة PHP وتجهزه للتنسيق.

2

2. اضبط خيارات التنسيق

اختر حجم المسافة البادئة، سواء استخدام المسافات أو علامات الجدولة، وطول الالتفاف / السطر المفضل. الإعدادات الافتراضية معقولة لمعظم مشاريع نمط PSR-12.

3

3. انقر على "تنسيق"

اضغط **تنسيق** لتشغيل الكود الخاص بك عبر محرك PHP الخاص بـ Prettier. في الحالات النموذجية، تظهر النتيجة على الفور تقريبًا.

4

4. راجع، انسخ، واحفظ

راجع الإخراج المنسق، ثم انسخه مرة أخرى إلى محررك أو حمّله كملف `.php`. احفظ النسخة المنظفة للحفاظ على الاختلافات المستقبلية مرتبة.

المواصفات الفنية

المعايير ودعم بناء الجملة

تم ضبط منسق PHP للأطر الحديثة والمكتبات مع الحفاظ على عمل بناء الجملة الكلاسيكي بسلاسة.

الميزةمدعومملاحظات
محاذاة PSR-12✅ نعمنمط موحد متوافق على نطاق واسع مع PSR-12 وممارسات المجتمع الشائعة.
بناء جملة PHP 7+✅ نعممساحات الأسماء، تلميحات النوع القياسي، أنواع الإرجاع، الأنواع القابلة للإلغاء، إلخ.
ميزات PHP 8+✅ نعمالسمات، الأنواع المتحدة، ترقية المُنشئ، تعبيرات المطابقة، دوال السهم.
بناء جملة المصفوفات المختصر✅ نعميُطبع المصفوفات إلى نمط `[...]` الحديث حيثما كان ذلك مناسبًا.
Heredoc / Nowdoc✅ نعميحافظ على المحتوى مع تنظيف المسافات البادئة المحيطة.
PHP + HTML مختلط✅ نعميمكنه تنسيق قوالب `.php` النموذجية التي تحتوي على HTML مضمن.

قواعد التنظيف والتخطيط

يركز محرك Prettier لـ PHP على التخطيط فقط - يظل سلوك الكود الخاص بك كما هو.

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

نموذج التنفيذ والحدود

مصمم ليكون سريعًا وآمنًا في بيئة المتصفح.

الجانبالقيمة / السلوكملاحظات
محرك التنفيذPrettier + @prettier/plugin-phpيعمل داخل المتصفح كلما كان البرنامج المساعد متاحًا.
البديل الاحتياطيخادم `/api/php-formatter` آمنيُستخدم فقط إذا تعذر تحميل البرنامج المساعد لـ PHP من جانب العميل.
مهلة الانتظار~25 ثانيةيتم إلغاء الطلبات إذا استغرق التنسيق وقتاً طويلاً.
الحد الأقصى لحجم الإدخال (نص)~2 ميجابايتحد أقصى صارم في منطق المُنسِّق.
الحد الأقصى لحجم الملف (رفع)~5 ميجابايتمحدد بواسطة إعداد `maxFileSizeBytes` للأداة.
لمستودعات الأحادي الكبيرة أو إعادة الهيكلة المجمعة، قم بتشغيل Prettier أو PHP-CS-Fixer محلياً على قاعدة الكود الخاصة بك بدلاً من الاعتماد على أي أداة عبر الإنترنت.

الخصوصية والأمان

هذه الأداة مخصصة لمقتطفات التطوير اليومية بدلاً من كود الإنتاج شديد الحساسية.

الجانبالسلوك
التنسيق من جانب العميلالمسار المفضل باستخدام وقت تشغيل Prettier في المتصفح.يتجنب إرسال الكود عبر الشبكة في الظروف العادية.
الاحتياطي من جانب الخادمإذا لم يمكن تحميل إضافة PHP، يتم إرسال الكود عبر HTTPS إلى نقطة نهاية تنسيق مؤمنة.يتم معالجته كمدخل عابر للتنسيق فقط.
التخزينلا يُقصد التخزين طويل الأمد للمدخلات الخام.قد يتم جمع مقاييس الأخطاء/الأداء المجمعة فقط.
أفضل الممارساتلا تقم بلصق الأسرار، رموز الوصول أو كلمات المرور في أي مُنسِّق عبر الإنترنت.احتفظ بالكود الحساس للأمان على الأدوات المحلية وCI.

تنسيق PHP عبر سطر الأوامر (Prettier & PHP-CS-Fixer)

عندما تعمل داخل مشروع، تكون الأدوات المحلية هي أفضل طريقة لفرض نمط متسق عبر المستودع بأكمله.

Node / npm

تثبيت Prettier مع إضافة PHP

npm install --save-dev prettier @prettier/plugin-php

يضيف Prettier وإضافة PHP الخاصة به إلى مشروعك.

تنسيق ملف PHP واحد

npx prettier --write src/Example.php --parser php

يطبق نفس النمط المستخدم بواسطة هذه الأداة عبر الإنترنت.

تنسيق جميع ملفات PHP في مشروع

npx prettier "src/**/*.php" --parser php --write

يحافظ على تنسيق قاعدة الكود بأكملها بشكل متسق.

PHP-CS-Fixer

تثبيت PHP-CS-Fixer عالمياً باستخدام Composer

composer global require friendsofphp/php-cs-fixer

يضيف أداة تصحيح نمط قوية مخصصة لـ PHP إلى مجموعة أدوات سطر الأوامر الخاصة بك.

تشغيل بقواعد PSR-12

php-cs-fixer fix src --rules=@PSR12

يطبق PSR-12 على جميع ملفات PHP تحت `src`.

استخدم هذه الصفحة للتنظيفات السريعة المؤقتة، ثم اعتمد على Prettier أو PHP-CS-Fixer في التكامل المستمر وخطافات ما قبل الالتزام للحفاظ على فريقك بأكمله بنفس النمط.

حالات الاستخدام الشائعة لمنسق PHP

Laravel / Symfony / واجهات برمجة التطبيقات الخلفية

ترتيب وحدات التحكم والخدمات وكائنات نقل البيانات قبل إعادة الهيكلة أو مراجعة الكود.

  • توحيد تنسيق وحدات تحكم HTTP ومعالجات النماذج.
  • تنظيف فئات الخدمات والمستودعات المشتركة بين الفرق.
  • ضمان نمط متسق عبر الخدمات المصغرة وواجهات برمجة التطبيقات.
// Before
class OrderController extends Controller{public function store(Request $request){$order=$this->service->create($request->all());return response()->json($order,201);}}

// After
class OrderController extends Controller
{
  public function store(Request $request)
  {
    $order = $this->service->create($request->all());

    return response()->json($order, 201);
  }
}

WordPress وقواعد التعليمات البرمجية القديمة

جلب مشاريع PHP 5 / 7 القديمة أقرب إلى المعايير الحديثة دون إعادة كتابة كل شيء.

  • تجميل كود القوالب والإضافات قبل التصحيح.
  • تنظيف المقاطع الفوضوية المنقولة بالنسخ واللصق من الدروس التعليمية.
  • الانتقال تدريجياً بالملفات القديمة نحو اصطلاحات PSR-12.

التعليم ومراجعات الكود

استخدم التنسيق للتركيز على المنطق والهندسة المعمارية بدلاً من موضع الأقواس.

  • أظهر للطلاب كيف يحسن النمط المتسق قابلية القراءة.
  • أرفق أمثلة قبل/بعد في طلبات السحب لتسليط الضوء على التحسينات.
  • استخدم كفحص سريع للعقلانية لعينات الكود في منشورات المدونات والوثائق.
// Example exercise: ask students to predict the formatted result
if($user&&$user->isAdmin()){logAction($user,"login");}

❓ Frequently Asked Questions

❓هل تدعم هذه الأداة ميزات PHP 8 الحديثة؟

نعم. يدعم المنسق بناء جملة PHP الحديث النموذجي، بما في ذلك تلميحات النوع، والأنواع المتحدة، والترقية في المُنشئ، والسمات، وتعابير المطابقة، ودوال السهم.

🔧هل يمكنني تغيير عرض المسافة البادئة أو استخدام المسافات البادئة بدلاً من المسافات؟

بالتأكيد. يمكنك اختيار حجم المسافة البادئة (1–8) وما إذا كانت المسافات البادئة تستخدم مسافات أو مسافات بادئة. يطبق المنسق تلك الإعدادات بشكل متسق في ملفك بأكمله.

📏كيف يتم التعامل مع التفاف الأسطر؟

استخدم خيار التفاف الأسعار / طول السطر للإشارة إلى مدى اتساع الأسطر. يعد تعيين 0 يعطل التفاف الأسعار بشكل فعال باستخدام حد داخلي كبير جداً.

🔐هل يتم تحميل الكود الخاص بي إلى خوادمك؟

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

🧮هل سيغير التنسيق طريقة تشغيل كود PHP الخاص بي؟

يغير المُنسِّق التخطيط فقط - المسافات البيضاء، المسافات البادئة، فواصل الأسطر وما شابه. لا يغير الدلالات عمداً. ومع ذلك، قم دائمًا بتشغيل مجموعة الاختبارات الخاصة بك بعد إعادة الهيكلة الآلية الكبيرة.

⚙️كيف أفرض نفس النمط في مشروعي؟

استخدم Prettier مع إضافة PHP أو PHP-CS-Fixer في مشروعك وخط أنابيب CI. هذه الأداة عبر الإنترنت هي واجهة أمامية مريحة للإصلاحات السريعة؛ أدوات المحلية أفضل لفرض النمط على نطاق واسع.

Pro Tips

Best Practice

أضف خطوة تنسيق (Prettier أو PHP-CS-Fixer) إلى خط أنابيب CI الخاص بك حتى لا يصل أي PHP غير مُنسَّق إلى `main`.

Best Practice

قم بتشغيل المُنسِّق قبل فتح طلب سحب للحفاظ على الاختلافات مركزة على تغييرات السلوك، وليس المسافات البيضاء.

Best Practice

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

Best Practice

عالج الأدوات عبر الإنترنت مثل المحطات الطرفية المشتركة: تجنب لصق الأسرار الإنتاجية والمفاتيح الداخلية في أي نموذج ويب.

Additional Resources

دليل نمط الترميز PSR-12
Documentation
إضافة Prettier لـ PHP
Documentation
دليل PHP
Documentation
PHP-CS-Fixer
Documentation

Other Tools