Dateisystem
PHP Manual

dirname

(PHP 4, PHP 5, PHP 7)

dirnameGibt den Pfad des übergeordneten Verzeichnisses zurück

Beschreibung

string dirname ( string $path [, int $levels = 1 ] )

Aus einer übergebenen Zeichenkette, die den Pfad zu einer Datei oder einem Verzeichnis enthält, gibt diese Funktion den Pfad des Verzeichnisses zurück, welches levels Ebenen über dem angegebenen liegt.

Parameter-Liste

path

Ein Pfad.

Unter Windows wird sowohl der Slash (/) als auch der Backslash (\) als Trennzeichen bei Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur der Slash (/).

levels

Die Anzahl an übergeordneten Ebenen

Dies muss eine Zahl größer 0 sein.

Rückgabewerte

Gibt den Pfad eines übergeordneten Verzeichnisses zurück. Sind keine Pfadtrenner in path, wird ein Punkt ('.') zurückgegeben, das aktuelle Verzeichnis kennzeichnend. Ansonsten ist die zurückgegebene Zeichenkette der path mit dem abschließenden /component entfernt.

Changelog

Version Beschreibung
7.0.0 Der optionale Parameter levels wurde hinzugefügt.
5.0.0 dirname() ist nun "binary safe".

Beispiele

Beispiel #1 dirname() Beispiel

<?php
echo dirname("/etc/passwd") . PHP_EOL;
echo 
dirname("/etc/") . PHP_EOL;
echo 
dirname(".") . PHP_EOL;
echo 
dirname("C:\\") . PHP_EOL;
echo 
dirname("/usr/local/lib"2);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

/etc
/ (or \ on Windows)
.
C:\
/usr

Anmerkungen

Hinweis:

dirname() arbeitet nur mit der Eingabe Zeichenkette und beachtet nicht das eigentliche Dateisystem oder Pfadbestandteile wie etwa "..".

Hinweis:

dirname() beachtet die Spracheinstellungen (locale); soll sie daher die korrekte Namensbasis in Pfaden mit einem Mehrbytezeichensatz erkennen, muss die passende Spracheinstellung (locale) mit der setlocale() Funktion gesetzt werden.

Siehe auch


Dateisystem
PHP Manual