Commento PHP nella sezione richiesta. Commenti in HTML, CSS, PHP

Dall'autore: I commenti sono una di quelle funzionalità facili da implementare. Allo stesso tempo, questi elementi di modifica possono apportare molti vantaggi agli sviluppatori che trasferiscono il codice di mano in mano. Oggi imparerai come commentare un blocco in PhpStorm. Considereremo anche le restanti funzionalità dell'ambiente di sviluppo per commentare il contenuto del programma.

Commenti: buono e cattivo

La possibilità di commentare il codice è disponibile nella maggior parte dei linguaggi di programmazione (forse tutti, ma con diversi gradi di accessibilità). In genere, il chiarimento verbale viene utilizzato per aiutare gli altri membri del team a svilupparsi ulteriormente, o semplicemente per ricordare a se stessi che un'area necessita di correzioni ("FIX ME").

Naturalmente, una spiegazione di ciò che è scritto è una benedizione. Ma con l'aiuto dei commenti puoi cancellare tutti gli aspetti positivi del codice. Per evitare che ciò accada è necessario distinguere tra le tipologie di commenti:

documentare. Una buona associazione sarebbe il concetto di documentazione per vari Software. Tali commenti aiutano nell'uso del codice, come le istruzioni. Tale commento non è percepito come superfluo, perché senza di esso non è possibile. Immagina che qualcuno utilizzi un framework proprietario e non ti dica come utilizzare il programma;

JavaScript. Inizio veloce

esplicativo. Un buon codice di solito non ne ha bisogno. Più righe di commenti vedi in un programma, più è probabile che il programma sia scritto male. Naturalmente questa non è una regola assoluta.

Commenti esplicativi possono essere utili per coloro che correggeranno il codice in futuro. Molti giovani professionisti, ad esempio, vedono ovunque margini di miglioramento. Credono che prima di loro tutto fosse peggio, e ora è il momento di sistemare ogni singola caratteristica.

A volte una sensazione simile travolge anche i professionisti. Ad esempio, quando tutto sembra sorprendentemente storto, deve esserci una soluzione migliore. Per proteggere i follower dalla ricerca di qualcosa di meglio, il programmatore può lasciare una nota come questa: #time_spent_here=24h

Dopo tali parole, poche persone vorranno dedicare così tanto tempo. Quindi, ne avverti molti diverse opzioni Già risolto. Allo stesso tempo, dovresti evitare attacchi del genere: #i_hate_this, #try_to_do_better_ass%%le. In questo modo stai solo mostrando un atteggiamento poco professionale. Non dovresti compromettere te stesso e il tuo datore di lavoro.

Ma documentare il commento del codice può anche diventare una zavorra per il programmatore. Di norma, si tratta di aree enormi che distraggono direttamente dalla programmazione. Ma per visualizzare il codice senza commenti, gli IDE principali hanno una funzione corrispondente. PhpStorm non dovrebbe fare eccezione, ma ahimè. Cerca la funzionalità nei documenti di aggiornamento.

Tag come elemento funzionale

Sebbene i commenti abbiano lo scopo di fornire chiarimenti e aiuto nello sviluppo del team, queste funzionalità non vengono utilizzate così spesso. Di norma, i tag vengono posizionati dove vogliono interrompere l'esecuzione del codice. Immaginiamo che tu abbia PHP incorporato in HTML. E non vuoi cancellarlo, ma vuoi solo vedere come appare la pagina senza di essa. Per fare ciò è necessario seguire la seguente sintassi:

JavaScript

…

…< div > . . . < / div > < ? -- закомментированныйкоднаphp -- > < div > . . . < / div >

Come puoi vedere, con semplici azioni puoi interrompere l'esecuzione del codice senza nemmeno eseguire operazioni complesse. Ma, in realtà, questo non è il massimo dell'ottimizzazione. Ulteriore comodità per lo sviluppatore è fornita dallo stesso IDE phpStorm. Utilizzando l'evidenziazione e le scorciatoie da tastiera, puoi commentare il segmento di codice selezionato senza assegnare tag specializzati. Questo può essere fatto in questo modo.

Utilizzando un metodo conveniente per te, seleziona una porzione di testo (mouse, scorciatoie).

Premi la combinazione di tasti Ctr + Maiusc + /

Inoltre è possibile commentare la riga corrente. Tutto è uguale, solo senza Shift.

Il vantaggio di questo tipo di commento è la copertura simultanea di più lingue. PHP raramente sta in piedi da solo. In questo modo, non è necessario ricorrere all'etichettatura di ciascuno di essi. L'ambiente supporta molti altri linguaggi web. Basta selezionare un frammento e vendere la combinazione: questo è il codice multilingue e commentato. Allo stesso modo, può essere reso attivo.

Questo è tutto per noi. Se non hai mai utilizzato queste funzionalità prima, ti invitiamo a iniziare. Le scorciatoie rendono il lavoro più veloce e migliore.

JavaScript. Inizio veloce

Impara le nozioni di base di JavaScript con un esempio pratico su come creare un'applicazione web

