ملفات في مجلدك
يقرأ الملفات ويُنشئها ويعدّلها داخل مجلد العمل الخاص بالمحادثة، ويعرض عدّاد عدد الملفات المنشأة والمعدّلة والمقروءة.
المنتج
تعلّم برمجة PHP ببناء مشاريع صغيرة
01
يمكنك تعلّم برمجة PHP ببناء مشاريع صغيرة داخل مجلدك بينما يتولى PHP Trail الكتابة والتشغيل والفحص. تتحول كل خطوة إلى بطاقة. تعرض البطاقة النتيجة الحقيقية، وفي Ask first تقبل كل تغيير أو ترفضه بينما يقرأ PHP Trail الملفات ويكتبها ويشغّل أمر PHP لديك ويقرأ الدليل.
مخرجات أوامر حقيقية
يشغّل Shell أمر PHP لديك ويعرض المخرجات الحقيقية ورسالة الخطأ الحقيقية ورمز الخروج الحقيقي.
خطوة مراجعة
يتوقف Ask first قبل الإجراءات التي تغيّر شيئًا، ويعرض edit_file كل تغيير على هيئة diff لتقبله أو ترفضه.
ما الذي يستطيع الوكيل فعله
- الملفاتتعمل read_file وwrite_file وappend_file وedit_file وdelete_file وmake_dir وmove_file وcopy_file وlist_dir وgrep وglob داخل مجلد العمل الخاص بالمحادثة.
- Shellيشغّل أوامر الطرفية مثل php -l file.php وphp file.php، ويعرض رمز الخروج الحقيقي عند انتهاء الأمر. تُحظر الأوامر الخطرة.
- الويبيعثر web_search على الصفحات، ويحمّل http_get صفحة واحدة، فيستطيع الوكيل قراءة دليل PHP لدالة لا تعرفها بعد.
- لقطات الشاشة والصوريقرأ ocr النص من لقطة شاشة، مثل رسالة خطأ لا تستطيع نسخها، ويحفظ gen_image ملفات صور حقيقية.
- التنسيقيطلق task وكلاء فرعيين متوازيين، ويرسل run_on_model خطوة صعبة إلى نموذج أكبر، ويحمّل skill أدلة عمل قابلة لإعادة الاستخدام، وتتولى مهارة التحكم في الإصدارات الفروع والـ commits.
- أوضاع الموافقةيتصرف Auto-run فورًا، ويتوقف Ask first قبل الإجراءات التي تغيّر شيئًا، ويكتب Plan only خطة ولا يشغّل شيئًا. تبقى الخطط بعد إعادة التشغيل.
- Cronيشغّل طلبًا وفق جدول تحدده، مثل أن تطلب من الوكيل فحص صياغة كل ملف PHP في مجلدك.
- النماذجاربط مزوّد ذكاء اصطناعي سحابيًا عبر نقطة نهاية API قياسية، أو نموذجًا يعمل محليًا على جهازك، أو النموذج المدمج. يفحص زر «Test» نقطة النهاية.
مشاريع صغيرة وتغذية راجعة حقيقية
القراءة لا تشغّل سكربتًا. دليل برمجة PHP على الورق يتوقف عند النص، أما PHP Trail فيحفظ الملف ويشغّل أمر PHP لديك ويعيد المخرجات الحقيقية لتقرأها.
انقل المجموع في totals.php إلى دالة لها نوع إرجاع، ثم شغّله.
- read_file
totals.phpتمت القراءة - grep
array_sum totals.phpتطابق واحد - edit_file
totals.php+5 -1 - Shell
php -l totals.phpexit 0 - Shell
php totals.phpexit 0
بانتظار موافقتك قبل الخطوة التاليةرفضقبول
جلستا تدريب بالتفصيل
تهريب اسم قادم من نموذج
اطلب greeting.php، وهي صفحة فيها نموذج HTML صغير يعرض الاسم المُرسَل. يحفظها write_file مع تمرير الاسم عبر htmlspecialchars، لأن مدخلات النماذج غير موثوقة، ويشغّل Shell الأمر php -l greeting.php لفحص الصياغة. تشغّل php -S localhost:8000 في طرفيتك الخاصة، لأن هذا الخادم المدمج مخصص للاختبار المحلي فقط ويجب ألا يُعرَّض للإنترنت أبدًا. أبقِه محليًا. اكتب اسمًا يحتوي على قوس زاوي وانظر هل يظهر كنص عادي. يشمل تعلّم PHP لتطوير الواجهة الخلفية معالجة النماذج من جهة الخادم مثل هذه: يصل المدخل، وتهرّبه عند الإخراج، وتختبره محليًا. اقرأ الملف في بطاقة Ask first قبل أن تقبله، واختبر الصفحة بنفسك.
افهم حلقة بوضع Plan only
انتقل إلى Plan only، وأشِر إلى حلقة foreach في totals.php أو الصقها، واسأل ماذا تفعل بالمصفوفة الترابطية. يشرح الوكيل كل سطر بخطوات بسيطة ويكتب خطة لحلقة ثانية، دون تشغيل أي أمر أو تغيير أي ملف. اقرأ الخطة أولًا. يشمل تعلّم PHP بالطريقة الصحيحة أن تسأل عن شيفرتك أنت، لا عن أمثلة مواد المبتدئين فقط. عندما يصبح الشرح مفهومًا، انتقل إلى Ask first واطلب الحلقة الثانية. يعرض edit_file التغيير على هيئة diff، ويشغّل Shell الأمر php totals.php لتقارن الأسطر المطبوعة بما توقعته. اقبل الـ diff فقط عندما تستطيع أن تقول ما يفعله كل سطر جديد.
ما الذي لا يفعله PHP Trail
PHP Trail ليس خدمة مستضافة ولا إضافة لمحرر. هو مخصص لملفاتك وأجهزتك أنت، ولا يقرر عنك ما يحق لك المساس به. تعمل أدوات الملفات داخل مجلد العمل الخاص بالمحادثة، بينما لا يقتصر Shell وأدوات الويب عليه. النتيجة ليست دليلًا، فراجع كل diff واختبر كل سكربت بنفسك.
