نصائح مفيدة

الدرس 6

Pin
Send
Share
Send
Send


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

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

أحد الأسباب التي لا تقل أهمية عن التعليق على الكود هو التأكد من أن المتابعين يدعمون أو يضيفون وظائف لإبداعك سيستفيدون أيضًا من قراءة التعليقات المتبقية.

يوفر PHP طريقتين للتعليق: واحدة للتعليقات ذات سطر واحد ، والثانية للتعليقات متعددة الأسطر. يأخذ PHP بناء جملة التعليقات من C و C ++ و Java. لذلك ، إذا كنت على دراية بهم ، فلن تكون هناك مفاجآت لك.

PHP تعليقات سطر واحد

قبل التعليقات الموجودة على نفس السطر ، يتم وضع خطين مائلين (//) في PHP.

المثال التالي يحتوي على تعليق PHP أحادي السطر في الكود:

يمكن أن يكون تعليق سطر مفرد على سطر منفصل ، أو يمكن إضافته إلى نهاية سطر التعليمات البرمجية:

في المثال أعلاه ، سيقوم المعالج المسبق لـ PHP بتنفيذ وظيفة الصدى وتجاهل كل شيء بعد //.

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

PHP تعليقات متعددة الخطوط

يتم تعليق التعليقات متعددة الأسطر لموقع PHP مع المحددات / * و * /. يشير الرمز / * إلى بداية كتلة التعليق ، و * / يشير إلى نهايته. يوضح المثال التالي استخدام التعليق متعدد الأسطر:

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

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

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

الآن بعد أن تعلمنا بعض مفاهيم PHP الأساسية ، فقد حان الوقت لتعلم أساسيات لغة البرمجة هذه ، بدءًا من إدخال متغيرات PHP.

هذا المنشور عبارة عن ترجمة لمقال "تعليق كود PHP" أعده الفريق الودي لمشروع internet.ru على الإنترنت

بناء جملة التعليق php: تعليق سطر مفرد

بينما في html لا يوجد سوى نوع واحد من التعليقات ، يوجد في PHP ما يصل إلى نوعين. النوع الأول الذي سنناقشه هو تعليق من سطر واحد. أي تعليق يخبر المترجم أن يتجاهل كل ما يحدث على هذا الخط إلى يمين التعليقات. لاستخدام هذا التعليق ، استخدم الأحرف "//" أو "#" وسيتم تجاهل كل النصوص الموجودة على اليمين بواسطة مترجم PHP.

يرجى ملاحظة أنه لم تتم معالجة العديد من أوامر الصدى لأننا علقنا عليها باستخدام أحرف تعليق خاصة. غالبًا ما يستخدم هذا النوع من التعليقات لتدوين التعليمات البرمجية المعقدة والمربكة بسرعة أو لإزالة سطر من كود PHP مؤقتًا (للتصحيح).

بناء جملة التعليق php: تعليق متعدد الأسطر

مثل تعليقات HTML ، يمكن استخدام التعليقات متعددة الأسطر في PHP للتعليق على مجموعات كبيرة من التعليمات البرمجية أو لكتابة التعليقات في أسطر متعددة. تبدأ التعليقات متعددة الأسطر في PHP بـ "/ *" وتنتهي بـ "* /". سيتم تجاهل أي شيء بين هذه الشخصيات.

التعليق على الكود جيد!

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

اكتب التعليقات اليوم وسوف تشكر نفسك في المستقبل على ذلك! :) لن يكون من الصعب وضع شطبتين مائلة وخربشة بضع كلمات حول الكود ، لكنه سيكون مفيدًا جدًا عند العودة إليه بعد فترة!

التعليقات:

  1. ميشا - 03/04/2013 12:47

نعم ، التعليق على الكود مهم للغاية ، وأنا أتفق تمامًا مع المؤلف!

سيرجي - 03/25/2013 9:46 مساءً

لقد فهمت كل شيء كيف أقوم بذلك ، لكن حتى النص في ملف index.pxp لا يتم عرضه لي ، ولا شيء أكثر ، وفي نفس المجلد ، النص في ملف menu.pxp

سيرجي ، أنا بصراحة لم أفهم أي شيء) ما الذي لا يتم عرضه وأين؟ يجب عدم عرض التعليقات - تكون مرئية فقط في الكود المصدر للصفحة.

ستاس - 02/28/2017 13:55

أسهل من ذلك هو وضع برنامج نصي للتعليقات الجاهزة على موقع مثل disqus

فيتالي - 05/23/2017 13:30

ستاس ، الصراخ منك)) من أين يأتي القرص؟ لا يتعلق الأمر بالتعليق على الموقع ، بل يتعلق بالتعليق على المقاطع أو الكتل أو سطور الكود في PHP - وبالتالي سيكون من الأسهل على نفسك في وقت لاحق أن تفهم ما كتبته ، وإذا كان أي شخص آخر يقرأ الكود فسيكون الأمر أسهل أيضًا))

Pin
Send
Share
Send
Send