string dirname ( string $path )

Name	Beschreibung
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 (/).

Gibt den Pfad des ü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 abschliessenden /component entfernt.

Aus einer übergebenen Zeichenkette, die den Pfad zu einer Datei oder einem Verzeichnis enthält, gibt diese Funktion den Pfad des übergeordneten Verzeichnisses zurück.

Mit dirname() kann man sich den Verzeichnisnamen aus einer vollständigen Pfadangabe (path) extrahieren lassen.

Während unter Windows der Backslash (\) und der Slash (/) als Trennzeichen für Pfadangaben benutzt werden, ist unter anderen Betriebssystemen nur der Slash (/) von Bedeutung.

(PHP 4, PHP 5, PHP 7)

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

Seit PHP 4.3.0 werden sie von dirname() oft einen Schrägstrich oder einen Punkt zurückbekommen, wo die frühere Funktionalität eine leere Zeichenkette ergeben hätte.

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.

<?PHP
$path = '/www/users/williseiler';

$str = dirname ( $path );

echo $str;
?>