# دعم Maguyva للغة PHP: تطبيقات ويب طويلة العمر دون تعديلات عمياء

Canonical source: https://maguyva.ai/ar/languages/php

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

يدعم Maguyva لغة PHP عبر تحليل AST واستخلاص الرموز، بحيث يستطيع وكلاء الذكاء الاصطناعي التنقّل في تطبيقات Laravel، والأطر المخصَّصة، وكود عصر WordPress، وغيرها من مستودعات PHP طويلة العمر ببنية أوضح من مجرد grep.

## لمحة عن الدعم

- المستوى: دعم AST والرموز
- البرمجة
- الامتدادات: .php, .php3, .php4, .php5, .phps, .phtml
- تحليل AST حقيقي لبحث واعٍ بالصياغة النحوية وسياق بنيوي.
- تُغذّي الرموز المسمّاة البحث الدلالي والمراجع المتقاطعة. ويتوفر التنقل عبر الرسم البياني عند تمكين استخراج العلاقات.
- تُسهم هذه اللغة بالرموز والعلاقات في البحث المراعي لبنية الرسم البياني؛ وتختلف أنواع الحواف المدعومة بحسب التراكيب الأصلية في اللغة.
- يتوفر كل من تحليل AST واستخلاص الرموز.

## الأنسب لـ

- مستودعات Laravel أو PHP مخصَّصة أو أحادية الكتلة مختلطة لا تزال مهمة تشغيليًا.
- فرق تصون تطبيقات ويب أقدم تتجاور الآن مع واجهات JavaScript الأمامية وكود البنية التحتية.
- أعمال إعادة هيكلة بمساعدة الذكاء الاصطناعي حيث الأولوية هي فهم التدفق القائم قبل تغييره.

## سير عمل الوكلاء

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

## لماذا تحتاج PHP إلى بحث واعٍ بالبنية

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

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

## ما الذي يستخلصه Maguyva فعليًا في PHP

يُزيل Maguyva رمز `$` من التعريفات، ويُطبِّع استدعاءات الأعضاء ذات البادئات، ويُصفِّي قدرًا كبيرًا جدًا من ضجيج دوال PHP المدمجة من رسم العلاقات البياني. وهذا بالضبط نوع التنظيف الذي يحتاجه كود PHP الأقدم قبل أن تصبح طرق عرض البحث والتبعيات مفيدة.

كما يدعم أشكال الملفات التي تصادفها فرق PHP فعليًا، من `.php` و`.phtml` إلى امتدادات الملفات القديمة المرتبطة بإصدارات سابقة، والتي لا تزال تظهر في المنظومات طويلة العمر.

## سير عمل MCP مفيد لتطبيقات PHP طويلة العمر

النمط المثمر عادةً هو:

- `find_symbol` لوحدات التحكم أو الخدمات أو النماذج أو الأصناف المساعدة ذات الأسماء الثابتة.
- `text_pattern_search` لأسماء المسارات، أو استدعاءات الدوال المساعدة، أو أعراف الأطر القديمة عندما لا يزال النص الدقيق هو المسار الأسرع.
- `get_task_context` عندما يكون مسار الكود فوضويًا وتريد ملخصًا مُجمَّعًا قبل التعديل.

## متى تكون هذه الصفحة مفيدة

هذه الصفحة مخصصة للفرق التي سؤالها العملي ببساطة هو "لا نزال نُشغِّل أنظمة مهمة بلغة PHP". إذا كانت الواجهة الأمامية تعيش في JavaScript حديثة، اقرأ [JavaScript](/ar/languages/javascript) تاليًا. وإذا كان للمستودع طبقات خدمة أو أتمتة أحدث على أطرافه، فإن [Python](/ar/languages/python) هي صفحة الرفيق الأكثر صلة.

## تفاصيل المحرك

- يزيل PHP رمز `$` من التعريفات، ويُطبِّع الاستدعاءات ذات بادئة العضو، ما يسهّل البحث المتّسق في الشيفرة القديمة كثيفة الدوال المساعدة.
- يغطّي الدعم أشكال ملفات PHP الشائعة بما فيها `.php` و`.php3` و`.php4` و`.php5` و`.phtml` و`.phps`.
- يزيل مرشّح كبير للدوال المدمجة سطح وقت تشغيل PHP القياسي، بحيث يبقى الرسم البياني مركَّزًا على شيفرة التطبيق.

## نقاط دخول مفيدة عبر MCP

- `find_symbol`: استخدمه لمتحكّم، أو خدمة، أو نموذج، أو صنف مساعد حين لا يزال للمستودع أسماء رموز يمكن التعرّف عليها.
- `text_pattern_search`: استخدمه لأسماء المسارات، أو استدعاءات الدوال المساعدة، أو أعراف الأُطر القديمة حين لا تكفي البنية وحدها.
- `get_task_context`: مفيد حين تحتاج إلى ملخّص مُجمَّع لمسار PHP قديم قبل تغييره.