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

phprequire 'path/to/file.php';

Beispiel

Einbinden einer Konfigurationsdatei:

php<?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<?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<?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