Komentari u html i php. Komentari u HTML, CSS, PHP

25.04.2017

Zdravo svima!
Nastavljamo da učimo osnove PHP-a od nule!
U ovom tutorijalu ću vam reći šta je komentar u PHP-u, a u praksi ćemo pokušati da zapišemo naš komentar u kodu. Ali to nije sve. Takođe želim da vam kažem kako da komentarišete kod i zašto to uopšte trebate da uradite.

U čemu je komentarPHP
KomentirajPHP- ovo je savjet php programera za brzu navigaciju u kodu, kao i za izmjene.

Komentar u PHP-u nije vidljiv korisniku koji je otvorio web stranicu za pregled. Čak i ako korisnik odluči da pogleda izvorni kod stranice, komentar i dalje neće biti vidljiv, jer svi php.

Komentar PHP koda

Postoje 2 vrste komentara za PHP kod:

→ jedan red
→ višelinijski

⇒ Komentar u jednom redu za PHP
Za komentar u jednom redu koristite simbole "//" ili "#"

Nakon ovih znakova, sve što je napisano u jednom redu će se zanemariti i smatrati komentarom.

Pretplatite se na ažuriranje "; # pretplata (ovo je komentar)?>

Pretplatite se na ažuriranje

⇒ Višeredni komentar za PHP
Komentar u više redova za PHP počinje sa "/ *" i završava se sa "* /".
Sve između ovih znakova će biti zanemareno i tretirano kao komentar.
Komentar u više redaka koristi se ako u zapisu postoji više redova.

Na ekranu ćete vidjeti samo sljedeći tekst:

Pozdrav čitateljima bloga - stranice !!!

P.S.: Uvijek komentirajte svoj kod. Ako mislite da ćete se sjetiti svega što ste radili u kodu za 1-2 godine, varate se, šansa je vrlo mala. Čak i ako se sećate, moraćete da provedete dosta vremena proučavajući šta, gde i zašto...
Učinite nešto ugodno za sebe u budućnosti - prokomentirajte kod i tada ćete sebi reći “HVALA !!!”.
Ostavite komentar u kodu, to će trajati 1 minut, ali će vam uštedjeti cijeli dan u budućnosti.

Komentirajte PHP kod

Recimo da ste napisali php kod, ali iz nekog razloga morate ukloniti 2 reda iz koda.
Ne žurim da uklanjam nešto iz koda, pogotovo ako je u pitanju php kod, radije bih to prokomentarisao. Šta ako trebate vratiti kod. Lakše je dekomentirati nego pisati kod na nov način.

Kako komentirati kodPHP
Primjer sa komentarom u jednom redu:

Pretplatite se na ažuriranje ";?>

Primjer sa komentarom u više redaka.

Od autora: komentarisanje je jedna od onih funkcija 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đe ćemo razmotriti ostatak funkcionalnosti razvojnog okruženja za komentarisanje 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 verbalna pojašnjenja koriste da pomognu drugim članovima tima da se dalje razvijaju, ili jednostavno da se podsjetimo da su ovoj oblasti potrebni popravci (“POPRAVI ME”).

Naravno, objašnjenje onoga što je napisano je blagoslov. Ali uz pomoć komentara možete i precrtati sve dobre aspekte koda. Da se to ne bi dogodilo, potrebno je razlikovati vrste komentara:

dokumentovanje. Dobra asocijacija bi bio koncept dokumentacije za različite softvere. Takvi komentari vam pomažu da koristite kod kao instrukciju. Ovakvo komentarisanje se ne doživljava kao suvišno, jer bez njega nema ničega. Zamislite da je neko koristio autorski okvir i da vam ne govori kako da koristite program;

JavaScript. Brzi početak

objašnjavajući. Dobrom kodu obično nisu potrebni. Što više redova komentara vidite u programu, veća je vjerovatnoća da je program loše napisan. Naravno, ovo nije apsolutno pravilo.

