Beide include und require importieren (und führen aus) den Inhalt einer anderen PHP-Datei in die aktuelle ein. Der einzige Unterschied liegt in der Fehlerbehandlung: require verursacht einen fatalen Fehler, wenn die Datei fehlt, während include nur eine Warnung ausgibt und weitermacht.
<?php
include "config.php"; // if missing → WARNING, script CONTINUES
require "database.php"; // if missing → FATAL ERROR, script STOPS
include → file missing → emits a Warning, execution continues (file's code skipped)
require → file missing → throws a Fatal Error, execution HALTS
Verwenden Sie require für Dateien, die die Anwendung nicht ohne ausführen kann (Core-Klassen, kritische Konfiguration, Datenbankaufbau) — Sie möchten, dass sie hart stoppt, wenn diese fehlen. Verwenden Sie include für optionale Dateien (z. B. eine Seitenleisten-Vorlage), bei denen eine fehlende Datei die Seite nicht zum Absturz bringen sollte.
_once-Varianten (verhindern Doppeleinschluss)require_once "functions.php"; // include the file ONLY if not already included
include_once "helper.php";
require_once/include_once importieren die Datei nur, wenn sie noch nicht eingebunden wurde — wesentlich, um "cannot redeclare function/class"-Fehler zu vermeiden, wenn eine Datei mehrmals eingebunden werden könnte (z. B. eine Klassendefinition, die von mehreren Dateien eingebunden wird).
// included files share the SAME scope and can define functions, classes, variables
// config.php:
$dbHost = "localhost";
// main.php:
require "config.php";
echo $dbHost; // "localhost" — the variable is available
// ❌ old style — manually requiring every class file
require_once "User.php";
require_once "Order.php";
// ✅ modern — Composer AUTOLOADING loads classes on demand automatically
require "vendor/autoload.php"; // one line; classes load when used (PSR-4)
$user = new User(); // User.php loaded automatically
In modernem PHP verwenden Sie selten manuelles require für Klassen — der Autoloader von Composer lädt diese bedarfsgerecht. Sie verwenden immer noch require "vendor/autoload.php" einmal zum Bootstrapping.
Das Verständnis von include vs require ist grundlegendes, aber wichtiges PHP-Wissen — so teilen PHP-Dateien Code miteinander, und die Unterscheidung ist für Korrektheit entscheidend.
Der Schlüsselpunkt ist das Fehlerverhalten: require für essenzielle Dateien (damit die App schnell und deutlich fehlschlägt, wenn eine kritische Datei fehlt) und include für optionale (damit eine fehlende unkritische Datei die Seite nicht zum Absturz bringt).
Die _once-Varianten zu kennen ist praktisch unverzichtbar, um häufige "cannot redeclare"-Fehler zu vermeiden, die durch versehentliches zweimaliges Einbinden einer Klassen- oder Funktionsdefinition entstehen.
Genauso wichtig ist das Verständnis des modernen Kontexts: Während diese Konstrukte grundlegend sind, verlässt sich modernes PHP auf Composer-Autoloading (Laden von Klassen bedarfsgerecht) anstatt jede Datei manuell zu erfordern, sodass Sie in aktuellem Code meist nur einmal require "vendor/autoload.php" verwenden und den Rest dem Autoloading überlassen.
Das Wissen um die include/require-Mechanik (und wann welcher Fehlermodus angemessen ist) sowie um die modernen Autoloading-Ansätze ist alltägliches Wissen für die Arbeit mit PHP-Codebases, alt und neu.