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

require_once 'path/to/file.php';

Beispiel

Binden wir die Datei config.php ein:

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

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

'My Site'

Beispiel

Versuch des erneuten Einbindens derselben Datei:

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

Ergebnis der Codeausführung:

5

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

die Funktion include,
die ebenfalls Dateien einbindet, aber keine Überprüfung auf erneutes Einbinden vornimmt
die Funktion include_once,
die ähnlich wie require_once funktioniert, aber keinen fatalen Fehler verursacht, wenn die Datei nicht vorhanden ist