basename

(PHP 4, PHP 5, PHP 7)

basenameGibt letzten Namensteil einer Pfadangabe zurück

Beschreibung

basename ( string $path [, string $suffix ] ) : string

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

Hinweis:

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

Achtung

basename() 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.

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

suffix

Wenn der Namensteil mit suffix endet, wird dieser ebenfalls abgetrennt.

Rückgabewerte

Gibt den abschließenden Namen des übergebenen path zurück.

Beispiele

Beispiel #1 basename() Beispiel

<?php
echo "1) ".basename("/etc/sudoers.d"".d").PHP_EOL;
echo 
"2) ".basename("/etc/sudoers.d").PHP_EOL;
echo 
"3) ".basename("/etc/passwd").PHP_EOL;
echo 
"4) ".basename("/etc/").PHP_EOL;
echo 
"5) ".basename(".").PHP_EOL;
echo 
"6) ".basename("/");
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

1) sudoers
2) sudoers.d
3) passwd
4) etc
5) .
6) 

Siehe auch

  • dirname() - Gibt den Pfad des übergeordneten Verzeichnisses zurück
  • pathinfo() - Liefert Informationen über einen Dateipfad