Saturs

• Soļi
• Padomi

Komentārs ir anotācijas veids, ko var izmantot, lai noskaidrotu koda daļas mērķi. PHP ir pieejamas vairākas komentāru iespējas, no kurām divas ietekmē vecākas populāras valodas, komentējot tikai vienu rindiņu. Cits ļauj komentēt vairākas rindas vienlaicīgi, tāpat kā valodā C. Komentārus varat izmantot, lai novērstu koda fragmentu izpildi vai pat izveidotu programmas dokumentāciju.

Soļi

1. daļa no 2: Komentāru veidi

1. 

   Izmantojiet vienas rindas komentārus, lai izveidotu īsas piezīmes. Šajā gadījumā komentāru apgabals beigsies rindas beigās vai koda bloka beigās. Šie komentāri darbojas tikai tagus (marķējums) PHP, tāpēc tie tiks lasīti tikai tad, ja tie tiks ievietoti HTML.

2. 

   
   
   Izmantojiet vairākrindu komentārus, lai komentētu lielākus koda fragmentus vai veiktu testus. Šāda veida komentāri ir noderīgi, lai uzrakstītu garu skaidrojumu vai novērstu koda segmenta izpildi. Zemāk esošajā sadaļā “Lietojumprogrammas” ir daži padomi par šāda veida komentāriem.

2. daļa no 2: Pieteikumi

1. 

   Izmantojiet komentārus, lai atstātu padomus par koda darbību. Tas nav jādara visām līnijām, jo ​​labam kodam jābūt viegli saprotamam citiem programmētājiem, taču komentāri ir ļoti noderīgi, lai izskaidrotu dažādas vai grūti saprotamas funkcijas.

2. 

   
   
   Atstājiet komentārus, lai atcerētos, ko esat darījis iepriekš. Nav svarīgi, vai strādājat ar savu projektu, komentāri var palīdzēt atcerēties, kur pēdējo reizi pārtraucāt. Atstājiet komentārus par koda fragmentiem, kas nedarbojas vai vēl nav pabeigti.

3. 

   Komentējiet kodus, kurus vēlaties kopīgot. Ja plānojat strādāt kopā ar citiem vai plānojat veikt atvērtā pirmkoda projektu, komentāri būs ļoti noderīgi, lai palīdzētu citiem saprast, kā kods darbojas un kur veikt uzlabojumus.

4. 

   
   
   Izmantojiet komentārus, lai novērstu noteiktu koda bloku izpildi. Šāda rīcība ir ļoti noderīga testēšanai, kur nepieciešams kods, lai nedarbotos. Kad lapa tiek ielādēta, viss tagu iekšpusē tiks ignorēts.

5. 

   Esiet piesardzīgs, komentējot lielus koda blokus. Komentēšanas funkcija beigsies, tiklīdz tiks atrasts pēdējais tags, tādēļ, ja kodā, kuru plānojat komentēt, jau ir daudzrindu komentārs, jaunais komentārs beigsies tajā pašā vietā, kur pirmais.

6. 

   Izmantojiet komentārus, lai izveidotu vienkāršu dokumentāciju. Varat izmantot radošo formatējumu, lai ļautu dokumentāciju veikt tieši kodā. Šāda rīcība var būt noderīga atvērtā pirmkoda projektos.

Padomi

• HTML un PHP komentāri ir atšķirīgi. Tāpēc, lietojot skriptus (sajaucot HTML ar PHP), esiet piesardzīgs, lai neapmainītos ar komentāriem.
• Piemēram, zemāk esošajā kodā ir HTML komentārs, bet PHP kods joprojām tiks izpildīts. HTML komentāra ievietošana PHP tagos radīs kļūdas.
  • echo ’olá’;->