Što znači komentirati redak u php-u. Kako nakratko komentirati HTML, CSS ili PHP, JS kod. PHP sintaksa komentara: komentar u jednom retku
... danas ćemo u ovom kratkom, ali korisnom članku shvatiti kako se komentira različit programski kod. Neću puno govoriti, jer ako vas ovo zanima, onda ste se već susreli s pitanjima ovog problema i imate ideju o tome.
Došli ste na adresu ... ali nekoliko riječi za jasnoću i korist slučaja. Vjerojatno ste vidjeli kako se to radi s CSS kodom, budući da je css od najvećeg interesa za mnoge početnike, poput mene.
… Dobro!
Ali imajte na umu da se komentari također koriste u html i php... Ali većina početnika se zbuni u početnoj fazi svog rada s web mjestom i ne zna kako dodati potrebna objašnjenja za sebe. Uostalom, događa se tako da, na primjer, morate neko vrijeme deaktivirati html koda, a zatim ponovno nastavi svoju funkciju - lako je implementirati ako ste za sebe napravili bilješke na "marginama", ali nikad ne znate što.
Ali ono što treba zapamtiti o "komentarima" općenito - ovdje sve strogo ovisi o tome s kojom datotekom konkretno radite, pa je stoga kod aplikacije drugačiji.
Komentiranje CSS koda
a: lebdjeti, a: fokus (boja: # D5071E; dekoracija teksta: precrtavanje; / * PODČIRNI GORE * /)Ovako se objašnjavate sami sebi. Ili možete čak i komentirati ovu css skriptu ovako: samo omotajte
/ * ovdje KOD * /
/ * a: lebdjeti, a: fokus (boja: # D5071E; dekoracija teksta: podcrtavanje; / * PODCIRANJE * /) * /
Skrećem vam pozornost na činjenicu da - na ovaj način možete komentirati cijeli ciklus css koda, ali !! onda morate ukloniti ponovljene komentare / * PODCIRATI DNO * /, ili se poigrati kosim crtama, ako je objašnjenje važno))
Inače će doći do greške!!
Bilješka:
Ako otvorite izvorni kod stranice - Ctrl + U i pogledate ... vidjet ćemo da je komentirani dio css koda lijepo prikazan u generiranom dokumentu! ovo je ako se koristio css (svojstva su postavljena) izravno u html-u
I, kao što znate, ako idete od izvornog koda referencom na css dokument vašeg aktivnog predloška, svi komentari se mogu promatrati i proučavati)) ako je nekome potrebno. Ali to je malo vjerojatno)
Engleski prilog (riječi) bit će čitljiv. Ruski simbolizam - ne.
Komentiranje HTML koda
XML datoteka se komentira na isti način.
Važno: uvijek provjerite kod naveden u člancima, barem vizualno) inače može doći do pogrešaka.
Uobičajena nepažnja tijekom formatiranja može biti dugotrajna, na primjer, gore prikazani KOMENTIRANI kod često je pogrešan: umjesto dvije kratke crtice pojavljuje se em crtica:
Za tvoju informaciju:
kao što je rečeno u prethodnoj napomeni - tako i komentar ... html kod se prikazuje u generiranom dokumentu!
Imajte ovo na umu.
A evo još nešto:
pored činjenice da se komentirani kod prikazuje u izvornom kodu stranice (što znači da je na neki način obrađen, iako će i na stranici biti nevidljiv!) - bolje je ukloniti neke php funkcije zajedno s html-om iz aktivnog dokumenta.
Na primjer:
bit će vidljivi u dokumentu i funkcijiizvrsno će odraditi svoj posao: to jest, informacije se neće vidjeti u frontendu, već u izvoru - bit će jasno prikazane! a ovo je bespontov zahtjev bazi podataka: sve je to sitnica, ali morate znati!
To je moguće učiniti ako ne želite izvaditi dio koda iz dokumenta:
dodajte prije potrebnog "dodatnog" html koda otvaranje... inline funkcija ... i zatvaranje?> ...
Jednom riječju, ovako možete to učiniti ako je kod velik:
tada će izvor biti čist!
Ili jednostavnije:
Komentirajmo samu funkciju u html dokumentu. Izvorni kod će u tim slučajevima biti čist u odnosu na razvoj funkcija!
kako komentirati JavaScript
if (beingShown || prikazano) (// ne "pokreni ponovno animaciju return;) else (// na retku primijeni BILO KOJI KOMENTAR // na retku primijeni BILO KOJI KOMENTAR // true;Radi jasnoće, zgrabio sam ovaj primjer JavaScript koda na mreži, malo ispravivši interpunkciju. Nije važno ... Glavna stvar je razumjeti princip ...
Kao što razumijete, kosa crta "//" je dvostruka, ovo je ZNAK komentara ... JEDAN RED!
Ostatak JS koda je komentiran kao php, više o tome u nastavku:
napomena:
Komentiranje PHP koda
... i ... ovdje je isto - kosa crta ... jednoredna.Ali imajte na umu da se može označiti kao CSS-kod.
... ili barem tako možete komentirati - opcija u jednom retku, kada ne koristimo DVIJE KOSE crte, već BECAR (hash) ispred komentiranog retka:
... Naravno, morate pažljivo komentirati u kodnoj petlji!
... ili na isti način - slično gore navedenom primjeru za CSS ... t.j. ova / * kod * / opcija komentiranja će raditi i za CSS i JS kodove!
Ali na ovaj način možete komentirati opsežnije objašnjenje PHP koda, negdje između njegovih glavnih primjera...
Također možete komentirati u php petljama ovako, ako je kod pomiješan ... php i nekako html
Slično kao gore:
Na primjer, neka vrsta funkcije ... negdje u općem kodu (ili petlja u html-u):- možete komentirati, odnosno dodati svoju oznaku ovako:
ili ovako: opcija u jednom retku...
Inteligencija:
php kod nije vidljiv ni u jednom izvornom kodu!! vidljiv je samo njegov funkcionalni rezultat - rad!
Općenito, to je sve što sam danas htio izvijestiti!
Sada možete eksperimentirati ... Sretno.
I naravno, pročitajte članke stranice i pretplatite se:
Dijelim svoje gorko iskustvo - malo znanja, za vašu slatku dobrobit))
... grad webmastera Mikhalika.ru© - Jednostavno uz WordPress
U ovoj lekciji govorit ću o tome kako komentari u HTML, CSS, PHP... Komentari su tekst koji nije vidljiv na web stranici. Koriste se za sve vrste objašnjenja, podsjetnika, opisa za webmastere, što vam omogućuje strukturiranje dokumenta. Komentari su nezamjenjivi prilikom otklanjanja pogrešaka koda, omogućuju vam da se brzo krećete po označavanju web stranice i pronađete blok koji vam je potreban. Često se komentari koriste za otklanjanje pogrešaka u HTML kodu. Na primjer, možete privremeno komentirati određeni blok koda kako se ne bi pokrenuo, a ako je potrebno, lako se može vratiti.
HTML komentari
U HTML-u se komentari formiraju pomoću simbola:... Dakle, svaki tekst između ovih simbola je komentar. Razmotrimo primjer:
Primjer HTML komentara
Komentari u CSS-u
CSS komentari se kreiraju pomoću simbola: / * i * /. Da biste stvorili komentar, samo trebate postaviti kôd web stranice između ovih simbola:
/ * Početak bloka sa stilovima za tijelo * / tijelo (pozadina: #efeded; obitelj fontova: Verdana, Helvetica, sans-serif; veličina fonta: 12px; margina: 0px; padding: 0px;) / * Kraj blok sa stilovima za tijelo * /
PHP komentari
PHP komentari mogu biti jednoredni ili višeredni:
1) Komentari u jednom retku u PHP-u se kreiraju pomoću simbola: //. Dovoljno je staviti ovaj simbol ispred retka i on će biti komentiran.Ova opcija se koristi u slučaju kada se komentar sastoji od samo jednog retka.
2) Za implementaciju komentara u više redaka koriste se sljedeći simboli: / * i * /. Ova je opcija korisna ako se komentar proteže u više redaka.
Tako smo naučili raditi
Komentari u PHP-u slični su komentarima koji se koriste u HTML-u. U PHP sintaksi, komentari uvijek počinju posebnim nizom znakova i tumač će ignorirati sav tekst koji se pojavljuje između tih posebnih znakova.
U HTML-u, glavna svrha komentara je poslužiti kao bilješka razvojnim programerima koji mogu vidjeti izvorni kod vaše stranice. PHP komentari se razlikuju po tome što neće biti prikazani posjetiteljima. Jedini način da vidite PHP komentare je otvaranje datoteke za uređivanje. Time su PHP komentari korisni samo za PHP programere.
U slučaju da ste zaboravili ili niste znali kako se izrađuju komentari u HTML-u, pogledajte primjer u nastavku.
PHP sintaksa komentara: komentar u jednom retku
Dok html ima samo jednu vrstu komentara, PHP ima dvije. Prva vrsta o kojoj ćemo raspravljati je komentar u jednom retku. To jest, komentar koji govori tumaču da ignorira sve što se događa u ovom retku desno od komentara. Da biste koristili ovaj komentar, upotrijebite znakove "//" ili "#" i PHP interpreter će zanemariti sav tekst s desne strane.
Psst ... Ne možete vidjeti "moje PHP komentare!"; // echo "ništa"; // echo "Zovem se Humperdinkle!"; # echo "Ni ja ne radim ništa ";?>
Proizlaziti:
Pozdrav svijete! Psst ... Ne možete vidjeti moje PHP komentare!
Imajte na umu da nekoliko naših echo naredbi nije obrađeno jer smo ih komentirali posebnim znakovima za komentare. Ova vrsta komentara se često koristi za brzo pisanje o složenom i zbunjujućem kodu ili za privremeno uklanjanje reda PHP koda (za otklanjanje pogrešaka).
PHP sintaksa komentara: višeredni komentar
Poput HTML komentara, PHP komentari s više redaka mogu se koristiti za komentiranje velikih blokova koda ili za pisanje komentara u više redaka. Komentari u više redaka u PHP-u počinju s "/ *" i završavaju s "* /". Sve između ovih znakova bit će zanemareno.
Proizlaziti.
Od autora: komentiranje je jedna od onih značajki koje je lako implementirati. U isto vrijeme, ovi elementi za uređivanje mogu biti od velike koristi programerima koji predaju svoj kod iz ruke u ruku. Danas ćete naučiti kako komentirati blok u PhpStormu. Također ćemo razmotriti ostatak funkcionalnosti razvojnog okruženja za komentiranje sadržaja programa.
Komentari: dobro i loše
Komentiranje koda dostupno je u većini programskih jezika (moguće u svim, ali s različitim stupnjevima dostupnosti). Obično se usmena pojašnjenja koriste kako bi se pomoglo drugim članovima tima da se dalje razvijaju ili se jednostavno podsjetimo da ovo područje treba popraviti (“FIX ME”).
Naravno, objašnjenje napisanog je blagoslov. No uz pomoć komentara također možete precrtati sve dobre aspekte koda. Kako se to ne bi dogodilo, potrebno je razlikovati vrste komentara:
dokumentiranje. Dobra asocijacija bio bi koncept dokumentacije za razni softver. Takvi komentari pomažu vam da koristite kod kao instrukciju. Takvo komentiranje ne doživljava se kao suvišno, jer bez njega nema ničega. Zamislite da je netko koristio autorski okvir i ne govori vam kako koristiti program;
JavaScript. Brzi početak
objašnjavajući. Dobar kod ih obično ne treba. Što više redaka komentara vidite u programu, veća je vjerojatnost da je program loše napisan. Naravno, ovo nije apsolutno pravilo.
Komentari s objašnjenjima mogu biti korisni za one koji će popraviti kod u budućnosti. Na primjer, mnogi mladi stručnjaci posvuda vide polje za napredak. Vjeruju da je prije njih bilo gore, a sada je vrijeme da se popravi svaka karakteristika.
Ponekad sličan osjećaj obuzme profesionalce. Na primjer, kada sve izgleda iznenađujuće krivo, mora postojati bolje rješenje. Kako bi sljedbenike spasio od traženja najboljeg, programer može ostaviti bilješku poput ove: # time_spent_here = 24h
Nakon takvih riječi malo tko želi provesti toliko vremena. Dakle, upozoravate da su mnoge različite opcije već riješene. Istodobno, trebali biste izbjegavati takve napade: #mrzim_ovo, #pokušaj_učiniti_bolje_guzicu %% le. Na taj način samo pokazujete neprofesionalan stav. Nemojte kompromitirati sebe i svog poslodavca.
Ali dokumentarno komentiranje koda može postati balast za programera. U pravilu su to masivni odjeljci koji izravno odvlače pažnju od programiranja. Ali kako bi se kod prikazao bez komentara, glavni IDE-ovi imaju odgovarajuću funkciju. PhpStorm ne bi trebao biti iznimka, ali nažalost. Potražite značajku u dokumentima za ažuriranje.
Oznaka kao funkcionalni element
Iako je namjera komentiranja biti objašnjenje i pomoć u razvoju tima, ove se značajke obično ne koriste. U pravilu se oznake postavljaju tamo gdje žele zaustaviti izvršavanje koda. Recimo da imate PHP ugrađen u HTML. I ne želite je izbrisati, samo želite vidjeti kako stranica izgleda bez nje. Da biste to učinili, morate slijediti sljedeću sintaksu:
JavaScript
…
…< div > . . . < / div > < ? -- закомментированныйкоднаphp -- > < div > . . . < / div > |
Kao što vidite, jednostavnim radnjama možete zaustaviti izvršavanje koda čak i bez izvođenja bilo kakvih složenih operacija. Ali, zapravo, ovo još nije vrhunac optimizacije. Dodatnu pogodnost za programera pruža sam phpStorm IDE. Korištenjem isticanja i tipkovnih prečaca možete komentirati odabrani segment koda bez pričvršćivanja specijaliziranih oznaka. To se može učiniti na sljedeći način.
Koristeći metodu prikladnu za vas, odaberite fragment teksta (miš, prečaci).
Pritisnite tipkovnički prečac Ctr + Shift + /
Osim toga, možete komentirati trenutni redak. Sve je isto, samo bez Shifta.
Prednost ove vrste komentiranja je istovremeno pokrivanje više jezika. PHP je rijetko sam za sebe. Na ovaj način ne morate pribjegavati označavanju svakog od njih. Okruženje podržava još nekoliko web jezika. Samo odaberite fragment i prodaj kombinaciju - ovo je višejezični kod i komentiran. Na isti se način može aktivirati.
To je sve za nas. Ako još niste koristili ove značajke, savjetujemo vam da počnete. Skraćenice čine rad bržim i boljim.
JavaScript. Brzi početak
Naučite osnove JavaScripta s praktičnim primjerom izrade web aplikacije