Willi's Homepage - Tricks und Tips

Du bist hier: Tips » Scripte » PHP

PHP

pathinfo

Dateisystem-Funktionen

Befehl:

mixed pathinfo ( string $path [, int $options = PATHINFO_DIRNAME | PATHINFO_BASENAME | PATHINFO_EXTENSION | PATHINFO_FILENAME ] )

Parameter-Liste:

Name	Beschreibung
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:
Falls path keine Erweiterung hat, wird das extension-Element nicht zurückgegeben.

Falls options genutzt wird, gibt diese Funktion einen String mit dem gewünschten Element zurück.

Beschreibung:

pathinfo() gibt Informationen über einen Dateipfad (path) zurück: entweder als assoziatives Array oder als String, abhängig vom options-Parameter.

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.

Aktiv in Version:

(PHP 4 >= 4.0.3, PHP 5, PHP 7)

Hinweis:

Hinweis:

Informationen über das Wiederauffinden der aktuellen Pfadinformation finden Sie unter Vordefinierte Variablen.

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

Beschreibung

• basename()

Gibt letzten Namensteil einer Pfadangabe zurück

• parse_url()

Analysiert einen URL und gibt seine Bestandteile zurück

• realpath()

Löst einen Pfad in einen absoluten und eindeutigen auf

Bsp. 1
Bsp. 2

pathinfo() - Beispiel:

Eingabe:

<?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
?>

Ausgabe:

/www/htdocs/inc
lib.inc.php
php
lib.inc

Beschreibung:

Version	Beschreibung
5.2.0	Die `PATHINFO_FILENAME`-Konstante wurde hinzugefügt.

pathinfo() - Beispiel 2: für den Unterschied zwischen einer leeren und keiner Erweiterung

Eingabe:

<?php
$path_parts = pathinfo('/path/emptyextension.');
var_dump($path_parts['extension']);

$path_parts = pathinfo('/path/noextension');
var_dump($path_parts['extension']);
?>

Ausgabe:

string(0) ""

Notice: Undefined index: extension in /test.php on line 6
NULL

Beschreibung:

Version	Beschreibung
5.2.0	Die `PATHINFO_FILENAME`-Konstante wurde hinzugefügt.

parse_ini_string

pclose

Dateisystem-Funktionen