HOWTO · PHP

Aktuellen Verzeichnisnamen und Pfad abrufen in PHP

In diesem Tutorial erfahren Sie, wie Sie den aktuellen Verzeichnisnamen und Pfad in PHP abrufen.

Auf dieser Seite

In PHP gibt es mehrere Möglichkeiten, mit einem aktuellen Pfad zu arbeiten. Welche passt, hängt davon ab, was mit „aktuell“ gemeint ist: getcwd() liefert das Arbeitsverzeichnis des Prozesses; __DIR__ bezeichnet das Verzeichnis der aktuellen PHP-Datei. Diese Verzeichnisse können sich unterscheiden, wenn ein Skript aus einem anderen Verzeichnis gestartet oder von einer anderen Datei eingebunden wird. Mit dirname() gelangen Sie vom Pfad zu seinem übergeordneten Verzeichnis, und basename() liefert nur den letzten Bestandteil eines Pfads.

Aktuelles Arbeitsverzeichnis mit getcwd() abrufen

Rufen Sie getcwd() auf, um das Arbeitsverzeichnis des Prozesses als Pfadzeichenfolge abzurufen. Dieses Verzeichnis dient bei vielen relativen Dateisystempfaden als Ausgangspunkt, ist aber nicht unbedingt das Verzeichnis, in dem sich die Skriptdatei befindet. include und require verwenden zusätzliche Suchregeln, darunter include_path und das Verzeichnis der aufrufenden Datei. Daher beschreibt getcwd() allein nicht, wie jeder Include-Pfad aufgelöst wird. Ein Kommandozeilenprozess kann zum Beispiel in /srv/app starten und ein Skript aus /srv/app/bin ausführen. In diesem Fall verweist getcwd() auf /srv/app. Die Pfade dienen nur zur Veranschaulichung: Das Arbeitsverzeichnis hängt davon ab, wie der Prozess gestartet wurde, und kann sich während der Ausführung ändern.

Führen Sie dieses Beispiel aus:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

<?php
$workingDirectory = getcwd();
if ($workingDirectory !== false) {
    echo $workingDirectory;
}
?>

Das Beispiel gibt das Arbeitsverzeichnis des Prozesses aus, sofern PHP es ermitteln kann. Der absolute Pfad hängt davon ab, wie der Prozess gestartet wurde. Prüfen Sie in Anwendungscode das Ergebnis von getcwd(), bevor Sie es verwenden: Die Funktion kann false zurückgeben, wenn PHP das Arbeitsverzeichnis nicht ermitteln kann. Behandeln Sie diesen Rückgabewert, bevor Sie Pfade zusammensetzen oder ihn an Dateifunktionen übergeben.

Verzeichnis des aktuellen Skripts mit DIR abrufen

Die magische Konstante __DIR__ gibt das Verzeichnis der PHP-Datei an, in der sie steht. Anders als getcwd() bleibt ihr Wert an diese Datei gebunden, auch wenn der Prozess aus einem anderen Verzeichnis gestartet wurde. Wenn bootstrap.php die Datei lib/config.php einbindet, verweist __DIR__ innerhalb von config.php auf das Verzeichnis von config.php – nicht auf das Verzeichnis von bootstrap.php und auch nicht unbedingt auf das Arbeitsverzeichnis des Prozesses.

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

<?php
$scriptDirectory = __DIR__;
echo $scriptDirectory;
?>

Das ist nützlich für Dateien, die zusammen mit dem aktuellen Skript ausgeliefert werden. Ein Skript kann beispielsweise ausgehend von $scriptDirectory einen Pfad zu einer benachbarten Ressource bilden. Dadurch ist die Suche unabhängig vom Startverzeichnis. Der angezeigte absolute Pfad variiert je nach Installation; dieses Beispiel hat daher keinen festen Ausgabewert. dirname(__FILE__) ist eine gleichwertige Möglichkeit, das Verzeichnis der aktuellen Datei zu ermitteln; __FILE__ enthält den vollständigen Pfad dieser Datei.

Verzeichnis aus einem Pfad mit dirname() ableiten

Verwenden Sie dirname(), wenn Ihnen bereits ein Pfad vorliegt und Sie dessen übergeordnetes Verzeichnis benötigen. Auf __DIR__ angewendet, führt die Funktion eine Ebene über das Verzeichnis der aktuellen Datei hinaus; auf __FILE__ angewendet, liefert sie das Verzeichnis, in dem sich die Datei befindet. Die Funktion verarbeitet die Pfadzeichenfolge und prüft nicht, ob das resultierende Verzeichnis tatsächlich existiert.

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

<?php
$parentDirectory = dirname(__DIR__);
echo $parentDirectory;
?>

Für eine Datei unter /srv/app/src ergibt dieses Muster /srv/app. Der Beispielpfad dient zur Veranschaulichung; der tatsächliche Wert richtet sich nach dem Speicherort der PHP-Datei. Verwenden Sie den abgeleiteten Pfad als Ausgangspunkt, wenn sich eine Ressource in einem übergeordneten Verzeichnis befindet. Prüfen Sie den Zugriff auf das Dateisystem separat, wenn der Vorgang ein existierendes Verzeichnis voraussetzt.

Verzeichnisnamen mit basename() abrufen

basename() gibt den letzten Bestandteil des übergebenen Pfads zurück. Bei einem Verzeichnispfad wie /var/www/project ist das project; den vollständigen Pfad gibt die Funktion nicht zurück. Bei einem Dateipfad wie /var/www/project/config.php ist das Ergebnis config.php, also ein Dateiname. Je nach Eingabepfad können Sie mit derselben Funktion somit einen Verzeichnisnamen oder einen Dateinamen extrahieren.

Verwenden Sie basename() zur Anzeige oder zum Vergleich, wenn nur der letzte Pfadbestandteil relevant ist. Bewahren Sie für Dateioperationen den vollständigen Pfad auf: Der einzelne Bestandteil kennzeichnet keinen eindeutigen Speicherort und kann in verschiedenen Bereichen des Dateisystems zu unterschiedlichen Verzeichnissen gehören.

Den passenden Pfad für Ihre Aufgabe auswählen

  • Verwenden Sie getcwd(), wenn ein relativer Pfad vom Arbeitsverzeichnis des Prozesses aus aufgelöst werden soll. Prüfen Sie vor der Verwendung, ob die Funktion false zurückgegeben hat.
  • Verwenden Sie __DIR__, wenn sich ein Pfad nach der PHP-Datei selbst richten soll – auch bei Code, der über include oder require geladen wird.
  • Verwenden Sie dirname(), um ausgehend von __DIR__, __FILE__ oder einem anderen Pfad ein übergeordnetes Verzeichnis abzuleiten.
  • Verwenden Sie basename(), wenn Sie nur den letzten Pfadbestandteil benötigen. Zum Auffinden einer Ressource sollten Sie den vollständigen Pfad beibehalten.

Bei Konfigurationsdateien, Vorlagen und anderen Ressourcen, die zusammen mit einer Anwendung gespeichert sind, ist ein mit __DIR__ gebildeter Pfad in der Regel berechenbarer als ein Pfad, der auf dem Arbeitsverzeichnis des Prozesses beruht. Verwenden Sie getcwd(), wenn der Aufrufer das Arbeitsverzeichnis bewusst vorgibt, etwa bei einem Kommandozeilenwerkzeug, das einen ausgewählten Ordner bearbeitet.