ftp_size() 함수는 FTP 서버에 저장된 특정 파일의 크기를 바이트 단위로 확인할 때 사용하는 PHP 내장 함수입니다. 원격 서버의 파일 용량을 사전에 검사해야 하는 업로드·다운로드 로직에서 유용하게 활용됩니다.
문법
ftp_size(conn, myfile)
매개변수
conn −
ftp_connect()로 생성한 FTP 연결 리소스입니다.myfile − 크기를 확인할 원격 서버상의 파일 경로(파일명)입니다.
반환값
함수가 성공적으로 실행되면 해당 파일의 크기를 바이트 단위 정수로 반환합니다. 파일을 찾지 못했거나 오류가 발생한 경우에는 -1을 반환합니다.
참고: 일부 FTP 서버는 SIZE 명령을 지원하지 않을 수 있으며, 이 경우 함수가 실패(-1)할 수 있습니다. 또한 일부 서버에서는 ftp_raw() 등으로 전송 모드를 확인한 후 호출하는 것이 안전합니다.예제
다음은 FTP 서버에 연결한 뒤 "new.txt" 파일의 크기를 가져오는 예제입니다.
<?php
$ftp_server = "192.168.0.4";
$ftp_user = "username";
$ftp_pass = "gfhgfj236k";
// FTP 서버에 접속
$conn = ftp_connect($ftp_server) or die("$ftp_server 에 연결할 수 없습니다.");
// 로그인
$login = ftp_login($conn, $ftp_user, $ftp_pass);
$myfile = "new.txt";
// 파일 크기 확인
$size = ftp_size($conn, $myfile);
if ($size != -1) {
echo "파일 크기는 {$size}바이트입니다.";
} else {
echo "파일 크기를 가져올 수 없습니다!";
}
// 연결 종료
ftp_close($conn);
?>
정리
ftp_size()는 FTP 연결 리소스와 파일 경로 두 개의 인자를 받아 파일 크기를 바이트 값으로 돌려주며, 실패 시 -1을 반환한다는 점만 기억하면 됩니다. 반환값이 -1인지 반드시 검사하여 오류 상황을 처리하는 것이 좋은 실습 방법입니다.