Functie include_once

De functie include_once includeert het opgegeven bestand in het huidige PHP-script, maar alleen als het niet eerder was geïncludeerd. Dit is vooral handig bij het werken met bestanden die functie- of klasse declaraties bevatten, om fouten door herhaalde declaratie te voorkomen. Aan de parameter van de functie wordt het pad naar het te includeren bestand doorgegeven.

Syntaxis

phpinclude_once 'pad/naar/bestand.php';

Voorbeeld

Laten we het bestand config.php slechts één keer includeren:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Deze aanroep wordt genegeerd
?>

Voorbeeld

Poging om een niet-bestaand bestand te includeren:

php<?php
  include_once 'niet_bestaand.php'; // Genereert een waarschuwing, maar stopt de uitvoering van het script niet
  echo 'Script gaat verder...';
?>

Resultaat van de code-uitvoering:

phpWarning: include_once(niet_bestaand.php): failed to open stream: No such file or directory
Script gaat verder...

Voorbeeld

Een variabele gebruiken om het pad op te geven:

php<?php
  $bestandPad = 'lib/functions.php';
  include_once $bestandPad;
?>

Zie ook