PHP include - Datei einbinden in PHP (2024)

Sie befinden sich: Home > Php > include in Php

Wenn Sie eine Website mit PHP erstellen, ist es oft nötig, dass Sie Code aus anderen Dateien einbinden. Das macht Ihre Webseite übersichtlicher und einfacher zu verwalten. Das PHP-Kommandoincludehilft Ihnen dabei. Es erlaubt Ihnen, den Inhalt einer Programmdatei in eine andere einzufügen.

Stellen Sie sich vor, Sie haben eine Webseite, die aus vielen Teilen wie dem Kopf (Header), dem Fuß (Footer) und einem Menü besteht. Sie möchten nicht den gleichen Code auf jeder Seite wiederholen. Hier kommtincludeins Spiel. Sie schreiben den Code für den Kopf, das Menü und den Fuß nur einmal in separaten Dokument und binden diese dann in Ihre Hauptseite ein.

Beispiel:
Nehmen wir an, Sie haben eine Programmdatei namensheader.php, die den oberen Teil Ihrer Webseite enthält, also den Seitenkopf. In Ihrer Hauptdatei, zum Beispielindex.php, können Sieheader.phpganz einfach integriert:

<?php include 'header.php'; ?>

Mit diesem Befehl wird PHP die Datei suchen und ihren Inhalt dort einfügen, wo Sie denincludeBefehl platziert haben. Wenndiese unter anderemIhren Website-Titel und Ihr Logo enthält, erscheinen diese Elemente auf jeder Seite, dieheader.phpeinbindet.

Erweiterte Nutzung:
Was, wenn Sie nicht nur eine, sondern mehrere Programmdateien integrieren möchten? Kein Problem! Sie könnenincludemehrmals verwenden:

<?phpinclude 'header.php';include 'menu.php';include 'footer.php';?>

Hier binden Sie drei Teile ein: Kopf, Menü und Fuß. Jede dieser Programmdateien enthält spezifischen Code, der auf jeder Seite Ihrer Webseite wiederkehrt.

Was istinclude_once?
Manchmal möchten Sie sicherstellen, dass ein Dokument nur einmal eingefügt wird, auch wenn sie versehentlich mehrfach aufgerufen wird. Hierfür gibt esinclude_once. Dieses Kommando funktioniert wieinclude, stellt aber sicher, dass das Skript nur ein einziges Mal eingefügt wird.

Beispiel:

<?phpinclude_once 'header.php';include_once 'menu.php';?>

Wennheader.phpbereits durchinclude_once integriert wurde, ignoriert PHP weitereinclude_onceAufrufe für dieselbe Datei.

Tipps zum Auslagern:
Denken Sie daran, Ihre Dateien logisch zu organisieren. Lagern Sie wiederkehrende Elemente in eigene Dateien aus. Das macht Ihre Webseite leicht zu aktualisieren und zu warten.

Das Einbinden von PHP-Dateien ist also ein starkes Werkzeug, um Ihre Webseiten effizient und leicht verwaltbar zu gestalten. Nutzen Sie es, um Ihre Arbeit zu vereinfachen und Ihre Webseiten schnell zu aktualisieren.

Technische Details und Fehlerbehandlung beim Einbinden von Dateien mit der PHP Funktion include

Beim Inkludieren von Programmdateien in PHP gibt es einige technische Details und häufige Fehlerquellen, die Sie kennen sollten. Dies hilft Ihnen, Ihre Webseite effizienter zu gestalten und Fehler zu vermeiden.

Verwendung vonincludeundrequire:
Es gibt zwei Hauptbefehle zum Einbinden von Skript-Dateien:includeundrequire. Der Unterschied liegt in der Behandlung von Fehlern.includeerzeugt eine Warnung, wenn die Datei nicht gefunden wird, aber das Skript läuft weiter.requirehingegen stoppt das Skript mit einem fatalen Fehler, wenn die Datei fehlt. Dies ist nützlich, wenn das Fehlen der Datei die gesamte Webseite unbrauchbar macht.

Beispiel fürrequire:
Angenommen, Ihre Webseite benötigt eine Dateiconfig.php, die wichtige Einstellungen enthält. Wenn diese Datei fehlt, sollte die Webseite nicht weiterlaufen. Hier verwenden Sie:

<?php require 'config.php'; ?>

Wennconfig.phpnicht vorhanden ist, stoppt PHP die Ausführung und zeigt einen Fehler an. Dies verhindert, dass die Webseite mit unvollständigen Einstellungen läuft.

Pfade richtig setzen:
Ein häufiges Problem beim Einbinden von Programmdateien ist der Datei-Pfad. Wenn Sie relative Datei-Pfade verwenden, bezieht sich PHP auf das aktuelle Verzeichnis des Skripts, das ausgeführt wird. Dies kann zu Fehlern führen, wenn das Skript von einem anderen Ort aus aufgerufen wird. Um das zu vermeiden, verwenden Sie absoluten Datei-Pfade oder setzen Sie deninclude_pathin der Dateiphp.inioder mittels der Funktionset_include_path().

Beispiel für Pfade setzen:
Stellen Sie sich vor, Sie haben eine Dateistruktur, woheader.phpim Ordnerincludesliegt. Sie können den Datei-Pfad absolut setzen, indem Sie voran den vollständigen Pfad angeben:

<?php include $_SERVER['DOCUMENT_ROOT'] . '/includes/header.php'; ?>

