Functie require_once

De functie require_once includeert het opgegeven bestand in het huidige script. Als het bestand al eerder was geïncludeerd, zal de functie het niet opnieuw includeren. Dit is vooral nuttig voor het includeren van bestanden met klassen of functies, waar herhaalde inclusie fouten kan veroorzaken.

Syntaxis

phprequire_once 'pad/naar/bestand.php';

Voorbeeld

Laten we het bestand config.php includeren:

php<?php
  require_once 'config.php';
  echo $config['site_name'];
?>

Resultaat van de code-uitvoering (als in config.php de array $config is gedefinieerd):

php'My Site'

Voorbeeld

Poging tot herhaalde inclusie van hetzelfde bestand:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Deze aanroep wordt genegeerd
  echo sum(2, 3);
?>

Resultaat van de code-uitvoering:

php5

Verschil met require

In tegenstelling tot require, controleert de functie require_once of het bestand al was geïncludeerd en voert het geen herhaalde inclusie uit. Dit voorkomt fouten bij meervoudige inclusie van hetzelfde bestand.

Zie ook

  • de functie include,
    die ook bestanden includeert, maar geen controle uitvoert op herhaalde inclusie
  • de functie include_once,
    die vergelijkbaar werkt als require_once, maar geen fatale fout veroorzaakt bij afwezigheid van het bestand