Funzione require

La funzione require include ed esegue il file specificato nello script corrente. A differenza di include, se il file è assente genera un errore fatale e interrompe l'esecuzione dello script. La funzione è spesso utilizzata per includere file importanti con funzioni, classi o impostazioni.

Sintassi

phprequire 'path/to/file.php';

Esempio

Inclusione di un file di configurazione:

php<?php
  require 'config.php';
  echo $db_host; // Variabile da config.php
?>

Se il file config.php esiste, il suo contenuto verrà eseguito e le variabili diventeranno disponibili.

Esempio

Tentativo di includere un file inesistente:

php<?php
  require 'missing_file.php';
  echo 'This line will not execute';
?>

Se il file missing_file.php non esiste, lo script terminerà con un errore.

Differenza tra require e include

La differenza principale è che require genera un errore fatale se il file è assente, mentre include solo un avviso.

php<?php
  include 'optional_file.php'; // Lo script continuerà l'esecuzione
  require 'required_file.php'; // Lo script si fermerà in caso di errore
?>

Vedi anche

  • la funzione include,
    che include anche file, ma non interrompe lo script in caso di errore
  • la funzione require_once,
    che garantisce l'inclusione singola del file