get_include_path — Funktion · PHP-Referenz

Signatur

get_include_path(): string|false

Beschreibung

get_include_path() liest den aktuell gültigen Wert der include_path-Direktive aus der PHP-Laufzeitumgebung aus. Der include_path enthält eine Liste von Verzeichnissen, in denen PHP nach Dateien sucht, die per include, require, include_once oder require_once eingebunden werden sollen.

Die Funktion ist das Äquivalent zu ini_get('include_path'), bietet jedoch eine prägnantere Schreibweise. Mehrere Verzeichnisse werden durch das betriebssystemspezifische Trennzeichen (PATH_SEPARATOR) voneinander getrennt – unter Linux/macOS ist das ein Doppelpunkt (:), unter Windows ein Semikolon (;).

Typische Anwendungsfälle sind das Auslesen des aktuellen Pfades vor dessen Modifikation mit set_include_path(), um den ursprünglichen Wert später wiederherstellen zu können, sowie das Debugging von Ladeproblemen bei Bibliotheken oder Frameworks.

Rückgabewert

Typ

string|false

Beschreibung

Gibt den aktuellen Wert der include_path-Direktive als Zeichenkette zurück. Im Fehlerfall wird false zurückgegeben.

Beispiele

Aktuellen include_path ausgeben

<?php
$path = get_include_path();
echo $path;
// Beispielausgabe unter Linux: .:/usr/share/php

.:/usr/share/php

include_path erweitern und ursprünglichen Wert wiederherstellen

<?php
// Aktuellen Pfad sichern
$original = get_include_path();

// Eigenes Verzeichnis vorne anhängen
set_include_path('/var/www/meine-libs' . PATH_SEPARATOR . $original);

echo get_include_path();
// Ausgabe: /var/www/meine-libs:.:/usr/share/php

// Dateien einbinden ...
// require 'meine-bibliothek.php';

// Ursprünglichen Pfad wiederherstellen
set_include_path($original);

echo get_include_path();
// Ausgabe: .:/usr/share/php

/var/www/meine-libs:.:/usr/share/php .:/usr/share/php

include_path in einzelne Verzeichnisse aufteilen

<?php
$paths = explode(PATH_SEPARATOR, get_include_path());
foreach ($paths as $dir) {
    echo $dir . PHP_EOL;
}

. /usr/share/php

// Wichtig · Fallstricke

get_include_path() gibt den zur Laufzeit gültigen Wert zurück, der durch set_include_path(), ini_set('include_path', ...) oder eine .htaccess-Datei vom Wert in der php.ini abweichen kann. Moderne PHP-Projekte verwenden häufig Autoloader (z. B. via Composer), sodass eine manuelle Pflege des include_path seltener notwendig ist.

Siehe auch

set_include_path restore_include_path ini_get ini_set PATH_SEPARATOR