Commenti PHP, Include/Include_once, Require/Require_once
Perché usare i commenti?
- Se non lavori sul codice sorgente per un po', è facile dimenticare cosa fa il codice. Commentare il codice sorgente aiuta a ricordare cosa fa il codice.
- Commentare il codice sorgente è molto importante anche quando più sviluppatori devono lavorare sullo stesso progetto. Le modifiche apportate da uno sviluppatore possono essere facilmente comprese da altri sviluppatori semplicemente leggendo i commenti.
- Come best practice, devi avere 3 righe di commenti ogni 10 righe di codice
Commenti PHP
- I commenti ci aiutano a comprendere il codice
- I commenti sono spiegazioni che includiamo nel nostro codice sorgente. Questi commenti sono per la comprensione umana.
- I commenti su una sola riga iniziano con una doppia barra // e terminano sulla stessa riga.
-

- I commenti su più righe iniziano con una barra seguita dall'asterisco /* e terminano con l'asterisco seguito dalla barra */.
-
Il diagramma seguente mostra un file PHP con commenti sia su più righe che su riga singola
Esempio PHP
PHP Include e PHP Include_once
L'istruzione php "include" viene utilizzata per includere altri file in un file PHP.
Ha due varianti, include e include_once. Include_once viene ignorato dall'interprete PHP se il file da includere.
L'istruzione include ha la seguente sintassi
<?php include 'file_name'; ?>
L'istruzione include_once ha la seguente sintassi
<?php include_once 'file_name'; ?>
QUI,
- "Include/include_once" è l'istruzione che include file
- “'file_name'” è il nome del file da includere.
Esempio: Include/Include_once
Supponiamo che tu stia sviluppando un sito Web che contenga lo stesso menu di navigazione in tutte le pagine.
Puoi creare un'intestazione comune e includerla in ogni pagina utilizzando l'istruzione include. Vediamo come è possibile farlo.
- Creeremo 2 nomi di file
- intestazione.php, indice.php
Di seguito sono riportati i codici per; header.php
<a href="index.php">Home</a> <a href="aboutus.php">About us</a> <a href="services.php">Services</a> <a href="contactus.php">Contact Us</a>
index.php
<?php include 'header.php'; ?>
Verrà visualizzata la pagina di intestazione sopra
Richiedi PHP e PHP require_once
L'istruzione require ha due varianti, require e require_once.
L'istruzione require/require_once viene utilizzata per includere file.
Require_once viene ignorato se il file richiesto è già stato aggiunto da una delle quattro istruzioni include.
Ha la seguente sintassi
<?php require 'file_name'; ?>
<?php require_once 'file_name'; ?>
QUI,
- "require/require_once" è l'istruzione che include file
- “'file_name'” è il nome del file da includere.
Esempio: Richiedi
Supponiamo di sviluppare un'applicazione basata su database.
Possiamo creare un file di configurazione che possiamo includere in tutte le pagine che si connettono al database utilizzando l'istruzione require. config.php
<?php $config['host'] = 'localhost'; $config['db'] = 'my_database'; $config['uid'] = 'root'; $config['password'] = ''; ?>
Diamo ora un'occhiata al codice di esempio che richiede il file di configurazione. Pagine_modello.php
<?php require 'config.php'; //require the config file //other code for connecting to the database ?>
PHP include vs richiede
La differenza tra includere/richiedere
| Includere | Richiedere |
|---|---|
| Emette un avviso quando si verifica un errore | Non emette un avviso |
| L'esecuzione dello script continua quando si verifica un errore | L'esecuzione dello script si interrompe quando si verifica un errore. |
In genere, si consiglia di utilizzare l'istruzione include in modo che, quando si verifica un errore, l'esecuzione dello script continui a visualizzare l'indirizzo email del webmaster o la pagina dei contatti.
L'istruzione require deve essere utilizzata se l'intero script non può essere eseguito senza il file richiesto.
Le istruzioni "include" e "require" possono essere utilizzate in qualsiasi riga dei codici sorgente in cui si desidera che appaia il codice.
Sintesi
- Il singolo codice HTML come intestazioni, piè di pagina, barre laterali ecc. può essere condiviso su più pagine. Ciò semplifica l'aggiornamento del sito Web aggiornando semplicemente un singolo file.
- Codice PHP come le impostazioni di configurazione del database, le funzioni personalizzate ecc. possono essere condivise su più pagine garantendo che il sito web/l'applicazione utilizzi le stesse impostazioni.
- I commenti vengono utilizzati per aiutare a comprendere il codice sorgente. Sono per la comprensione umana
- Le istruzioni di commento su una sola riga iniziano con una doppia barra //.
- Le istruzioni di commento su più righe sono racchiuse tra /* istruzioni */.
- Le istruzioni "include, include_once, require e require_once" vengono utilizzate per includere file.
- Include_once/require_once viene ignorato se il file richiesto è già stato incluso utilizzando una delle quattro istruzioni.
- L'istruzione "include" emette un avviso e continua con l'esecuzione se il file richiesto non è stato trovato.
- L'istruzione require genera un errore irreversibile e interrompe l'esecuzione dello script.
- L'istruzione "include" dovrebbe essere utilizzata nella maggior parte dei casi, tranne nelle situazioni in cui senza il file richiesto da includere, l'intero script non può essere eseguito.


