PHP include file
L' istruzione include
(or require
) prende tutto il testo/codice/markup che esiste nel file specificato e lo copia nel file che utilizza l'istruzione include.
L'inclusione di file è molto utile quando si desidera includere lo stesso PHP, HTML o testo su più pagine di un sito web.
PHP include e richiede dichiarazioni
È possibile inserire il contenuto di un file PHP in un altro file PHP (prima che il server lo esegua), con l'istruzione include o require.
Le istruzioni include e require sono identiche, tranne in caso di errore:
require
produrrà un errore irreversibile (E_COMPILE_ERROR) e arresterà lo scriptinclude
produrrà solo un avviso (E_WARNING) e lo script continuerà
Quindi, se si desidera che l'esecuzione continui e mostri agli utenti l'output, anche se manca il file di inclusione, utilizzare l'istruzione include. In caso contrario, in caso di codifica FrameWork, CMS o di una complessa applicazione PHP, utilizzare sempre l'istruzione require per includere un file chiave nel flusso di esecuzione. Ciò contribuirà a evitare di compromettere la sicurezza e l'integrità dell'applicazione, nel caso in cui un file chiave fosse accidentalmente mancante.
L'inclusione di file consente di risparmiare molto lavoro. Ciò significa che puoi creare un file di intestazione, piè di pagina o menu standard per tutte le tue pagine web. Quindi, quando l'intestazione deve essere aggiornata, puoi aggiornare solo il file di inclusione dell'intestazione.
Sintassi
include 'filename';
or
require 'filename';
PHP include esempi
Esempio 1
Supponiamo di avere un file footer standard chiamato "footer.php", che assomiglia a questo:
<?php
echo "<p>Copyright © 1999-" . date("Y") . " W3Schools.com</p>";
?>
Per includere il file del piè di pagina in una pagina, utilizzare l' include
istruzione:
Esempio
<html>
<body>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
<?php include 'footer.php';?>
</body>
</html>
Esempio 2
Supponiamo di avere un file di menu standard chiamato "menu.php":
<?php
echo '<a href="/default.asp">Home</a> -
<a href="/html/default.asp">HTML Tutorial</a> -
<a href="/css/default.asp">CSS Tutorial</a> -
<a href="/js/default.asp">JavaScript Tutorial</a> -
<a href="default.asp">PHP Tutorial</a>';
?>
Tutte le pagine del sito Web devono utilizzare questo file di menu. Ecco come può essere fatto (stiamo usando un elemento <div> in modo che il menu possa essere facilmente stilizzato con CSS in un secondo momento):
Esempio
<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
</body>
</html>
Esempio 3
Supponiamo di avere un file chiamato "vars.php", con alcune variabili definite:
<?php
$color='red';
$car='BMW';
?>
Quindi, se includiamo il file "vars.php", le variabili possono essere utilizzate nel file chiamante:
Esempio
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'vars.php';
echo "I have a $color $car.";
?>
</body>
</html>
PHP include vs. require
L' require
istruzione viene utilizzata anche per includere un file nel codice PHP.
Tuttavia, c'è una grande differenza tra include e require; quando un file è incluso con l' include
istruzione e PHP non riesce a trovarlo, lo script continuerà a essere eseguito:
Esempio
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>
Se eseguiamo lo stesso esempio utilizzando l' require
istruzione, l'istruzione echo non verrà eseguita perché l'esecuzione dello script termina dopo che l'
require
istruzione ha restituito un errore irreversibile:
Esempio
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php require 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>
Utilizzare require
quando il file è richiesto dall'applicazione.
Utilizzare include
quando il file non è richiesto e l'applicazione deve continuare quando il file non viene trovato.