dirname

(PHP 4, PHP 5, PHP 7, PHP 8)

dirnameLiefert den Pfad des übergeordneten Verzeichnisses

Beschreibung

dirname(string $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 Eingabezeichenkette und beachtet nicht das eigentliche Dateisystem oder Pfadbestandteile wie etwa "..".

Achtung

Unter Windows geht dirname() von der aktuell eingestellten Codepage aus. Damit diese Funktion also bei Pfaden mit Mehrbytezeichen den korrekten Verzeichnisnamen erkennt, muss die passende Codepage gesetzt sein. Wenn path Zeichen enthält, die für die aktuelle Codepage ungültig sind, ist das Verhalten von dirname() undefiniert.

Auf anderen Systemen nimmt dirname() an, dass path in einer ASCII-kompatiblen Kodierung vorliegen muss. Andernfalls ist das Verhalten der Funktion undefiniert.

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 Verzeichnissen, die aufgestiegen werden soll.

Dies muss eine ganze 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, der das aktuelle Verzeichnis angibt. Ansonsten ist die zurückgegebene Zeichenkette der path, von dem die abschließendene /komponente entfernt wurde.

Achtung

Vorsicht ist geboten, wenn diese Funktion in einer Schleife verwendet wird, die die oberste Verzeichnis-Ebene erreichen kann, da dies zu einer Endlosschleife führen kann.

<?php
dirname
('.');    // Ergibt '.'.
dirname('/');    // Ergibt '/' unter Windows und '/' auf *nix-Systemen.
dirname('\\');   // Ergibt `\` unter Windows und '.' auf *nix-Systemen.
dirname('C:\\'); // Ergibt 'C:\' unter Windows und '.' auf *nix-Systemen.
?>

Changelog

Version Beschreibung
7.0.0 Der optionale Parameter levels wurde hinzugefügt.

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
/ (oder \ unter Windows)
.
C:\
/usr

Siehe auch

  • basename() - Liefert den letzten Namensteil einer Pfadangabe
  • pathinfo() - Liefert Informationen über einen Dateipfad
  • realpath() - Löst einen Pfad in einen absoluten und eindeutigen auf

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Grundlagen von Views in MySQL

Views in einer MySQL-Datenbank bieten die Möglichkeit, eine virtuelle Tabelle basierend auf dem Ergebnis einer SQL-Abfrage zu erstellen. ...

admin

Autor : admin
Kategorie: mySQL-Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Probleme bei mehreren Bildern in Canvas

Sodah73 Der Thread ist vom 11.02.2023! Du bist verdammt spät dran. :(

Geschrieben von scatello am 10.12.2024 20:44:17
Forum: HTML, JavaScript, AJAX, jQuery, CSS, Bootstrap, LESS
Probleme bei mehreren Bildern in Canvas

Der Hauptfehler in deinem Code liegt darin, dass du die Variable img.src überschreibst, während die Schleife durch die Datenbankergebnisse iteri ...

Geschrieben von Sodah73 am 10.12.2024 20:06:02
Forum: HTML, JavaScript, AJAX, jQuery, CSS, Bootstrap, LESS
I need a jQuery timepicker plugin

Hello, you can use: Flatpickr Example: // Array with disabled times and days const disabledTimes = [ { day: "2024-12-25", times: ["1 ...

Geschrieben von Sodah73 am 10.12.2024 20:03:12
Forum: HTML, JavaScript, AJAX, jQuery, CSS, Bootstrap, LESS
Suche nach Best Practices zur Leistungsoptimierung von PHP-Skripten!!

Um die Leistung von PHP-Skripten zu optimieren, konzentrieren Sie sich auf die Reduzierung des Speicherverbrauchs durch die Verwendung effizienter ...

Geschrieben von alicent23 am 09.12.2024 05:19:23
Forum: PHP Developer Forum