ماذا يعني التعليق خارج سطر في ملف php. كيفية التعليق لفترة من الوقت على كود HTML أو CSS أو PHP أو JS. تركيب تعليق php: تعليق سطر واحد

... اليوم في هذه المقالة القصيرة والمفيدة ، سنكتشف كيف يتم التعليق على كود البرنامج المختلف. لن أقول الكثير ، لأنك إذا كنت مهتمًا بهذا ، فقد واجهت بالفعل أسئلة هذه المشكلة ، ولديك فكرة عنها.

لقد جئت الى العنوان ... ولكن بضع كلمات للوضوح وصالح الحال. ربما تكون قد رأيت كيف يتم ذلك باستخدام كود CSS ، نظرًا لأن css هو الأكثر أهمية للعديد من المبتدئين ، مثلي.

… حسن!

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

ولكن ما يجب تذكره حول "التعليقات" بشكل عام - كل شيء هنا يعتمد بشكل صارم على الملف الذي تعمل به بشكل خاص ، وبالتالي فإن كود التطبيق مختلف.

التعليق على كود CSS

a: التمرير ، a: التركيز (اللون: # D5071E ؛ زخرفة النص: Overline ؛ / * UNDERLINE UP * /)

هذه هي الطريقة التي تشرح بها نفسك لنفسك. أو يمكنك حتى التعليق على نص css هذا تمامًا كما يلي: التفاف فقط

/ * هنا الكود * /

/ * a: التمرير ، a: التركيز (اللون: # D5071E ؛ زخرفة النص: تسطير ؛ / * UNDERLINE * /) * /

أود أن ألفت انتباهك إلى حقيقة أنه - يمكنك التعليق على الدورة الكاملة لشفرة css بهذه الطريقة ، لكن !! ثم عليك إزالة التعليقات المتكررة / * UNDERLINE BOTTOM * / ، أو اللعب بالشرط المائلة ، إذا كان التفسير مهمًا))

وإلا سيكون هناك خطأ !!

ملحوظة:

إذا فتحت الكود المصدري للصفحة - Ctrl + U وألقيت نظرة ... فسنرى أن الجزء المعلق من كود css معروض بشكل جميل في المستند الذي تم إنشاؤه! هذا إذا تم استخدام css (تم تعيين الخصائص) مباشرة في html

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

سيكون الظرف الإنجليزي (الكلمات) قابلاً للقراءة. الرمزية الروسية - لا.

التعليق على كود HTML

يتم التعليق على ملف XML بنفس الطريقة.

هام: تحقق دائمًا من الشفرة الواردة في المقالات ، على الأقل بصريًا) وإلا فقد تكون هناك أخطاء.

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

لمعلوماتك:

كما قيل في الملاحظة السابقة - كذلك التعليق ... يتم عرض كود html في المستند الذي تم إنشاؤه!

ضعه بمخيلتك.

وهذا شيء آخر:

بالإضافة إلى حقيقة أن الكود المعلق يتم عرضه في الكود المصدري للصفحة (مما يعني أنه تمت معالجته بشكل ما ، على الرغم من أنه سيكون غير مرئي على الصفحة أيضًا!) - من الأفضل إزالة بعض وظائف php جنبًا إلى جنب مع html من المستند النشط.

على سبيل المثال:

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

من الممكن القيام بذلك إذا كنت لا تريد إخراج جزء من التعليمات البرمجية من المستند:

أضف قبل الفتح كود HTML "الإضافي" الضروري... وظيفة مضمنة ... وإغلاق؟> ...

باختصار ، هذه هي الطريقة التي يمكنك القيام بها إذا كان الرمز كبيرًا:

**/ ?>

ثم سيكون المصدر نظيفًا!

أو ببساطة أكثر:

دعونا نعلق على الوظيفة نفسها في وثيقة html. سيكون الكود المصدري في هذه الحالات نظيفًا فيما يتعلق بتطوير الوظائف!

كيفية التعليق على JavaScript

إذا (يتم عرضه || معروض) (// لا تقوم بتشغيل الرسوم المتحركة مرة أخرى ،) وإلا (// على السطر ، قم بتطبيق أي تعليق // على السطر ، قم بتطبيق أي تعليق // صحيح ؛

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

كما تفهم ، فإن الشرطة المائلة "//" مزدوجة ، هذه إشارة التعليق ... سطر واحد!

يتم التعليق على باقي كود JS مثل php ، والمزيد حول ذلك أدناه:

ملاحظة:

التعليق على كود PHP

... و ... هنا هو نفسه - شرطة مائلة ... سطر واحد.

لكن لاحظ أنه يمكن التعليق عليها تمامًا مثل كود CSS.

... أو هكذا يمكنك التعليق - خيار من سطر واحد ، عندما نستخدم ليس شريحتين ، ولكن BECAR (التجزئة) قبل السطر المعلق:

... بطبيعة الحال ، أنت بحاجة إلى التعليق بعناية في حلقة الشفرة!

... أو بنفس الطريقة - على غرار المثال أعلاه لـ CSS ... أي سيعمل خيار / * code * / commenting لكل من أكواد CSS و JS!

لكن بهذه الطريقة ، يمكنك التعليق على شرح أكثر ضخامة لرمز PHP ، في مكان ما بين الأمثلة الرئيسية ...

يمكنك أيضًا التعليق في حلقات php مثل هذا ، إذا كانت الشفرة مختلطة ... php و html بطريقة ما

على غرار ما ورد أعلاه:

على سبيل المثال ، نوع من الوظيفة ... في مكان ما في الكود العام (أو حلقة في html):- يمكنك التعليق ، أي إضافة التسمية الخاصة بك مثل هذا:

أو مثل هذا: خيار سطر واحد ...

الذكاء:

كود php غير مرئي في أي أكواد مصدر !! فقط نتيجته الوظيفية مرئية - العمل خارج!

بشكل عام ، هذا كل ما أردت الإبلاغ عنه اليوم!

الآن يمكنك تجربة ... حظا سعيدا.

وطبعا اقرأ مقالات الموقع واشترك:
أشارك تجربتي المريرة - بعض المعرفة ، من أجل رفاهيتك الحلوة))

