Funktion require

Die Funktion require bindet die angegebene Datei in das aktuelle Skript ein und führt sie aus. Im Gegensatz zu include verursacht sie einen fatalen Fehler, wenn die Datei nicht vorhanden ist, und stoppt die Ausführung des Skripts. Die Funktion wird häufig verwendet, um wichtige Dateien mit Funktionen, Klassen oder Konfigurationen einzubinden.

Syntax

require 'path/to/file.php';

Beispiel

Einbinden einer Konfigurationsdatei:

<?php
	require 'config.php';
	echo $db_host; // Variable aus config.php
?>

Wenn die Datei config.php existiert, wird ihr Inhalt ausgeführt und die Variablen werden verfügbar.

Beispiel

Versuch, eine nicht vorhandene Datei einzubinden:

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

Wenn die Datei missing_file.php nicht existiert, wird das Skript mit einem Fehler beendet.

Unterschied zwischen require und include

Der Hauptunterschied besteht darin, dass require einen fatalen Fehler verursacht, wenn die Datei fehlt, während include nur eine Warnung ausgibt.

<?php
	include 'optional_file.php'; // Skript setzt die Arbeit fort
	require 'required_file.php'; // Skript stoppt bei einem Fehler
?>

Siehe auch

die Funktion include,
die auch Dateien einbindet, aber das Skript bei einem Fehler nicht anhält
die Funktion require_once,
die garantiert, dass die Datei nur einmal eingebunden wird