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)