PHP disk_total_space() 함수 – 디스크 전체 용량 확인 방법

PHP의 disk_total_space() 함수는 지정한 디렉터리가 속한 파일 시스템(디스크 파티션)의 전체 용량을 확인할 때 사용하는 내장 함수입니다. 이 함수는 해당 디렉터리를 포함하는 디스크의 총 용량을 바이트(byte) 단위로 반환합니다.

구문

disk_total_space(dir_name)

매개변수

• dir_name − 전체 용량을 확인하고자 하는 디렉터리의 이름(경로)을 지정합니다.

반환값

disk_total_space() 함수는 지정한 디렉터리가 위치한 파일 시스템의 전체 사용 가능 공간을 바이트 단위로 반환하며, 오류가 발생하면 false를 반환합니다.

예제 1

다음 예제는 /home/ 디렉터리가 속한 디스크의 전체 용량을 그대로 출력합니다.

<?php
   echo disk_total_space("/home/");
?>

출력 결과

944459485184

이번에는 반환값을 변수에 저장한 뒤, 문자열과 함께 출력해 보겠습니다.

예제 2

<?php
   $total_space = disk_total_space("/home/");
   echo "Total Available Space: $total_space";
?>

출력 결과

Total Available Space: 944459485184

응용: 바이트를 기가바이트(GB) 단위로 변환하기

반환값이 바이트 단위이기 때문에 숫자가 매우 길게 표시됩니다. 사람이 읽기 쉬운 형태로 변환하려면 다음과 같이 1024씩 세 번 나누어 주면 됩니다.

<?php
   $total_space = disk_total_space("/home/");
   echo round($total_space / 1024 / 1024 / 1024, 2) . " GB";
?>

출력 결과

879.6 GB

이처럼 disk_total_space() 함수를 활용하면 서버의 디스크 용량을 손쉽게 모니터링할 수 있으며, disk_free_space() 함수와 함께 사용하면 사용 중인 용량까지 계산할 수 있습니다.