Komentari sa objašnjenjima mogu biti korisni za one koji će popraviti kod u budućnosti. Na primjer, mnogi mladi profesionalci svuda vide polje za napredak. Vjeruju da su stvari bile gore prije njih, 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 spasio pratioce da traže najbolje, programer može ostaviti napomenu poput ove: # time_spent_here = 24h

Posle ovakvih reči, malo ko želi da provede toliko vremena. Dakle, upozoravate da su mnoge različite opcije već razvrstane. U isto vrijeme, trebali biste izbjegavati takve napade: #mrzim_ovo, #pokušaj_da_bolje_dupe %% le. Na ovaj način samo pokazujete neprofesionalan odnos. Ne kompromitujte sebe i svog poslodavca.

Ali dokumentarni komentar koda može postati balast za programera. U pravilu, to su masivni dijelovi koji odvlače pažnju direktno od programiranja. Ali da bi se kod prikazao bez komentara, glavni IDE imaju odgovarajuću funkciju. PhpStorm ne bi trebao biti izuzetak, ali nažalost. Potražite funkciju u dokumentima za ažuriranje.

Oznaka kao funkcionalni element

Iako komentarisanje treba da bude objašnjenje i pomoć u razvoju tima, ove karakteristike se obično ne koriste. Po pravilu, oznake se postavljaju tamo gdje žele da zaustave izvršavanje koda. Recimo da imate PHP ugrađen u HTML. I ne želite da je izbrišete, samo želite da vidite 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. Koristeći isticanje i prečice na tastaturi, možete da komentarišete odabrani segment koda bez dodavanja specijalizovanih oznaka. To se može uraditi na sljedeći način.

Koristeći metod koji vam odgovara, odaberite fragment teksta (miš, prečice).

Pritisnite prečicu na tastaturi Ctr + Shift + /

Osim toga, možete komentirati trenutnu liniju. Sve je isto, samo bez Shift-a.

Prednost ove vrste komentara je istovremeno pokrivanje više jezika. PHP je retko 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 način, može se aktivirati.

To je sve za nas. Ako do sada niste koristili ove funkcije, 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

Komentari u PHP-u su slični komentarima koji se koriste u HTML-u. U PHP sintaksi, komentari uvijek počinju posebnim nizom znakova i sav tekst koji se pojavljuje između ovih specijalnih znakova će biti ignorisan od strane tumača.

U HTML-u, glavna svrha komentara je da služi kao napomena programerima koji mogu vidjeti izvorni kod vaše web stranice. PHP komentari se razlikuju po tome što neće biti prikazani posjetiteljima. Jedini način da vidite PHP komentare je da otvorite datoteku za uređivanje. Ovo čini PHP komentare korisnim samo za PHP programere.

U slučaju da ste zaboravili ili niste znali kako se komentari prave u HTML-u, pogledajte primjer ispod.

PHP sintaksa komentara: komentar u jednom redu

Dok html ima samo jednu vrstu komentara, PHP ima dvije. Prvi tip o kojem ćemo razgovarati je komentar u jednom redu. To jest, komentar koji govori tumaču da ignoriše sve što se dešava u ovoj liniji desno od komentara. Da biste koristili ovaj komentar, koristite znakove "//" ili "#" i sav tekst sa desne strane će biti ignorisan od strane PHP interpretatora.

Psst ... Ne možete vidjeti moje PHP komentare! // echo "ništa"; // echo "Moje ime je Humperdinkle!"; # echo "Ni ja ne radim ništa ";?>

rezultat:

Zdravo 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 grešaka).

PHP sintaksa komentara: višelinijski komentar

Kao i HTML komentari, PHP komentari u više redova mogu se koristiti za komentarisanje velikih blokova koda ili za pisanje komentara u više redova. Komentari u više redova u PHP-u počinju sa "/ *" i završavaju sa "* /". Sve između ovih znakova će biti zanemareno.

Rezultat.

