disk_free_space(3) [php man page]

DISK_FREE_SPACE(3)							 1							DISK_FREE_SPACE(3)

disk_free_space - Returns available space on filesystem or disk partition

SYNOPSIS

       float disk_free_space (string  $directory)

DESCRIPTION

	Given  a  string  containing  a directory, this function will return the number of bytes available on the corresponding filesystem or disk
       partition.

PARAMETERS

	      o $directory
		- A directory of the filesystem or disk partition.

	      Note

		      Given a file name instead of a directory, the behaviour of the function is unspecified and may differ between operating sys-
		     tems and PHP versions.

RETURN VALUES

	Returns the number of available bytes as a float or FALSE on failure.

EXAMPLES

       Example #1

	      disk_free_space(3) example

	      <?php
	      // $df contains the number of bytes available on "/"
	      $df = disk_free_space("/");

	      // On Windows:
	      $df_c = disk_free_space("C:");
	      $df_d = disk_free_space("D:");
	      ?>

NOTES

       Note

	      This function will not work on remote files as the file to be examined must be accessible via the server's filesystem.

SEE ALSO

       disk_total_space(3).

PHP Documentation Group 													DISK_FREE_SPACE(3)

DIRNAME(3)								 1								DIRNAME(3)

dirname - Returns parent directory's path

SYNOPSIS

       string dirname (string  $path)

DESCRIPTION

	Given a string containing the path of a file or directory, this function will return the parent directory's path.

PARAMETERS

	      o $path
		-  A path.  On Windows, both slash ( /) and backslash ( ) are used as directory separator character. In other environments, it is
		the forward slash ( /).

RETURN VALUES

	Returns the path of the parent directory. If there are no slashes in $path, a dot (' .') is returned, indicating  the  current	directory.
       Otherwise, the returned string is $path with any trailing /component removed.

CHANGELOG

       +--------+-------------------------------+
       |Version |				|
       |	|				|
       |	|	   Description		|
       |	|				|
       +--------+-------------------------------+
       | 5.0.0	|				|
       |	|				|
       |	| dirname(3) is now binary safe |
       |	|				|
       +--------+-------------------------------+
EXAMPLES

       Example #1

	      dirname(3) example

	      <?php
	      echo "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
	      echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (or  on Windows)
	      echo "3) " . dirname("."); // 3) .
	      ?>

NOTES

       Note

	      dirname(3) operates naively on the input string, and is not aware of the actual filesystem, or path components such as " ..".

       Note

	      dirname(3)  is locale aware, so for it to see the correct directory name with multibyte character paths, the matching locale must be
	      set using the setlocale(3) function.

       Note

	       Since PHP 4.3.0, you will often get a slash or a dot back from dirname(3) in situations where the older	functionality  would  have
	      given you the empty string.

	Check the following change example:

       <?php

       //before PHP 4.3.0
       dirname('c:/'); // returned '.'

       //after PHP 4.3.0
       dirname('c:/x'); // returns 'c:'
       dirname('c:/Temp/x'); // returns 'c:/Temp'
       dirname('/x'); // returns ''

       ?>

SEE ALSO

       basename(3), pathinfo(3), realpath(3).

PHP Documentation Group 														DIRNAME(3)