Hier nutzt das Skript die Server Variable $_SERVER. In dieser ist ein Array gespeichert. In diesem ist der Key DOCUMENT_ROOT vorhanden zum Wurzelverzeichnis Ihrer Website führt. So findet PHP die Datei, egal von wo das Skript aufgerufen wird.

Umgang mit htaccess:
Sie können auch die.htaccess-Datei nutzen, um deninclude path bei Ihrem Webserver zu setzen. Dies ist besonders nützlich, wenn Sie auf diephp.ini-Datei keinen Zugriff haben. In der.htaccess-Datei könnten Sie folgendes hinzufügen:

php_value include_path ".:/usr/local/lib/php:/mein/eigener/pfad"

Durch diese Zeile fügt PHP den angegebenen Datei-Pfad zu den Orten hinzu, an denen es nach einzubindenden Dateien sucht.

Behandlung von Datei nicht gefunden-Fehlern:
Wenn eine Datei nicht gefunden wird, gibt PHP standardmäßig eine Warnung aus. Sie können diese Warnungen abfangen und eine benutzerfreundlichere Nachricht anzeigen lassen. Dies erreichen Sie durch eine eigene Fehlerbehandlung mitfile_exists():

<?phpif (file_exists('important.php')) { include 'important.php';} else { echo 'Die benötigte Datei ist nicht verfügbar.';}?>

Hier prüft das PHP-Skript, ob die File existiert, bevor sie integriertwird. Das vermeidet Fehlermeldungen und macht Ihre Webseite professioneller.

Diese Techniken helfen Ihnen, häufige Fehler beim Eingefügen von Dateien zu vermeiden und Ihre Webseite sicher und zuverlässig zu gestalten. Nutzen Sie sie, um Probleme proaktiv zu lösen und Ihre Webprojekte erfolgreich umzusetzen.

Wartung und Management von eingebundenen Dateien

Die Wartung und das Management von inkludierten Dateien in PHP sind wesentlich, um Ihre Webseite aktuell und funktional zu halten. Das Verwalten dieser Dateien erfordert ein systematisches Vorgehen, besonders wenn Ihre Webseite wächst und sich entwickelt.

Aktualisieren von eingebundenen Dateien:
Aktualisieren Sie regelmäßig Ihre inkludierten Dateien wie CSS oder HTML-Dokumente. Das stellt sicher, dass Ihre Webseite modern bleibt und neue Webstandards erfüllt. Zum Beispiel, wenn Sie ein neues Design-Element einführen wollen, aktualisieren Sie die CSS-Datei und binden diese dann in Ihre PHP-Seiten ein.

Beispiel für das Aktualisieren einer CSS-Datei:
Nehmen wir an, Sie möchten die Farbe der Überschriften auf Ihrer Webseite ändern. Sie öffnen Ihre CSS-Datei und fügen folgenden Code hinzu:

h1 { color: blue;}

Speichern Sie die Datei und binden den HTML Code in Ihre PHP-Seiten ein:

<link rel="stylesheet" type="text/css" href="styles.css">

Mit dieser Änderung haben alle Überschriften auf den Seiten, die diese CSS-Datei einarbeiten, nun die Farbe Blau.

Verwalten von Pfaden:
Ein korrekter Dokument-Pfad ist entscheidend für das reibungslose Einfügen von Dateien. Verwenden Sie relative oder absolute Pfade, um sicherzustellen, dass PHP die Dateien korrekt findet. Bei vielen Seiten ist es ratsam, einen zentralen Ordner für alle integrierten Dateien zu nutzen.

Beispiel für Pfadverwaltung:
Wenn Sie eine Dateiconfig.phphaben, die wichtige Konfigurationen enthält, stellen Sie sicher, dass der Datei-Pfad richtig gesetzt ist. Wenn die Datei im Ordnerconfigliegt, könnten Sie folgenden PHP-Befehl verwenden:

require_once($_SERVER['DOCUMENT_ROOT'] . '/config/config.php');

Dieser Befehl bindet dieconfig.phpsicher ein, unabhängig davon, von welchem Skript er aufgerufen wird.

Wiederkehrende Elemente einfügen:
Um Ihre Webseite konsistent und leicht zu verwalten zu machen, verwenden Sie wiederkehrende Elemente wie Webseitenkopf, Webseitenfuß oder Menüs. Diese Elemente in separate Dateien auszulagern und sie auf verschiedenen Seiten einzubetten, macht Updates einfach und schnell.

Beispiel für das Einfügen eines Headers:
Erstellen Sie eine Dateiheader.php, die den oberen Teil Ihrer Webseite enthält. Um diesen Seitenkopf in Ihrer Hauptseiteindex.phpzu verwenden, schreiben Sie:

<?php include 'header.php'; ?>

Jedes Mal, wenn Sie den Seitenkopf aktualisieren, wird die Änderung auf allen Seiten sichtbar, wo Sie dieheader.phpeingebaut haben.

Häufige Fehler vermeiden:
Stellen Sie sicher, dass alle Dateien auf Ihrer Webseite vorhanden sind. Fehlende Dateien können zu Fehlern führen, die die Funktionalität Ihrer Seite beeinträchtigen. Prüfen Sie die Pfade und die Verfügbarkeit der Dateien regelmäßig.

Durch diese Praktiken stellen Sie sicher, dass Ihre Webseite effizient verwaltet wird und Sie schnell auf Änderungen reagieren können. Dies spart Zeit und verhindert Probleme, die beim Betrieb Ihrer Website auftreten könnten.