... oggi in questo breve ma utile articolo scopriremo come vengono commentati i vari codici di programma. Non dirò molto, perché se sei interessato a questo, allora hai già riscontrato i problemi di questo problema e ne hai un'idea.

Sei nel posto giusto... ma qualche parola per chiarezza e beneficio della questione. Probabilmente hai visto come si fa con il codice CSS, poiché i CSS sono di grande interesse per molti principianti, come me.

… Bene!

Ma tieni presente che vengono utilizzati anche i commenti html e php... Ma la maggior parte dei principianti si confonde nella fase iniziale del proprio lavoro con il sito e non sa come aggiungere a se stessa le spiegazioni necessarie. Dopotutto, succede che, ad esempio, sia necessario disattivarlo per un po ' codice html, e poi riprendere di nuovo la sua funzione: questo è facile da implementare se hai preso appunti nei “margini”, ma non si sa mai.

Ma quello che dovresti ricordare sui "commenti" in generale è che tutto dipende strettamente dal file con cui stai lavorando, e quindi il codice dell'applicazione è diverso.

Commentare il codice CSS

a:hover, a:focus ( colore: #D5071E; decorazione del testo: Overline; /*UNDERLINE TOP*/ )

In questo modo ti dai una spiegazione. Oppure puoi anche commentare questo script CSS in questo modo: basta avvolgere

/* CODICE qui */

/*a:hover, a:focus ( color: #D5071E; decorazione del testo: underline; /*UNDERLINE BELOW*/ ​​​​)*/

Attiro la tua attenzione sul fatto che puoi commentare l'intero ciclo di codice CSS in questo modo, ma!! poi dovrai togliere i commenti ripetuti /*SOTTOLINEATO IN FONDO*/, o giocare con le barre se la spiegazione è importante))

Altrimenti ci sarà un errore!!

Nota:

Se apri il codice sorgente della pagina - Ctrl+U e dai un'occhiata... vedrai che la parte di codice css commentata è perfettamente visualizzata nel documento generato! questo è se è stato utilizzato CSS (le proprietà sono state impostate) direttamente in html

E, come capisci, se vai dal codice sorgente tramite un collegamento al documento CSS del tuo modello attivo, tutti i commenti possono essere osservati e studiati)) se qualcuno ne ha bisogno. Ma questo è improbabile)

L'avverbio inglese (parole) sarà leggibile. Simboli russi - no.

Commentare il codice HTML

Il file XML viene commentato allo stesso modo

Importante: controllare sempre il codice proposto negli articoli, almeno visivamente) altrimenti potrebbero esserci degli errori.

Una semplice disattenzione durante la formattazione può costare tempo, ad esempio, il codice commentato mostrato sopra è spesso sbagliato: Invece di due trattini brevi, appare un trattino lungo:

Per vostra informazione:

come accennato nell'osservazione precedente, lo stesso vale per i commenti... il codice html viene visualizzato nel documento generato!

Tienilo a mente.

Ed ecco un'altra cosa:

Oltre al fatto che il codice commentato viene visualizzato nel codice sorgente della pagina (e quindi viene elaborato in un certo senso, anche se sarà invisibile sulla pagina!), è meglio rimuovere alcune funzioni PHP insieme a html dal documento attivo.

Per esempio:

sarà visibile nel documento e nella funzionefarà meravigliosamente il suo lavoro: ovvero le informazioni non saranno più visibili nel frontend, ma nel codice sorgente saranno chiaramente visualizzate! e questa è una query inutile al database: tutto questo è una sciocchezza, ma devi saperlo!

È possibile farlo se non vuoi rimuovere un pezzo di codice dal documento:

aggiungere prima del codice html “extra” necessario il file opening... funzione integrata ... e chiusura?> ...

In breve, questo è quello che puoi fare se il codice è grande:

**/ ?>

allora la fonte sarà pulita!

O più semplice:

Commentiamo la funzione stessa nel documento html. Il codice sorgente in questi casi riguardanti lo sviluppo delle funzioni sarà pulito!

come commentare Javascript

