parse_ini_string
pclose
Dateisystem
PHP Manual

# pathinfo

(PHP 4 >= 4.0.3, PHP 5)

pathinfo — Liefert Informationen über einen Dateipfad

### Beschreibung

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

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

### 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:

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

### Changelog

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

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

parse_ini_string
pclose
Dateisystem
PHP Manual