pathinfo(3) [php man page]

PATHINFO(3)								 1							       PATHINFO(3)

pathinfo - Returns information about a file path

SYNOPSIS

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

DESCRIPTION

       pathinfo(3) returns information about $path: either an associative array or a string, depending on $options.

PARAMETERS

	      o $path
		- The path to be parsed.

	      o $options
		-  If  present,  specifies  a  specific  element to be returned; one of PATHINFO_DIRNAME, PATHINFO_BASENAME, PATHINFO_EXTENSION or
		PATHINFO_FILENAME. If $options is not specified, returns all available elements.

RETURN VALUES

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

       Note

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

       Note

	       If the $path does not have an extension, no extension element will be returned (see second example below).

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

CHANGELOG

       +--------+--------------------------------------------+
       |Version |					     |
       |	|					     |
       |	|		 Description		     |
       |	|					     |
       +--------+--------------------------------------------+
       | 5.2.0	|					     |
       |	|					     |
       |	|  The PATHINFO_FILENAME constant was added. |
       |	|					     |
       +--------+--------------------------------------------+
EXAMPLES

       Example #1

	      pathinfo(3) Example

	      <?php
	      $path_parts = pathinfo('/www/htdocs/inc/lib.inc.php');

	      echo $path_parts['dirname'], "
";
	      echo $path_parts['basename'], "
";
	      echo $path_parts['extension'], "
";
	      echo $path_parts['filename'], "
"; // since PHP 5.2.0
	      ?>

	      The above example will output:

	      /www/htdocs/inc
	      lib.inc.php
	      php
	      lib.inc

       Example #2

	      pathinfo(3) example showing difference between null and no extension

	      <?php
	      $path_parts = pathinfo('/path/emptyextension.');
	      var_dump($path_parts['extension']);

	      $path_parts = pathinfo('/path/noextension');
	      var_dump($path_parts['extension']);
	      ?>

	      The above example will output something similar to:

	      string(0) ""

	      Notice: Undefined index: extension in test.php on line 6
	      NULL

NOTES

       Note

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

       Note

	      pathinfo(3) is locale aware, so for it to parse a path containing multibyte characters correctly, the matching locale  must  be  set
	      using the setlocale(3) function.

SEE ALSO

       dirname(3), basename(3), parse_url(3), realpath(3).

PHP Documentation Group 													       PATHINFO(3)

Check Out this Related Man Page

REALPATH(3)								 1							       REALPATH(3)

realpath - Returns canonicalized absolute pathname

SYNOPSIS

       string realpath (string	$path)

DESCRIPTION

       realpath(3) expands all symbolic links and resolves references to '/./', '/../' and extra '/' characters in the input $path and returns the
       canonicalized absolute pathname.

PARAMETERS

	      o $path
		- The path being checked.

	      Note

		      Whilst a path must be supplied, the value can be blank or NULL In these cases, the  value  is  interpreted  as  the  current
		     directory.

RETURN VALUES

	Returns the canonicalized absolute pathname on success. The resulting path will have no symbolic link, '/./' or '/../' components.

       realpath(3) returns FALSE on failure, e.g. if the file does not exist.

       Note

	       The running script must have executable permissions on all directories in the hierarchy, otherwise realpath(3) will return FALSE.

       Note

	       Because PHP's integer type is signed and many platforms use 32bit integers, some filesystem functions may return unexpected results
	      for files which are larger than 2GB.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.0	|						    |
       |	|						    |
       |	|  Prior to this release, if only  the	last  $path |
       |	| component  did  not  exist, realpath(3) would not |
       |	| fail on *BSD systems. realpath(3)  now  fails  in |
       |	| this case.					    |
       |	|						    |
       | 5.2.1	|						    |
       |	|						    |
       |	|  Prior  to  this  version,  realpath(3)  returned |
       |	| FALSE if $path is an empty string or NULL.	    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      realpath(3) example

	      <?php
	      chdir('/var/www/');
	      echo realpath('./../../etc/passwd');
	      ?>

	      The above example will output:

	      /etc/passwd

       Example #2

	      realpath(3) on Windows

	       On windows realpath(3) will change unix style paths to windows style.

	      <?php
	      echo realpath('/windows/system32');
	      ?>

	      The above example will output:

	      C:WINDOWSSystem32

SEE ALSO

       basename(3), dirname(3), pathinfo(3).

PHP Documentation Group 													       REALPATH(3)

Linux and UNIX Man Pages

pathinfo(3) [php man page]

Check Out this Related Man Page