Include - dies ist eine Funktion in der Programmiersprache PHP, mit der Sie den Inhalt einer anderen Datei in die aktuelle Datei aufnehmen können. Es ist eine der grundlegenden Funktionen von PHP und wird verwendet, um Code effizienter zu organisieren und zu strukturieren. Mit include können Sie ein großes Projekt in einzelne, leicht unterstützte Komponenten aufteilen.
Die Verwendung von include in PHP ist sehr einfach. Verwenden Sie die folgende Syntax, um den Inhalt einer Datei einzuschließen:
Die Include-Funktion versucht, die Datei mit dem angegebenen Namen in dem Verzeichnis zu finden, in dem sich die aktuelle ausführbare Datei befindet. Wenn eine Datei gefunden wird, wird ihr Inhalt in die aktuelle Datei aufgenommen. Im Falle eines Fehlers gibt die Funktion eine Warnung zurück, die Codeausführung wird jedoch fortgesetzt.
Mit Include können Sie auch den Inhalt von Dateien aus Remote-Quellen einschließen, indem Sie die vollständige URL der Datei angeben. Dies kann beispielsweise nützlich sein, um den Inhalt von Dateien aus anderen Domänen aufzunehmen.
Funktionsprinzip von include in PHP
Include kann ein sehr nützliches Werkzeug sein, um den Code zu organisieren. Es ermöglicht Ihnen, den Code in separate Dateien aufzuteilen, was die Unterstützung und Wiederverwendung erleichtert. Sie können beispielsweise eine separate Datei mit Funktionen oder Klassen erstellen und dann die Include-Funktion verwenden, um ihren Inhalt an der gewünschten Stelle in Ihrem Projekt hinzuzufügen.
Die Include-Funktion kann sowohl absolute als auch relative Dateipfade verwenden. Absoluter Pfad ist der vollständige Pfad zu einer Datei auf dem Server, beginnend mit dem Stammverzeichnis. Ein relativer Pfad ist ein Dateipfad relativ zum aktuellen Verzeichnis oder zur aktuellen Datei. Wenn sich die Datei, die Sie einschließen möchten, beispielsweise im selben Verzeichnis wie die aktuelle Datei befindet, können Sie ihren Namen einfach in der Include-Funktion angeben, ohne einen Pfad anzugeben.
Wenn die Datei, die Sie einschließen möchten, nicht existiert oder nicht gelesen werden kann, gibt PHP eine Warnung aus, aber die Ausführung des Skripts wird fortgesetzt. Dies kann beim Debuggen nützlich sein, aber es lohnt sich, darauf zu achten, keine Dateien einzubeziehen, auf die nicht öffentlich zugegriffen werden sollte.
Externe Dateien aktivieren
Um include zu verwenden, müssen Sie den Dateinamen angeben, den Sie einschließen möchten. Sie können den Dateipfad relativ zum aktuellen Skript angeben oder den vollständigen Dateipfad verwenden. Wenn die Datei nicht gefunden wird, wird das Skript weiter ausgeführt und eine Warnung ausgegeben.
Beispiel für die Verwendung von include:
Include kann auch verwendet werden, um externe Dateien mit einer URL einzuschließen. In diesem Fall müssen Sie das entsprechende Protokoll (z. B. http://) vor der Datei-URL angeben.
Durch das Einschließen von Dateien können Sie Funktionsbibliotheken oder Vorlagen erstellen, um Code wiederverwenden zu können. Sie sollten jedoch vorsichtig sein, wenn Sie externe Dateien einschließen, insbesondere wenn es sich um Benutzereingaben handelt, um mögliche Sicherheitsprobleme zu vermeiden.
Mehrfache Einschlüsse
Include in PHP können Sie den Inhalt einer externen Datei in die aktuelle Datei einfügen. Wenn die Include-Datei jedoch Fehler enthält, werden sie auch in der aktuellen Datei angezeigt. Aber was ist, wenn wir mehrere Dateien einschließen möchten?
Es gibt auch eine Funktion in PHP require, die ähnlich wie include funktioniert, aber wenn Fehler auftreten, stoppt sie das Skript, bis diese Fehler behoben sind. Bei verschachtelten Includes kann die Verwendung von require sicherer sein.
Angenommen, wir haben eine Index-Hauptdatei.php sowie einige zusätzliche Header-Dateien.php, content.php und footer.php. Wir können sie wie folgt in die Hauptdatei aufnehmen:
Es ist wichtig zu beachten, dass sich die enthaltenen Dateien im selben Verzeichnis wie die aktuelle Datei befinden oder über einen absoluten Pfad zugänglich sein müssen.
Auf diese Weise können wir die Struktur der Seite in einzelne Komponenten (Cap, Inhalt, Keller) aufteilen und sie nach Bedarf verbinden, wodurch der Code besser organisiert wird und das Wiederholen des gleichen Codes vermieden wird.
Die Include-Funktion hat auch die Möglichkeit, Daten über globale Variablen zwischen Dateien zu übertragen. Aber es lohnt sich, bei der Verwendung globaler Variablen vorsichtig zu sein, da sie zu Konflikten und unlesbarem Code führen können.
Am Ende hilft die Verwendung mehrerer Includes in PHP, den Code modularer und wiederverwendbarer zu machen. Auf diese Weise können Sie Projekte mit einfachem und klarerem Code erstellen.
Optionen zum Ändern des Verhaltens
Stichwort include PHP bietet mehrere Optionen, mit denen Sie sein Verhalten ändern können. Im Folgenden sind einige dieser Optionen aufgeführt:
include_once: Mit dieser Option können Sie die Datei nur einmal einschließen. Wenn die Datei bereits aktiviert wurde, wird die erneute Aktivierung ignoriert.
require: Im Gegensatz zu include wird diese Option einen schwerwiegenden Fehler (E_COMPILE_ERROR) verursachen, falls die Datei nicht eingeschlossen werden kann. Dies ist nützlich, wenn Sie möchten, dass die Dateieinbeziehung für das Programm obligatorisch ist.
require_once: Diese Option funktioniert ähnlich wie require, aber die Datei wird nur einmal eingeschlossen.
Jede dieser Optionen bietet mehr Flexibilität und Kontrolle, wenn Sie das include-Schlüsselwort in PHP verwenden. Es wird empfohlen, die PHP-Dokumentation zu lesen, um alle Möglichkeiten zum Einbeziehen von Dateien zu verstehen.
Datei nach Bedingung einschließen
Sie können vertraute Codeausführungssteuerungsanweisungen wie if, elseif und else verwenden, um eine Datei bedingt einzuschließen.
Im Folgenden finden Sie ein Beispiel für die Verwendung von include mit einer bedingten Anweisung:
if ($условие) elseif ($другое_условие) else
Wenn die variable Bedingung in diesem Beispiel wahr ist, wird Datei1 eingeschlossen.php. Wenn die variable Bedingung nicht wahr ist, aber die andere Bedingung wahr ist, wird Datei2 eingeschlossen.php. Wenn keine der Bedingungen erfüllt ist, wird Datei3 eingeschlossen.php.
Sie können include auch in Schleifen oder Funktionen verwenden, um Dateien abhängig von der ausgeführten Logik dynamisch einzuschließen.
Das Aktivieren einer bedingten Datei ist ein leistungsfähiges Werkzeug, mit dem Sie flexiblen und verwalteten Code erstellen können, um die gewünschten Ergebnisse in verschiedenen Situationen zu erzielen.
Wenn Sie bedingte Dateieinbeziehung verwenden, ist es wichtig, die Sicherheit zu überwachen und die Eingabe zu überprüfen, um zu verhindern, dass ein Angreifer nicht autorisiert auf die Dateien zugreift oder bösartigen Code ausführt.
Gibt einen Wert aus der enthaltenen Datei zurück
Wenn Sie in PHP das include-Konstrukt zum Einschließen einer Datei verwenden, wird der Rückgabewert dieser Datei nicht gespeichert.
Es gibt jedoch eine Möglichkeit, einen Wert aus einer Include-Datei zurückzugeben, indem Sie das return-Konstrukt verwenden. Wenn wir das Ergebnis der Codeausführung aus der Include-Datei abrufen möchten, können wir die Include-Funktion anstelle von echo verwenden. Eine Include-Datei kann mehrere Werte enthalten, von denen jeder mit return zurückgegeben werden kann.
Hier ist ein Beispiel für die Include-Datei "example".php :
Um den Rückgabewert aus der Example-Datei abzurufen.php in der Hauptdatei können wir den folgenden Code verwenden:
Als Ergebnis der Ausführung des angegebenen Codes wird der Wert der Variablen $name aus der Example-Datei angegeben.php wird der Variablen $result in der Hauptdatei zugewiesen und wird mit der Echo-Funktion ausgegeben.
Mit dem return-Konstrukt können Sie daher einen Wert aus der enthaltenen Datei zurückgeben und für die spätere Verarbeitung in der Hauptdatei verwenden.
