المحتوى
التعليق هو نوع من الملاحظات التي يمكن استخدامها لشرح الغرض من مقتطف الشفرة ومعناه. عند العمل في PHP ، سيكون لديك العديد من الخيارات لكتابة التعليقات التي تأتي من لغات البرمجة القديمة المعروفة: عن طريق إدخال تعليقات C أحادية السطر أو متعددة الأسطر. يمكنك استخدام التعليقات لمنع جزء من التعليمات البرمجية من العمل ، أو لمجرد الاحتفاظ بالسجلات.
خطوات
جزء 1 من 2: الأنماط
1 تعليقات سطر واحد للوظائف القصيرة. إذا كنت بحاجة إلى ترك تعليق قصير ، فاستخدم رمز التعليق المكون من سطر واحد. سوف يمتد التعليق فقط إلى نهاية السطر أو نهاية كتلة التعليمات البرمجية. تعمل هذه التعليقات فقط ضمن علامات PHP وستتم قراءتها فقط إذا تم وضعها بتنسيق HTML. ؟ php // هذه هي الطريقة القياسية (C ++) لإنشاء تعليق من سطر واحد # يمكنك أيضًا استخدام نمط Unix هذا لإنشاء تعليق من سطر واحد؟> var13 ->
2 استخدم التعليقات متعددة الأسطر لكتابة تعليقات طويلة أو رمز اختبار. تعد التعليقات متعددة الأسطر مفيدة جدًا لكتابة تفسيرات طويلة ولمنع معالجة جزء من التعليمات البرمجية. اقرأ قسم الاستخدام للحصول على بعض النصائح حول استخدام التعليقات متعددة الخطوط. ؟ php / * إليك كيفية تنسيق تعليق متعدد الأسطر. سيتم تضمين كل النص حتى نهاية العلامة في التعليق * / / * يحب بعض الأشخاص تضمين * في بداية كل سطر * رموز نقطية إضافية. سيؤدي ذلك إلى تحسين * قابلية قراءة التعليقات الكبيرة ، على الرغم من أنها غير مطلوبة. * /؟> var13 ->
جزء 2 من 2: استخدام ملفات
1 استخدم التعليقات لترك ملاحظات على صحة الكود. لا يتعين عليك القيام بذلك لكل سطر من التعليمات البرمجية ، حيث يمكن للمبرمجين الآخرين بسهولة اكتشاف التعليمات البرمجية المكتوبة جيدًا. تكون التعليقات مفيدة عندما تؤدي التعليمات البرمجية الخاصة بك وظائف غير قياسية أو غير واضحة. // إنشاء طلب curl $ session = curl_init ($ request) ؛ // أخبر curl باستخدام HTTP POST curl_setopt ($ session، CURLOPT_POST، true) ؛
2 اترك تعليقات حتى لا تنسى ما فعلته بالرمز. عند العمل في مشروع ما ، ستمنعك التعليقات من نسيان المكان الذي توقفت فيه. اترك تعليقات للرمز الذي لا يعمل بشكل صحيح أو لم تنته بعد. // قبل الانتقال إلى الخطوة التالية ، تحقق جيدًا من إخراج هذا البرنامج echo "Hello World!" ؛
3 اترك تعليقًا للرمز الذي تخطط لمشاركته. إذا كنت تخطط للتعاون مع مبرمجين آخرين أو ستجعل الكود الخاص بك متاحًا للعامة ، فإن التعليقات ستساعد الآخرين على فهم كيفية عمل الكود الخاص بك وما الذي يجب إصلاحه. / * هل هناك طريقة أفضل لتحقيق ذلك؟ * / Gender: input type = "radio" name = "gender"؟ Php if (isset ($ gender) && $ gender == "female") صدى "محدد" ؛؟> value = "female"> نوع الإدخال الأنثوي = "radio" name = "gender"؟ php if (isset ($ gender) && $ gender == "male") صدى "محدد" ؛؟> value = "ذكر "> ذكر
4 اترك التعليقات للتراجع عن كتل معينة من التعليمات البرمجية. هذا مفيد للغاية عندما تختبر الكود الخاص بك وتريد إيقاف تشغيل جزء منه. سيتم تجاهل أي شيء مدرج في علامة التعليق عند بدء الصفحة. ؟ php echo "/ * Hello * / World!"؛ / * عند تشغيل الكود أعلاه ، لن تنعكس كلمة "مرحبًا" * /؟> Var13 ->
5 كن حذرًا عند التعليق على أجزاء كبيرة من التعليمات البرمجية. ستنتهي وظيفة التعليق عندما تكون علامة الإكمال الأولى نشطة ، لذلك إذا كان هناك تعليق متعدد الأسطر داخل الكود الذي قمت بالتعليق عليه بالفعل ، فسيستمر فقط حتى بداية التعليق الأصلي. ؟ php / * echo "Hello World!"؛ / * هذا التعليق سوف يفسد كل شيء * / * /؟> Var13 ->
؟ php / * echo "Hello World!"؛ // سيكون هذا التعليق جيدًا * /؟> Var13 ->
6 استخدم التعليقات لإنشاء تسجيلات زائفة. يمكنك استخدام بعض تنسيقات التعليمات البرمجية الإبداعية لإنشاء إدخال رمز داخلها مباشرةً. هذا مفيد جدًا لمشاريع مفتوحة المصدر. ؟ php // ============= // HEADER // ============== // ------------ - // العنوان الفرعي // ------------- / * اسم القسم * / # يمكن كتابة المدخلات هنا # يمكن كتابة الجزء الثاني هنا / * * استخدم هذا للشرح * لماذا قد تحتاج إلى بضعة أسطر * أو حتى بضع نقاط من الشرح * /؟> var13 ->
نصائح
- تختلف تعليقات HTML و PHP عن بعضها البعض ، لذلك عند العمل مع البرامج النصية (مزيج من HTML و PHP) ، تأكد من استخدام الصيغة الصحيحة.
- على سبيل المثال ، تحتوي الكود التالي على تعليق HTML ، لكنه لا يزال ينفذ كود PHP. إذا قمت بوضع تعليق HTML داخل علامة PHP ، فسيؤدي ذلك إلى حدوث خطأ.
- ! - div id = "example">؟ php echo ’hello’؛ ؟> var13 -> / div> ->
