(PHP 4, PHP 5, PHP 7)
dirname — Gibt den Pfad des übergeordneten Verzeichnisses zurück
$path
[, int $levels = 1
] ) : string
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.
Hinweis:
dirname() arbeitet nur mit der Eingabe Zeichenkette und beachtet nicht das eigentliche Dateisystem oder Pfadbestandteile wie etwa "..".
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.
pathEin Pfad.
Unter Windows wird sowohl der Slash (/) als auch der Backslash (\) als Trennzeichen bei Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur der Slash (/).
levelsDie Anzahl an übergeordneten Ebenen
Dies muss eine Zahl größer 0 sein.
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.
| Version | Beschreibung |
|---|---|
| 7.0.0 |
Der optionale Parameter levels wurde hinzugefügt.
|
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