0.3الصياغة الأساسية : الوسوم، echo، التعليقات
الأساسي في 30 ثانية
- وسوم لإدخال PHP في HTML : خارج الوسوم = HTML يُرسَل كما هو، وداخلها = PHP تُنفَّذ.
- echo تعرض والفاصلة المنقوطة تُنهي : كل تعليمة تنتهي بـ ؛ — ونسيانها الخطأ رقم 1 للمبتدئ.
- وثِّق واعرض باختصار : التعليقات // و/* */، والصياغة المختصرة في القوالب.
حالة مستمرة — رياد يكتب أول صفحة
رياد، مطور ويب في قسنطينة، بيئته جاهزة : أنشأ bonjour.php في المجلد الجذر. كتب HTML مع « جزيرة » PHP بين الوسوم لعرض اسم الزائر عبر echo، وأنهى كل تعليمة بفاصلة منقوطة، وأضاف تعليقا ليهتدي، وجرَّب الصياغة المختصرة في عنوانه. فتح الصفحة عبر localhost : عرض المتصفح النتيجة، وليس الكود أبدا. سلسلة « حرِّر، شغِّل عبر localhost، اقرأ » تعمل لديه.
حالة مستقلة لهذا القسم : تعود في الدرس والمخطط والنص الجاهز وتحدي 48 ساعة للقسم 0.3.
1. الوسوم وecho
يُوضع كود PHP بين <?php (الفتح) و?> (الإغلاق). كل ما هو خارج هذين الوسمين فهو HTML (يُرسَل كما هو إلى المتصفح) ؛ وكل ما هو داخلها فهو كود PHP (يُنفِّذه الخادم). وهذا ما يجعل PHP لغة قوالب طبيعية : <h1>مرحبا <?php echo 'العالم'; ?></h1> تُنتج عنوانا جزء منه مُولَّد. echo هي البنية للعرض (إنتاج نص/HTML) — أداتك الأساسية للإخراج (وتوجد أيضا print المشابهة). كل تعليمة تنتهي بفاصلة منقوطة ; — ونسيانها خطأ المبتدئ رقم 1. لملف PHP خالص، نحذف غالبا وسم الإغلاق الأخير (لتجنب فراغات طفيلية). يكتب رياد أول echo ويرى النتيجة فورا عبر localhost.
2. التعليقات والصياغة المختصرة وحالة الأحرف
التعليقات نص يتجاهله PHP لشرح الكود : // أو # لسطر واحد، و/* ... */ لعدة أسطر — أساسية للمقروئية (لك لاحقا ولغيرك). الصياغة المختصرة <?= $variable ?> المكافئة لـ <?php echo $variable; ?> عملية في قوالب HTML. وأخيرا حالة الأحرف : الكلمات المفتاحية والدوال غير حساسة لحالة الأحرف (echo أو ECHO تعملان)، لكن المتغيرات (Variable) حساسة لها ($nom و$Nom مختلفان) — ومن هنا أهمية الاتساق. يُعلِّق رياد كل كتلة من صفحته في قسنطينة ويعتمد حالة أحرف واحدة لمتغيراته.
3. الهيكلة : فصل المنطق عن العرض
يمكن أن يكون ملف .php معظمه HTML مع « جزر » PHP (وضع القالب، طبيعي للعروض) أو معظمه PHP (ملفات المنطق). المبدأ الأساسي : فصل المنطق عن العرض — عالج البيانات أولا، ثم اعرض بإدخالات بسيطة — وإلا نحصل على « كود سباغيتي » غير مقروء (نمط MVC في القسم 4-1 سيُؤطِّر ذلك). في العروض، نُقلِّل PHP إلى الحد الأدنى (العرض والتكرار (Loop) والتفرع) ونهرب البيانات المعروضة (القسم 3-4). يضع رياد حساباته أعلى bonjour.php وHTML أسفله : فتبقى صفحته مقروءة.
🔎 مثال ملموس — 🔎 مثال ملموس — أول سكربت
مزج PHP مع HTML.
مرحبا
اليوم هو
القراءة : يفتح رياد الصفحة عبر localhost : يعرض العنوان الاسم، وتاريخ اليوم مُولَّد عبر PHP.
الدرس : صفحة تُولِّد فيها PHP الأجزاء الديناميكية — مع رد فعل تهريب البيانات المعروضة (انظر 3.4).
مفردات القسم
- وسوم PHP
- يُوضع كود PHP بين `` ؛ خارج الوسوم = HTML (يُرسَل كما هو)، وداخلها = كود PHP (يُنفَّذ). تسمح بمزج PHP مع HTML.
مثال بسيط: يُدخل رياد اسما ديناميكيا وسط عنوان HTML.
ما ليس كذلك: زخارف اختيارية حول الكود.
رد فعل: ادخل واخرج من وضع PHP كلما لزم في قالب.
- echo
- بنية للعرض (إنتاج المخرجات) : `echo 'مرحبا';` تُولِّد نصا/HTML في الصفحة. أداة الإخراج الأساسية (وأيضا `print`).
مثال بسيط: يعرض رياد « مرحبا، PHP ! » ويتحقق من النتيجة في المتصفح.
ما ليس كذلك: دالة تقرأ إدخال المستخدم.
رد فعل: اعرض أولا للتحقق، ثم افترض بعدها.
- الفاصلة المنقوطة
- تُنهي كل تعليمة PHP (`;`) ؛ ونسيانها يُحدث خطأ صياغة — الخطأ الأكثر شيوعا للمبتدئ.
مثال بسيط: ينسى رياد فاصلة منقوطة : يُشار إلى الخطأ في السطر التالي، فيُصحح السابق.
ما ليس كذلك: مجرد خيار أسلوبي دون أثر.
رد فعل: أمام خطأ صياغة، تحقق من الفاصلة المنقوطة في السطر السابق.
- التعليقات
- نص يتجاهله PHP لشرح الكود : `//` أو `#` (سطر واحد)، و`/* ... */` (عدة أسطر) ؛ أساسية للمقروئية.
مثال بسيط: يُعلِّق رياد أعلى bonjour.php ليشرح ما تُولِّده الصفحة.
ما ليس كذلك: نص يُعرض للزائر.
رد فعل: علِّق على « لماذا »، وليس على كل سطر بديهي.
- الصياغة المختصرة
- مكافئة لـ `` : فـ `` تعرض متغيرا (Variable)، وهي عملية في قوالب HTML. المتغيرات حساسة لحالة الأحرف (وليست الكلمات المفتاحية).
مثال بسيط: يكتب رياد في عنوانه بدلا من كتلة echo كاملة.
ما ليس كذلك: صياغة مخصصة لملفات المنطق الخالص.
رد فعل: في العروض، فضِّل للعروض البسيطة.
في التطبيق — عمليا — اكتب أول كود PHP
- أنشئ ملف .php في المجلد الجذر وأدخل PHP في HTML بالوسوم ``.
- اعرض نصا عبر `echo 'مرحبا، PHP!';` (لا تنس الفاصلة المنقوطة !) وافتح الصفحة عبر localhost.
- امزج HTML مع PHP : `
مرحبا
` ؛ وجرِّب أيضا الصياغة المختصرة ``. - أضف تعليقات (`//` و`/* ... */`) لتوثيق كودك، وتحقق من ظهور النتيجة صحيحا.
نص جاهز — احكِ عن أول صفحة (30 ثانية)
« أنشأت bonjour.php في المجلد الجذر : HTML مع جزيرة PHP بين الوسوم تعرض الاسم عبر echo. كل تعليمة تنتهي بفاصلة منقوطة، وعلَّقت كودي، وعبر localhost أرى النتيجة — وليس الكود أبدا. »
يُقال مع عرض ملف .php والصفحة المعروضة في المتصفح جنبا إلى جنب.
قالب جاهز للنسخ — أول صفحة PHP
مرحبا
دون متغير
ابدأ بـ echo ثابت (« مرحبا، PHP ! ») يُفتح عبر localhost، ثم أدخل متغير $prenom والصياغة المختصرة — خطوة بخطوة.
صائد الفاصلة المنقوطة
احذف عمدا فاصلة منقوطة، واقرأ رسالة الخطأ، ولاحظ أنها تشير إلى السطر التالي، ثم صحِّح — فلن يفاجئك الخطأ رقم 1 بعدها.
ثنائي في قسنطينة
يُملي رياد ويكتب زميله : أحدهما يقرأ ملف .php بصوت عال (الوسوم وecho والتعليقات)، والآخر يصف ما يعرضه المتصفح.
نحو النظيف
صفحة تعمل : انقل كل المنطق إلى أعلى الملف، ولا تُبقِ في HTML سوى عروض بسيطة، وهرِّب كل بيانات معروضة.
✓ ممارسات جيدة
- أنهِ كل تعليمة بفاصلة منقوطة (الفخ رقم 1).
- افصل المنطق (في الأعلى) عن العرض (HTML بعده).
- استخدم في القوالب ؛ وهرِّب البيانات المعروضة (3.4).
✗ أخطاء شائعة
- نسيان الفاصلة المنقوطة أو $ قبل المتغير.
- مزج المنطق المعقد مع HTML فوضويا (كود سباغيتي).
- الخطأ في حالة الأحرف لمتغير ($nom ≠ $Nom) — خطأ صامت.
النقاط الأساسية
- تُدخَل PHP في HTML عبر الوسوم `` : خارج الوسوم = HTML (يُرسَل كما هو)، وداخلها = PHP (تُنفَّذ). PHP لغة قوالب طبيعية.
- `echo` تعرض (تُنتج نصا/HTML) : أداة الإخراج الأساسية. كل تعليمة تنتهي بفاصلة منقوطة `;` (ونسيانها = خطأ، الفخ رقم 1 للمبتدئ).
- التعليقات (`//` و`#` و`/* */`) للتوثيق. الصياغة المختصرة `` (= echo) عملية في القوالب.
- الكلمات المفتاحية/الدوال غير حساسة لحالة الأحرف، لكن المتغيرات حساسة لها (`$nom` ≠ `$Nom`) — كن متسقا. ملف .php يمزج HTML مع « جزر » PHP.
تحدي 48 ساعة — طبِّق غدا
أنشئ bonjour.php بقالب رياد، وافتحه عبر localhost، وغيِّر الاسم، وأضف تعليقا يشرح الصفحة.
- صفحتي bonjour.php تُعرض عبر localhost مع الاسم المُولَّد.
- أستخدم الوسوم وecho والفاصلة المنقوطة والصياغة المختصرة دون مساعدة.
- كودي مُعلَّق والمنطق مفصول عن العرض.
أسئلة شائعة
كيف تمتزج PHP مع HTML، وكيف أُهيكل ملف PHP جيدا؟
كل ما هو خارج الوسوم `` فهو HTML (يُرسَل كما هو)، وكل ما هو داخلها فهو PHP (يُنفَّذ وتُدرَج نتيجته) ؛ ويمكن الدخول والخروج من وضع PHP كما نشاء. بنيتان : معظمه HTML مع جزر PHP (وضع « القالب »، طبيعي للعروض — مثل ``)، أو معظمه PHP (ملفات المنطق : المعالجة والدوال والأصناف). ممارسات جيدة : (1) فصل المنطق عن العرض — المبدأ الأساسي : المنطق أولا ثم العرض، ويفضل في ملفات منفصلة (MVC، القسم 4-1) ؛ (2) في العروض، تقليل PHP إلى الحد الأدنى (العرض والتكرار والتفرع) ؛ (3) استخدام للعرض ؛ (4) حذف وسم الإغلاق الأخير في ملفات PHP الخالص ؛ (5) تهريب البيانات المعروضة (أمان XSS، القسم 3.4).
ما أخطاء الصياغة الأكثر شيوعا عند المبتدئين؟
(1) الفاصلة المنقوطة المنسية (رقم 1) — وغالبا يُشار إلى الخطأ في السطر التالي، فتحقق من السطر السابق. (2) $ المنسية قبل المتغير. (3) الأقواس/المعقوفات غير المغلقة (غالبا « unexpected end of file ») — تساعد المسافة البادئة والمحرر الجيد. (4) علامات التنصيص غير المغلقة — انتبه للفاصلات داخل سلسلة. (5) حالة أحرف المتغيرات (`$nom` ≠ `$Nom`) — خطأ صامت. (6) الخلط بين = (إسناد) و== (مقارنة). (7) وسوم PHP المكتوبة خطأ. للوقاية : فعِّل عرض الأخطاء في التطوير، واستخدم VS Code مع إضافات PHP، ونسِّق المسافات واختبر بخطوات صغيرة.
ما الخطأ رقم 1 للمبتدئ في PHP؟