أجهزة الكمبيوتر

كيفية إضافة تعليقات لبرنامج PHP الخاص بك

يونيو 2021

كيفية إضافة تعليقات لبرنامج PHP الخاص بك


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

تحتوي معظم البرامج التي تكتبها على أكثر من صفحة واحدة من التعليمات البرمجية. سيتم حفظ كل صفحة من التعليمات البرمجية كملف برنامج PHP. (filename.php3) هناك مكانان في ملف البرنامج حيث تريد إضافة بعض التعليقات المعلوماتية.

  1. في الجزء العلوي من كل ملف برنامج ، ستقوم بتضمين معلومات عامة حول البرنامج.

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

  2. المجال الثاني حيث تريد إضافة تعليقات هو عبر الكود نفسه في بداية كل قسم رئيسي من الكود. قم بتضمين تعليق قصير حول المهمة التي سيؤديها هذا القسم المحدد.
هناك ثلاث طرق لإضافة التعليقات إلى رمز البرنامج الخاص بك.

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

# التعليقات تذهب هنا
هذا هو التعليق على غرار قذيفة. أي شيء على نفس الخط ويأتي بعد علامة # سيتم تجاهله من قبل الخادم ولن تتم معالجته كرمز البرنامج.

/*
التعليقات تذهب هنا
التعليقات تذهب هنا
التعليقات تذهب هنا
*/
هذا هو التعليق على غرار C. أي شيء يقع بين الفتح / * والإغلاق * / سيتم تجاهله من قبل الخادم ولن تتم معالجته كرمز للبرنامج. يمكنك استخدام هذا النمط عندما يكون لديك أكثر من سطر واحد من التعليقات مثل التي ناقشناها في هذا البرنامج التعليمي. انقر هنا للحصول على مثال.




برنامج للتعديل على ملفات iptv وحل مشكلة توقف القنوات المشفرة (يونيو 2021)



المادة العلامات: كيفية إضافة تعليقات إلى برنامج PHP الخاص بك ، PHP ، PHP ، صفحات الويب الديناميكية ، لغات البرمجة النصية ، php ، قواعد البيانات العلائقية ، MySQL ، PHP الإصدار 4 ، برمجة php ، برامج php التعليمية ، مقالات php ، موارد php ، موارد php ، شفرة المصدر ، تطوير الويب ، مشرفي المواقع ، المرجع ، نصائح ، تطبيقات ، أساسيات php ، علامات php ، المتغيرات ، العوامل

ما هو Microboard؟

ما هو Microboard؟

الصحة واللياقة البدنية

التغييرات في السمع

التغييرات في السمع

الصحة واللياقة البدنية

المشاركات الجمال الشعبية

الاطفال والجوائز

الاطفال والجوائز

الجمال و النفس

خياطة ألعاب لينة

خياطة ألعاب لينة

الهوايات والحرف

توجيه الضوء التحول

توجيه الضوء التحول

تلفزيون اند أفلام