Die Funktion require_once

Die Funktion require_once bindet die angegebene Datei in das aktuelle Skript ein. Wenn die Datei bereits zuvor eingebunden wurde, wird die Funktion sie nicht erneut einbinden. Dies ist besonders nützlich für das Einbinden von Dateien mit Klassen oder Funktionen, bei denen das erneute Einbinden zu Fehlern führen kann.

Syntax

phprequire_once 'path/to/file.php';

Beispiel

Binden wir die Datei config.php ein:

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

Ergebnis der Codeausführung (wenn in config.php das Array $config definiert ist):

php'My Site'

Beispiel

Versuch des erneuten Einbindens derselben Datei:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Dieser Aufruf wird ignoriert
  echo sum(2, 3);
?>

Ergebnis der Codeausführung:

php5

Unterschied zu require

Im Gegensatz zu require prüft die Funktion require_once, ob die Datei bereits eingebunden wurde, und führt kein erneutes Einbinden durch. Dies verhindert Fehler bei mehrmaligem Einbinden derselben Datei.

Siehe auch