... مدينة مشرفي المواقع Mikhalika.ru© - بسهولة مع وورد

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

تعليقات HTML

في HTML ، يتم تكوين التعليقات باستخدام الرموز:... وبالتالي ، فإن أي نص بين هذه الرموز هو تعليق. لنفكر في مثال:

مثال تعليقات HTML

التعليقات في CSS

يتم إنشاء تعليقات CSS باستخدام الرموز: / * و * /. لإنشاء تعليق ، ما عليك سوى وضع رمز صفحة الويب بين هذه الرموز:

/ * بداية الكتلة بأنماط لـ Body * / body (الخلفية: #efeded ؛ عائلة الخطوط: Verdana ، Helvetica ، sans-serif ؛ حجم الخط: 12 بكسل ؛ الهامش: 0 بكسل ؛ الحشو: 0 بكسل ؛) / * نهاية كتلة مع أنماط للجسم * /

تعليقات PHP

يمكن أن تكون تعليقات PHP أحادية السطر أو متعددة الأسطر:

1) يتم إنشاء تعليقات سطر واحد في PHP باستخدام الرموز: //. تحتاج فقط إلى وضع هذا الرمز أمام السطر وسيتم التعليق عليه. يُستخدم هذا الخيار في الحالة التي يتكون فيها التعليق من سطر واحد فقط.

2) لتنفيذ التعليقات متعددة الأسطر ، تم استخدام الرموز التالية: / * و * /. يكون هذا الخيار مفيدًا إذا كان التعليق يمتد لعدة أسطر.

وهكذا ، تعلمنا أن نفعل

التعليقات في PHP تشبه التعليقات المستخدمة في HTML. في صيغة PHP ، تبدأ التعليقات دائمًا بتسلسل خاص من الأحرف وسيتجاهل المترجم جميع النصوص التي تظهر بين هذه الأحرف الخاصة.

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

في حالة نسيان أو عدم معرفة كيفية كتابة التعليقات بتنسيق HTML ، راجع المثال أدناه.

تركيب تعليق php: تعليق سطر واحد

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

Psst ... لا يمكنك رؤية تعليقات PHP الخاصة بي! // صدى "لا شيء" ؛ // صدى "اسمي Humperdinkle!" ؛ # صدى "أنا لا أفعل أي شيء سواء" ؛؟>

نتيجة:

مرحبا بالعالم! Psst ... لا يمكنك رؤية تعليقات PHP الخاصة بي!

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

تركيب تعليق php: تعليق متعدد الأسطر

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

نتيجة.

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

التعليقات: جيدة وسيئة

يتوفر التعليق على التعليمات البرمجية في معظم لغات البرمجة (ربما جميعها ، ولكن بدرجات متفاوتة من الإتاحة). عادةً ما يتم استخدام التوضيحات اللفظية لمساعدة أعضاء الفريق الآخرين على التطوير بشكل أكبر ، أو ببساطة لتذكير أنفسنا بأن هذه المنطقة تحتاج إلى إصلاحات ("FIX ME").

طبعا شرح ما هو مكتوب نعمة. ولكن بمساعدة التعليقات ، يمكنك أيضًا شطب جميع الجوانب الجيدة للكود. لمنع حدوث ذلك ، من الضروري التمييز بين أنواع التعليقات:

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

جافا سكريبت. بداية سريعة

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

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

في بعض الأحيان ، يغمر المحترفون شعورًا مشابهًا. على سبيل المثال ، عندما يبدو كل شيء ملتويًا بشكل مدهش ، يجب أن يكون هناك حل أفضل. لحفظ المتابعين من البحث عن الأفضل ، يمكن للمبرمج ترك ملاحظة مثل هذه: # time_spent_here = 24h

بعد هذه الكلمات ، قلة من الناس يريدون قضاء الكثير من الوقت. وبالتالي ، فأنت تحذر من أنه تم بالفعل تسوية العديد من الخيارات المختلفة. في الوقت نفسه ، يجب تجنب مثل هذه الهجمات: #i_hate_this ، # try_to_do_better_ass ٪٪ le. بهذه الطريقة ، أنت تظهر فقط سلوكًا غير احترافي. لا تساوم نفسك وصاحب العمل.

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

ضع علامة كعنصر وظيفي

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

جافا سكريبت

…

…< div > . . . < / div > < ? -- закомментированныйкоднаphp -- > < div > . . . < / div >

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

باستخدام طريقة مناسبة لك ، حدد جزءًا من النص (الماوس ، الاختصارات).

اضغط على اختصار لوحة المفاتيح Ctr + Shift + /

بالإضافة إلى ذلك ، يمكنك التعليق على السطر الحالي. كل شيء هو نفسه ، فقط بدون Shift.

ميزة هذا النوع من التعليق هي التغطية المتزامنة لعدة لغات. نادرًا ما تكون لغة PHP بمفردها. بهذه الطريقة ، لن تضطر إلى اللجوء إلى وضع علامات على كل منها. تدعم البيئة العديد من لغات الويب. ما عليك سوى اختيار جزء وبيع المجموعة - هذا هو الرمز متعدد اللغات والتعليق عليه. بنفس الطريقة ، يمكن تنشيطه.

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

جافا سكريبت. بداية سريعة

تعلم أساسيات JavaScript بمثال عملي لبناء تطبيق ويب