Sisu

• Sammud
• Osa 1: Stiilid
• Osa 2: Kasutamine
• Näpunäiteid

Kommentaar on omamoodi märkus, mille abil saab selgitada koodilõigu eesmärki ja tähendust. PHP-s töötades on teil mitu võimalust kirjutada kommentaare, mis on tulnud vanadest tuntud programmeerimiskeeltest: sisestades üherealisi või mitmerealisi C-kommentaare. Kommentaaride abil saate kooditüki töös hoida või lihtsalt arvestust pidada.

Sammud

Osa 1: Stiilid

1. 1 Üherealised kommentaarid lühikeste postituste jaoks. Kui peate lühikese kommentaari jätma, kasutage üherealist kommentaarikoodi. Kommentaar laieneb ainult rea lõpuni või koodiploki lõpuni. Sellised kommentaarid töötavad ainult PHP -siltide piires ja neid loetakse ainult HTML -is.

   ? php // See on standardne (C ++) viis ühe rea kommentaari loomiseks # Seda Unixi stiili saate kasutada ka ühe rea kommentaari loomiseks?> var13 ->

2. 2 Kasutage pikkade kommentaaride või testkoodi kirjutamiseks mitmerealisi kommentaare. Mitmerealised kommentaarid on väga kasulikud pikkade selgituste kirjutamiseks ja koodi segmendi töötlemise vältimiseks. Lugege jaotist Kasutus, et saada näpunäiteid mitmerealiste kommentaaride kasutamiseks.

   ? php / * Siin kirjeldatakse mitmerealise kommentaari vormindamist. Kogu tekst kuni märgendi lõpuni lisatakse kommentaari. * / / * Mõnele inimesele meeldib lisada iga rea ​​algusesse *. See parandab suurte kommentaaride loetavust, * kuid seda ei nõuta. * /?> var13 ->

Osa 2: Kasutamine

1. 1 Kommentaare kasutades jätke märkmeid koodi tervise kohta. Te ei pea seda tegema iga koodirea puhul, kuna teised programmeerijad saavad hõlpsasti välja kirjutatud koodi. Kommentaarid on kasulikud, kui teie kood täidab mittestandardseid või mitte ilmseid funktsioone.

   // Loo lokitaotluse loomine $ session = curl_init ($ request); // Käsk curl kasutada HTTP POST curl_setopt ($ sessioon, CURLOPT_POST, true);

2. 2 Jäta kommentaarid, et mitte unustada, mida koodiga tegid. Projekti kallal töötades hoiavad kommentaarid unustamast, kus pooleli jäite. Kommenteerige koodi, mis ei tööta korralikult või mida te pole veel lõpetanud.

   // Enne järgmise sammu juurde liikumist kontrollige veel kord selle programmi väljundi kaja "Tere maailm!";

3. 3 Kommenteerige koodi, mida kavatsete jagada. Kui kavatsete teha koostööd teiste programmeerijatega või muudate oma koodi avalikult kättesaadavaks, aitavad kommentaarid teistel mõista, kuidas teie kood töötab ja mida tuleb parandada.

   / * Kas on parem viis selle saavutamiseks? * / Sugu: input type = "radio" name = "gender"? Php if (isset ($ gender) && $ gender == "female") kaja "check" ;?> value = "female"> Naissisendi tüüp = "raadio" name = "sugu"? php if (isset ($ gender) && $ gender == "male") echo "check";?> value = "male "> Mees

4. 4 Konkreetsete koodiplokkide tagasivõtmiseks jätke kommentaare. See on üsna kasulik, kui katsetate oma koodi ja soovite peatada selle osa töötamise. Lehe alguses eiratakse kõike, mis on kommentaarimärgis.

   ? php echo " / * Tere * / Maailm!"; / * Ülaltoodud koodi käivitamisel ei kajastu sõna "Tere" * /?> Var13 ->

5. 5 Olge suurte koodiplokkide kommenteerimisel ettevaatlik. Kommenteerimisfunktsioon lõpeb, kui esimene lõpetamise märk on aktiivne, nii et kui teie juba kommenteeritud koodi sees on mitmerealine kommentaar, kestab see ainult esialgse kommentaari alguseni.

   ? php / * echo "Tere maailm!"; / * See kommentaar rikub kõik * / * /?> Var13 ->
   

   ? php / * echo "Tere maailm!"; // See kommentaar sobib hästi * /?> Var13 ->

6. 6 Kasutage pseudosalvestiste loomiseks kommentaare. Mõne loomingulise koodivormingu abil saate luua koodi sisestuse otse selle sisse. See on avatud lähtekoodiga projektide jaoks üsna kasulik.

   ? php // ============= // HEADER // ============= // ------------ -// Alapealkiri // ------------- / * Sektsiooni nimi * / # Siin saab kirjeid kirjutada # Teise osa saab siia kirjutada / * * Kasutage seda selgitamiseks * miks vajate mõnda rida * või isegi mõnda selgituspunkti * /?> var13 ->

Näpunäiteid

• HTML- ja PHP -kommentaarid erinevad üksteisest, seega kasutage skriptidega (HTML ja PHP kombinatsioon) töötamisel kindlasti õiget süntaksit.
• Näiteks sisaldab järgmine kood HTML -i kommentaari, kuid täidab siiski PHP -koodi. Kui panete HTML -kommentaari PHP -märgendi sisse, põhjustab see tõrke.
  • ! - div id = "example">? php echo ’tere’; ?> var13 -> / div> ->