PHP Commentando Standards

November 26

PHP Commentando Standards


PHP è un linguaggio di scripting sorgente HTML aperto, il cui codice viene eseguito dall'interprete PHP. I commenti sono trattati come uno spazio bianco e ignorato l'interprete PHP quando si compila ed esegue il codice. I programmatori aggiungono righe di commento al codice in modo che altri conoscono la funzione prevista per ogni sezione di codice. I commenti sono anche un metodo standard per la risoluzione dei problemi di codice.

codice software

Posizionamento di un hash o cancelletto all'inizio di una linea fa sì che l'interprete PHP di ignorare qualsiasi testo successivo. Posizionamento di due a destra rivolto a barre - // - dopo una riga di codice crea un commento codice inline. Tutto il testo dopo le due barre di destra-rivestimento su quella linea sono ignorati dall'interprete PHP. L'interprete PHP salterà alla riga successiva alla ricerca di codice eseguibile. Un blocco di commento multi-linea è indicato da / ... /. Il commento multi-linea non richiede identificatori supplementari fino alla sua fine segnata dal seguente: * /. non verrà eseguito alcun codice PHP all'interno del blocco di commento su più righe. Non esiste uno standard della lunghezza o il numero di righe di commento singoli o blocchi di commento multilinea utilizzati nel codice PHP.

Commentando Standards

Le osservazioni devono descrivere la funzione prevista del codice. Commenti dovrebbero fornire una spiegazione alto livello della logica utilizzata. I commenti possono spiegare la manipolazione di variabili o dati provenienti chiamati dal codice. Aggiunta di righe vuote prima di righe di commento separa visivamente dal codice, che rende più facile per i programmatori per trovare e leggere. L'aggiunta di uno spazio prima della prima lettera dopo le doppie barre migliora la leggibilità. Inserimento di un commento riga vuota dopo un blocco di commenti è facoltativa.

Risoluzione dei problemi

Commentando le linee li rimuove dalla logica eseguibile. Commentando le righe di codice individuato come potenziali cause di problemi consente ai programmatori di identificare il codice specifico che genera l'errore. Gli sviluppatori di software dovrebbero commentare una sezione di sospetto e di eseguire nuovamente la transazione. Se l'errore si ripete, i programmatori rimuovere il commento dalle linee testate di e commentare la prossima serie sospettato di codice. Questo processo viene ripetuto fino a quando l'errore non si ripeterà. Il codice commentato viene poi fissato, i segni di commento rimosso, e il codice fisso viene testato.

Drupal Commenti

Drupal utilizza file PHP per modelli di pagina Web. file di codice PHP terminano in .php. Commento modello di Drupal è chiamato comment.tpl.php. Comment.tpl.php fornisce un modello standard per l'elaborazione commenti sulle pagine web. Il commentando modello di PHP contiene il codice per includere link HTML all'interno di commenti e firme digitali. Modifica dei modelli in Drupal è fatto in PHP. Gli sviluppatori Web che utilizzano Drupal possono fare riferimento a modelli di PHP per le azioni standard come la generazione e-mail.