disk_free_space

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

disk_free_space — Devuelve el espacio en disco disponible en el sistema de archivos o partición

Descripción

function disk_free_space(string $directory): float |false

Devuelve el espacio en disco disponible en el directorio o partición.

Parámetros

directory: Un directorio del sistema de archivos o una partición de disco.

Nota:
Si se proporciona un fichero en lugar de un directorio, el comportamiento de esta función puede ser aleatorio, dependiendo del sistema operativo y las versiones de PHP.

Valores devueltos

Devuelve el número de bytes disponibles, en forma de float o false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo con disk_free_space()

<?php
// $df contiene el número de bytes libres en "/"
$df = disk_free_space("/");
// En Windows:
$df_c = disk_free_space("C:");
$df_d = disk_free_space("D:");
?>

Notas

Nota: Esta función no funciona con los archivos remotos, ya que el archivo examinado debe ser accesible en el sistema de archivos del servidor.

Véase también

disk_total_space() - Devuelve el tamaño de un directorio o partición

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 5 notes

down

wiede at gmx dot net ¶

15 years ago

Transformation is possible WITHOUT using loops:
<?php 
 $bytes = disk_free_space("."); 
 $si_prefix = array( 'B', 'KB', 'MB', 'GB', 'TB', 'EB', 'ZB', 'YB' );
 $base = 1024;
 $class = min((int)log($bytes , $base) , count($si_prefix) - 1);
 echo $bytes . '<br />';
 echo sprintf('%1.2f' , $bytes / pow($base,$class)) . ' ' . $si_prefix[$class] . '<br />';
?>

down

Anonymous ¶

12 years ago

$si_prefix = array( 'B', 'KB', 'MB', 'GB', 'TB', 'EB', 'ZB', 'YB' );
you are missing the petabyte after terabyte
 'B', 'KB', 'MB', 'GB', 'TB', 'EB', 'ZB', 'YB' 
should look like
 'B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'

down

sam ¶

17 years ago

Nice, but please be aware of the prefixes.
SI specifies a lower case 'k' as 1'000 prefix.
It doesn't make sense to use an upper case 'K' as binary prefix,
while the decimal Mega (M and following) prefixes in SI are uppercase.
Furthermore, there are REAL binary prefixes since a few years.
Do it the (newest and recommended) "IEC" way:
KB's are calculated decimal; power of 10 (1000 bytes each)
KiB's are calculated binary; power of 2 (1024 bytes each).
The same goes for MB, MiB and so on...
Feel free to read:
http://en.wikipedia.org/wiki/Binary_prefix

down

root at mantoru dot de ¶

18 years ago

Note that disk_free_space() does an open_basedir check.

down

Nitrogen ¶

19 years ago

Another easy way to convert bytes to human readable sizes would be this:
<?php
function HumanSize($Bytes)
{
 $Type=array("", "kilo", "mega", "giga", "tera", "peta", "exa", "zetta", "yotta");
 $Index=0;
 while($Bytes>=1024)
 {
 $Bytes/=1024;
 $Index++;
 }
 return("".$Bytes." ".$Type[$Index]."bytes");
}
?>

It simply takes the $Bytes and divides it by 1024 bytes untill it's no longer over or equal to 1024, meanwhile it increases the $Index to allocate which suffix belongs to the return (adding 'bytes' to the end to save some space).
You can easily modify it so it's shorter, but I made it so it's more clearer.
Nitrogen.

+add a note