PHP의 diskfreespace() 함수는 지정된 디렉터리에서 사용 가능한 여유 공간(디스크 용량)을 바이트 단위로 반환하는 함수입니다. 이 함수는 disk_free_space() 함수의 별칭(alias)으로, 두 함수는 완전히 동일하게 동작합니다.
문법
diskfreespace(dir_name)
매개변수
dir_name − 여유 공간을 확인할 디렉터리 경로를 지정합니다.
반환 값
diskfreespace() 함수는 해당 디렉터리가 위치한 파일 시스템의 사용 가능한 여유 공간을 바이트 단위로 반환합니다. 오류가 발생하면 false를 반환합니다.
예제 1
<?php
echo diskfreespace("/home/");
?>출력 결과
832931168256
예제 2
이번에는 반환 값을 변수에 저장한 후, 사람이 읽기 쉬운 형태로 출력해 보겠습니다.
<?php
$free_space = diskfreespace("/home/");
echo "Free Space: $free_space";
?>출력 결과
Free Space: 832931168256
참고 사항
반환되는 값은 바이트 단위의 숫자이므로, 실무에서는 GB나 MB 단위로 변환하여 표시하는 것이 좋습니다. 예를 들어 다음과 같이 변환할 수 있습니다.
<?php
$free_space = diskfreespace("/home/");
echo round($free_space / 1024 / 1024 / 1024, 2) . " GB";
?>또한 이 함수는 PHP 4.0.7부터 제공되었으며, 최신 코드 작성 시에는 본래 이름인 disk_free_space()를 사용하는 것을 권장합니다.