pathinfo

Returns information about a file path.

pathinfo Function synopsis

pathinfo(string $path, int $flags = PATHINFO_ALL): array|string

Parameters

$path

Typestring

The path to be parsed.

$flags

OptionalTypeintDefault valuePATHINFO_ALL

If present, specifies a specific element to be returned; one of PATHINFO_DIRNAME, PATHINFO_BASENAME, PATHINFO_EXTENSION or PATHINFO_FILENAME.

Return value

Typearray|string

If the $flags parameter is not passed, an associative array containing the following elements is returned: dirname, basename, extension (if any), and filename.

If the [`$path`](#param-path) has more than one extension,
[`PATHINFO_EXTENSION`](/codex/PATHINFO_EXTENSION) returns only the last one and
[`PATHINFO_FILENAME`](/codex/PATHINFO_FILENAME) only strips the last one.
(see first example below).

If the [`$path`](#param-path) does not have an extension, no
`extension` element will be returned
(see second example below).

If the `basename` of the [`$path`](#param-path) starts
with a dot, the following characters are interpreted as
`extension`, and the `filename` is empty
(see third example below).

If $flags is present, returns a string containing the requested element.