if (beingShown || mostrato) ( // non attivare nuovamente l'animazione return; ) else ( // applica QUALSIASI COMMENTO nella riga // applica QUALSIASI COMMENTO nella riga // true;

Per chiarezza, ho preso questo codice JavaScript di esempio da Internet, correggendo leggermente la punteggiatura. Non importa... L’importante è capire il principio...

Come hai capito, la doppia barra “//” è un SEGNO di commento... RIGA SINGOLA!

Il resto del codice JS è commentato come php, ne parleremo più avanti:

osservazione:

Commentare il codice PHP

...e...qui è simile: barra-barra...una riga.

Ma tieni presente che può essere commentato proprio come il codice CSS.

...oppure puoi commentarlo in questo modo: una versione di una riga, quando usiamo NON DUE slash, ma BECAR (hash) prima della riga commentata:

...Naturalmente, devi commentare attentamente nel loop del codice!

...o in questo modo - simile all'esempio mostrato sopra per i CSS... cioè questa opzione di commento /* codice */ è adatta sia per i codici CSS che per quelli JS!

Ma in questo modo puoi commentare una spiegazione più voluminosa del codice PHP, a metà tra i suoi esempi principali...

Puoi anche commentare nei loop PHP in questo modo, se il codice è misto... php e in qualche modo html

Uguale a quanto descritto sopra:

Ad esempio, alcune di queste funzioni... da qualche parte nel codice generale (o un ciclo in html):— puoi commentarlo, ovvero aggiungere la tua etichetta in questo modo:

o così: opzione su una riga...

Intelligenza:

il codice php non è visibile in nessun codice sorgente!! È visibile solo il suo risultato funzionale: l'allenamento!

Questo è praticamente tutto ciò che volevo segnalare oggi!

Ora puoi sperimentare... Buona fortuna.

E, naturalmente, leggi gli articoli sul sito e iscriviti:
Condivido la mia amara esperienza: un po' di conoscenza, per il tuo dolce benessere))

...città dei webmaster Mihalika.ru© - facilmente con WordPress

I commenti in PHP sono simili ai commenti utilizzati in HTML. Nella sintassi PHP, i commenti iniziano sempre con una sequenza speciale di caratteri e tutto il testo che appare tra questi caratteri speciali verrà ignorato dall'interprete.

In HTML, lo scopo principale di un commento è fungere da nota per gli sviluppatori che potrebbero visualizzare il codice sorgente del tuo sito. I commenti PHP sono diversi in quanto non verranno visualizzati dai visitatori. L'unico modo per visualizzare i commenti PHP è aprire il file per la modifica. Ciò rende i commenti PHP utili solo ai programmatori PHP.

Nel caso in cui avessi dimenticato o non sapessi come vengono creati i commenti in HTML, guarda l'esempio qui sotto.

Sintassi dei commenti PHP: commento a riga singola

Mentre HTML ha un solo tipo di commento, PHP ne ha due tipi. Il primo tipo di cui parleremo è il commento di una riga. Cioè un commento che dice all'interprete di ignorare tutto ciò che accade su questa riga a destra dei commenti. Per usare questo commento, usa i caratteri "//" o "#" e tutto il testo a destra verrà ignorato dall'interprete PHP.

Psst...Non puoi vedere i miei commenti PHP!"; // echo "niente"; // echo "Il mio nome è Humperdinkle!"; # echo "Nemmeno io faccio niente"; ?>

Risultato:

Ciao mondo! Psst...non puoi vedere i miei commenti PHP!

Nota che molti dei nostri comandi echo non sono stati elaborati perché li abbiamo commentati utilizzando caratteri di commento speciali. Questo tipo di commento viene spesso utilizzato per scrivere rapidamente codice complesso e confuso o per rimuovere temporaneamente una riga di codice PHP (per il debug).

Sintassi dei commenti PHP: commento su più righe

Come i commenti HTML, i commenti multilinea in PHP possono essere utilizzati per commentare grandi blocchi di codice o per scrivere commenti su più righe. I commenti su più righe in PHP iniziano con "/*" e terminano con "*/". Tutto ciò che si trova tra questi caratteri verrà ignorato.

Risultato.

In questa lezione parlerò di come realizzare commenti in HTML, CSS, PHP. I commenti sono testo non visibile sulla pagina web. Vengono utilizzati per vari tipi di spiegazioni, promemoria e descrizioni per i webmaster, che consentono di strutturare il documento. I commenti sono indispensabili durante il debug del codice; consentono di navigare rapidamente nel markup di una pagina web e trovare il blocco desiderato. I commenti vengono spesso utilizzati per eseguire il debug del codice HTML. Ad esempio, puoi commentare temporaneamente un blocco specifico di codice in modo che non venga eseguito e, se necessario, puoi ripristinarlo facilmente.

Commenti in HTML

In HTML, i commenti vengono formati utilizzando i seguenti caratteri:. Pertanto, qualsiasi testo compreso tra questi caratteri è un commento. Diamo un'occhiata ad un esempio:

Esempio di commenti in HTML

Commenti nei CSS

I commenti in CSS vengono creati utilizzando i caratteri: /* e */. Per creare un commento è sufficiente inserire il codice della pagina web tra questi caratteri:

/* Inizio di un blocco con stili per Body*/ body ( background: #efeded; font-family: Verdana, Helvetica, sans-serif; font-size: 12px; margine: 0px; imbottitura: 0px; ) /* Fine di un blocco con stili per Body*/

Commenti in PHP

I commenti in PHP possono essere a riga singola o multilinea:

1) I commenti a riga singola in PHP vengono creati utilizzando i caratteri: //. Metti semplicemente questo carattere davanti alla riga e verrà commentato. Questa opzione viene utilizzata nel caso in cui il commento sia composto da una sola riga.

2) Per implementare commenti su più righe vengono utilizzati i seguenti simboli: /* e */. Questa opzione è utile se il commento si estende su più righe.

Così abbiamo imparato a fare