pathinfo
Liefert Informationen über einen Dateipfad
Beschreibung
mixed pathinfo
( string $path
[, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME
] )
Parameter-Liste
-
path
-
Der zu analysierende Dateipfad.
-
options
-
Falls angegeben, wird nur dieses eine Element zurückgegeben.
Mögliche Werte:
PATHINFO_DIRNAME,
PATHINFO_BASENAME,
PATHINFO_EXTENSION oder
PATHINFO_FILENAME.
Falls options nicht angegeben wird, werden
alle verfügbaren Elemente zurückgegeben.
Rückgabewerte
Falls der options-Parameter nicht angegeben wird,
wird ein assoziatives Array mit den folgenden Elementen
zurückgegeben: dirname, basename,
extension (falls vorhanden) und
filename.
Hinweis:
Wenn der path mehr als eine Erweiterung hat,
gibt PATHINFO_EXTENSION nur die letzte zurück, und
PATHINFO_FILENAME entfernt nur die letzte.
(Siehe auch das erste Beispiel weiter unten.)
Hinweis:
Falls path keine Erweiterung hat, wird das
extension-Element nicht zurückgegeben
(siehe das zweite Beispiel unten).
Falls options 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"; // seit PHP 5.2.0
?>
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
Anmerkungen
Hinweis:
Informationen über das Wiederauffinden der aktuellen Pfadinformation
finden Sie unter
Vordefinierte Variablen.
Hinweis:
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 setlocale-Funktion gesetzt werden.
Siehe auch
- dirname
- basename
- parse_url
- realpath