pathinfo
(PHP 4 >= 4.0.3, PHP 5)
pathinfo — Returns information about a file path
Description
pathinfo() returns an associative array containing information about path.
Parameters
- path
-
The path being checked.
- options
-
You can specify which elements are returned with optional parameter options. It composes from PATHINFO_DIRNAME, PATHINFO_BASENAME, PATHINFO_EXTENSION and PATHINFO_FILENAME. It defaults to return all elements.
Return Values
The following associative array elements are returned: dirname, basename, extension (if any), and filename.
If options is used, this function will return a string if not all elements are requested.
Changelog
| Version | Description |
|---|---|
| 5.2.0 | The PATHINFO_FILENAME constant was added. |
Examples
Example #1 pathinfo() Example
<?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"; // since PHP 5.2.0
?>
The above example will output:
/www/htdocs/inc lib.inc.php php lib.inc
Notes
Note:
For information on retrieving the current path info, read the section on predefined reserved variables.
See Also
- dirname() - Returns parent directory's path
- basename() - Returns trailing name component of path
- parse_url() - Parse a URL and return its components
- realpath() - Returns canonicalized absolute pathname