pathinfoReturns information about a file path
&reftitle.description;
arraystringpathinfostringpathintflagsPATHINFO_ALLpathinfo returns information about
path: either an associative array or a string,
depending on flags.
For information on retrieving the current path info, read
the section on
predefined reserved variables.
pathinfo is locale aware, so for it to parse a path
containing multibyte characters correctly, the matching locale must be set using
the setlocale function.
&reftitle.parameters;
path
The path to be parsed.
flags
If present, specifies a specific element to be returned; one of
PATHINFO_DIRNAME,
PATHINFO_BASENAME,
PATHINFO_EXTENSION or
PATHINFO_FILENAME.
If flags is not specified, returns all
available elements.
&reftitle.returnvalues;
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 has more than one extension,
PATHINFO_EXTENSION returns only the last one and
PATHINFO_FILENAME only strips the last one.
(see first example below).
If the path does not have an extension, no
extension element will be returned
(see second example below).
If the basename of the 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.
&reftitle.examples;
<function>pathinfo</function> Example
]]>
&example.outputs;
<function>pathinfo</function> example showing difference between null and no extension
]]>
&example.outputs.similar;
<function>pathinfo</function> example for a dot-file
]]>
&example.outputs.similar;
/some/path
[basename] => .test
[extension] => test
[filename] =>
)
]]>
&reftitle.seealso;
dirnamebasenameparse_urlrealpath