disk_free_space

(PHP 4 >= 4.1.0, PHP 5)

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

Descripción

float disk_free_space ( string $directory )

Dada una cadena que contiene un directorio, esta función devolverá el número de bytes disponibles en el sistema de archivos o partición de disco correspondiente.

Parámetros

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

Note:
Dado un nombre de archivo en vez de un directorio, el comportamiento de la función no está especificado y puede diferir entre sistemas operativos y versiones de PHP.

Valores devueltos

Devuelve el número de bytes disponibles como un float o FALSE en caso de error.

Ejemplos

Example #1 Ejemplo de disk_free_space()


<?php
// $df contiene el número de bytes disponibles en "/"
$df = disk_free_space("/");

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

Notas

Note: Esta función no funcionará en ficheros remotos ya que el fichero debe ser accesible vía el sistema de ficheros del servidor para poder ser examinado.

Ver también

disk_total_space() - Devuelve el tamaño total de un sistema de archivos o partición de disco

disk_total_space

dirname

Last updated: Fri, 20 May 2011

add a note User Contributed Notes disk_free_space

wiede at gmx dot net 11-Apr-2011 12:36


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 />';

?>

sam 17-Dec-2008 09:52


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

rostvertol dot mil at gmail dot com 18-Feb-2008 07:27


A cleaner and more efficient way of making human readable file sizes:



<?php

function decodeSize( $bytes )

{

    $types = array( 'B', 'KB', 'MB', 'GB', 'TB' );

    for( $i = 0; $bytes >= 1024 && $i < ( count( $types ) -1 ); $bytes /= 1024, $i++ );

    return( round( $bytes, 2 ) . " " . $types[$i] );

}

?>

root at mantoru dot de 06-Dec-2007 04:25


Note that disk_free_space() does an open_basedir check.

Nitrogen 11-Jan-2007 01:50


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.

mixar at yandex dot ru 04-Dec-2006 11:33


This the right function is:



function formatSize($size){

    switch (true){

    case ($size > 1099511627776):

        $size /= 1099511627776;

        $suffix = 'TB';

    break;

    case ($size > 1073741824):

        $size /= 1073741824;

        $suffix = 'GB';

    break;

    case ($size > 1048576):

        $size /= 1048576;

        $suffix = 'MB';    

    break;

    case ($size > 1024):

        $size /= 1024;

        $suffix = 'KB';

        break;

    default:

        $suffix = 'B';

    }

    return round($size, 2).$suffix;

}

djneoform at gmail dot com 12-Jul-2006 02:13


List all drives, free space, total space and percentage free.



<?

    for ($i = 67; $i <= 90; $i++)

    {

        $drive = chr($i);

        if (is_dir($drive.':'))

        {

            $freespace             = disk_free_space($drive.':');

            $total_space         = disk_total_space($drive.':');

            $percentage_free     = $freespace ? round($freespace / $total_space, 2) * 100 : 0;

            echo $drive.': '.to_readble_size($freespace).' / '.to_readble_size($total_space).' ['.$percentage_free.'%]<br />';

        }

    }



    function to_readble_size($size)

    {

        switch (true)

        {

            case ($size > 1000000000000):

                $size /= 1000000000000;

                $suffix = 'TB';

                break;

            case ($size > 1000000000):

                $size /= 1000000000;

                $suffix = 'GB';

                break;

            case ($size > 1000000):

                $size /= 1000000;

                $suffix = 'MB';    

                break;

            case ($size > 1000):

                $size /= 1000;

                $suffix = 'KB';

                break;

            default:

                $suffix = 'B';

        }

        return round($size, 2).$suffix;

    }

?>

Ashraf M Kaabi 02-Mar-2005 04:38


and also you can know the used space , in this 


example :


<?


function disk_used_space($drive)


{


    return disk_total_space("$drive:") - disk_free_space("$drive:");


}





echo disk_used_space('C');


?>

add a note