pathinfo
(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)
pathinfo — Liefert Informationen über einen Dateipfad
Beschreibung
$path, int $flags = PATHINFO_ALL): array|string
pathinfo() gibt Informationen über einen Dateipfad
(path) zurück: entweder als assoziatives Array
oder als String, abhängig vom Parameter flags.
Hinweis:
Informationen über das Ermitteln der aktuellen Pfadinformation finden Sie unter Vordefinierte Variablen.
Hinweis:
pathinfo() verarbeitet lediglich den Eingabestring und kennt weder das tatsächliche Dateisystem noch Pfadkomponenten wie "
..".
pathinfo() berücksichtigt die Locale-Einstellung. Um einen Pfad, der Multibyte-Zeichen enthält, korrekt parsen zu können, muss die entsprechende Locale mit der Funktion setlocale() gesetzt werden.
Parameter-Liste
-
path -
Der zu analysierende Dateipfad.
-
flags -
Gibt, falls vorhanden, ein bestimmtes Element an, das zurückgegeben werden soll. Mögliche Werte:
PATHINFO_DIRNAME,PATHINFO_BASENAME,PATHINFO_EXTENSIONoderPATHINFO_FILENAME.Falls
flagsnicht angegeben wird, werden alle verfügbaren Elemente zurückgegeben.
Rückgabewerte
Falls der Parameter flags nicht angegeben wird,
wird ein assoziatives Array mit den folgenden Elementen
zurückgegeben: dirname, basename,
extension (falls vorhanden) und
filename.
Hinweis:
Wenn
pathmehr als eine Erweiterung hat, gibtPATHINFO_EXTENSIONnur die letzte zurück, undPATHINFO_FILENAMEentfernt nur die letzte. (Siehe auch das erste Beispiel weiter unten.)
Hinweis:
Falls
pathkeine Erweiterung hat, wird das Elementextensionnicht zurückgegeben (siehe das zweite Beispiel unten).
Hinweis:
Beginnt
basenamevonpathmit einem Punkt, werden die folgenden Zeichen alsextensioninterpretiert, undfilenameist leer (siehe das dritte Beispiel unten).
Falls flags genutzt wird, gibt diese Funktion
einen String mit dem gewünschten Element zurück.
Beispiele
Beispiel #1 pathinfo()-Beispiel
<?php
$path_parts = pathinfo('/www/htdocs/inc/lib.inc.php');
echo $path_parts['dirname'], "\n";
echo $path_parts['basename'], "\n";
echo $path_parts['extension'], "\n";
echo $path_parts['filename'], "\n";
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
/www/htdocs/inc lib.inc.php php lib.inc
Beispiel #2 pathinfo()-Beispiel für den Unterschied zwischen einer leeren und keiner Erweiterung
<?php
$path_parts = pathinfo('/path/emptyextension.');
var_dump($path_parts['extension']);
$path_parts = pathinfo('/path/noextension');
var_dump($path_parts['extension']);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
string(0) "" Notice: Undefined index: extension in test.php on line 6 NULL
Beispiel #3 pathinfo()-Beispiel für eine Punktdatei
<?php
print_r(pathinfo('/some/path/.test'));
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Array
(
[dirname] => /some/path
[basename] => .test
[extension] => test
[filename] =>
)
Siehe auch
- dirname() - Liefert den Pfad des übergeordneten Verzeichnisses
- basename() - Liefert den letzten Namensteil einer Pfadangabe
- parse_url() - Analysiert eine URL und gibt ihre Bestandteile zurück
- realpath() - Löst einen Pfad in einen absoluten und eindeutigen auf