... 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 par riječi za jasnoću i korist slučaja. Verovatno ste videli kako se to radi sa CSS kodom, pošto 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 sa sajtom i ne znaju kako da dodaju potrebna objašnjenja za sebe. Na kraju krajeva, to se dešava tako da, na primjer, morate neko vrijeme deaktivirati html kod, a zatim ponovo nastavi svoju funkciju - lako je implementirati ako ste za sebe napravili bilješke na "marginama", ali nikad ne znate šta.

Ali ono što treba zapamtiti o "komentarima" općenito - ovdje sve striktno ovisi o tome s kojim fajlom konkretno radite, pa je stoga kod aplikacije drugačiji.

Komentiranje CSS koda

a: lebdjeti, a: fokus (boja: # D5071E; dekoracija teksta: precrtavanje; / * PODNIVANJE GORE * /)

Ovako se objašnjavate sami sebi. Ili možete čak i komentarisati ovu css skriptu ovako: samo omotajte

/ * ovdje KOD * /

/ * a: lebdjeti, a: fokus (boja: # D5071E; dekoracija teksta: podcrtavanje; / * PODNAVLJANJE * /) * /

Skrećem vam pažnju da - na ovaj način možete komentirati cijeli ciklus css koda, ali !! onda morate ukloniti ponovljene komentare / * PODVLAČI DNO * /, ili se poigrajte kosim crtama, ako je objašnjenje važno))

U suprotnom će doći do greške!!

Bilješka:

Ako otvorite izvorni kod stranice - Ctrl + U i pogledate ... vidjet ćemo da je prokomentirani komad css koda lijepo prikazan u generiranom dokumentu! ovo je ako je css korišten (osobine su postavljene) direktno 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 ovo je malo vjerovatno)

Engleski prilog (riječi) će biti čitljiv. Ruski simbolizam - ne.

Komentiranje HTML koda

XML fajl se komentariše na isti način.

Važno: uvijek provjerite kod naveden u člancima, barem vizualno) inače može doći do grešaka.

Uobičajena nepažnja tokom formatiranja može biti dugotrajna, na primjer, KOMENTIRANI kod prikazan iznad je često pogrešan: umjesto dvije kratke crtice, pojavljuje se em crtica:

Za tvoju informaciju:

kao što je rečeno u prethodnoj napomeni - takav je i komentar ... html kod se prikazuje u generiranom dokumentu!

Imajte ovo na umu.

A evo još nešto:

pored činjenice da se komentarisani 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 sa html-om iz aktivnog dokumenta.

Na primjer:

će biti vidljiv u dokumentu i funkcijiodlično će raditi svoj posao: to jest, informacije se neće vidjeti u frontendu, već u izvoru - biće jasno prikazane! a ovo je bespontov zahtjev bazi podataka: sve je ovo sitnica, ali morate znati!

Ovo je moguće učiniti ako ne želite da izvadite dio koda iz dokumenta:

dodajte prije potrebnog "ekstra" html koda otvaranje... inline funkcija ... i zatvaranje?> ...

Jednom riječju, ovako možete to učiniti ako je kod velik:

**/ ?>

onda će izvor biti čist!

Ili jednostavnije:

Hajde da komentarišemo samu funkciju u html dokumentu. Izvorni kod u ovim slučajevima će biti čist u pogledu razvoja funkcija!

kako komentirati JavaScript

if (beingShown || prikazano) (// nemojte ponovo pokrenuti animaciju return;) else (// na liniji primeni BILO KOJI KOMENTAR // na liniji primeni BILO KOJI KOMENTAR // true;

Radi jasnoće, zgrabio sam ovaj primjer JavaScript koda na mreži, malo ispravivši interpunkciju. Nije važno ... Glavno je razumjeti princip ...

Kao što razumete, kosa crta "//" je dvostruka, ovo je ZNAK komentara ... JEDAN RED!

Ostatak JS koda je komentiran kao php, više o tome u nastavku:

primjedba: