PHP include()

Attraverso la funzione include, è possibile includere un file all’interno di uno script PHP. Questa funzione è molto utile per la modularità del codice, poiché consente di riutilizzare porzioni di codice comuni in più file senza doverle copiare e incollare manualmente in ogni script.

Quando si utilizza l’istruzione include, il file specificato viene caricato e il suo contenuto viene inserito nel punto in cui viene eseguita l’istruzione. Il risultato è che il codice incluso viene eseguito come se fosse stato scritto direttamente nello script principale.

Non è necessario che il file da includere abbia l’estensione .php. Può essere anche un file con estensione .html, .txt o qualsiasi altra estensione supportata dal server.

Per specificare il file da includere, è possibile utilizzare un percorso assoluto o relativo. Se si specifica un percorso relativo, questo viene interpretato rispetto alla posizione del file di script corrente. Ad esempio, se si desidera includere un file nella stessa cartella, è sufficiente specificare il nome del file. Se il file si trova in una cartella superiore, è possibile utilizzare "../" per risalire di un livello.

È anche possibile includere file remoti specificando la loro URL. Ad esempio, è possibile includere un file da un altro dominio o un file situato su un server diverso. Tuttavia, per poter includere file remoti, è necessario che la direttiva allow_url_fopen sia attivata nella configurazione del server PHP. Questo parametro di configurazione controlla se è consentito aprire file da URL attraverso le funzioni di I/O di PHP.

Ecco alcuni esempi di utilizzo della funzione include:

// includo un file presente nella stessa cartella
include "esempio.php";

// includo un file presente nella cartella superiore
include "../esempio.php";

// includo un file con percorso assoluto
include "/percorso/del/file/esempio.php";

// includo una URL
include "http://www.sito.com/esempio.php";

È importante notare che quando si includono file tramite URL, il server remoto deve essere configurato in modo da consentire l’accesso diretto ai file tramite URL. Inoltre, includendo file remoti, si espone il proprio script a potenziali rischi di sicurezza. Assicurarsi di includere solo file da fonti attendibili.

È possibile anche passare dei parametri attraverso la query string quando si include una URL. Ad esempio:

// includo una URL con parametri
include "http://www.sito.com/esempio.php?foo=1&bar=2";

Tuttavia, è importante notare che l’uso di la query string con parametri in un’URL da includere funziona solo quando si include una URL remota. Quando si includono file locali, come mostrato negli esempi precedenti, non è possibile utilizzare la query string per passare parametri.

Considerazioni circa l’uso della funzione include()

L’utilizzo dell’istruzione include è molto comune nello sviluppo PHP e presenta alcune considerazioni importanti da tenere a mente:

1. Gestione degli errori: Se il file da includere non esiste o contiene errori, PHP genera un avviso, ma l’esecuzione dello script continua. Per gestire gli errori in modo più robusto, si può utilizzare l’istruzione require al posto di include. L’istruzione require genera un errore fatale se il file non può essere incluso correttamente, interrompendo l’esecuzione dello script.
2. Utilizzo di path relativi e assoluti: Quando si specifica il percorso di un file da includere, è possibile utilizzare sia un percorso relativo che un percorso assoluto. I percorsi relativi sono utili quando si desidera includere un file presente nella stessa directory o in una directory superiore. I percorsi assoluti, invece, specificano il percorso completo del file nel sistema di file.
3. Sicurezza: L’inclusione di file remota o l’uso di percorsi forniti dagli utenti può essere un potenziale rischio di sicurezza. È importante verificare la provenienza dei file inclusi e sanitizzare i dati provenienti dagli utenti per evitare attacchi come l’inclusione di file arbitrari (LFI) o l’esecuzione di codice indesiderato.
4. Alternative all’istruzione include: PHP fornisce anche altre istruzioni per l’inclusione di file, come include_once e require_once. Queste istruzioni si comportano in modo simile ad include e require, ma garantiscono che un file venga incluso una sola volta, anche se viene richiamato più volte nello script.