PHP Manual
Prev |  | Next

# pathinfo

(PHP 4 >= 4.0.3, PHP 5)

pathinfo -- Returns information about a file path

## Description

mixed pathinfo ( string path [, int options] )

pathinfo() returns an associative array containing information about path. The following array elements are returned: dirname, basename and extension if any.

You can specify which elements are returned with optional parameter options. It composes from `PATHINFO_DIRNAME`, `PATHINFO_BASENAME`, `PATHINFO_EXTENSION` and `PATHINFO_FILENAME` (available since PHP 5.2.0). It defaults to return all elements. This function returns string if not all elements are requested.

Example 1. pathinfo() Example

`<?php $path_parts = pathinfo('/www/htdocs/index.html'); 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 ?>`

Would produce:

    /www/htdocs
    index.html
    html
    index

> Note: For information on retrieving the current path info, read the section on predefined reserved variables.

See also dirname(), basename(), parse_url() and realpath().

Prev | Home | Next
parse_ini_file | Up | pclose