PHP ftp_nlist() 함수 완벽 가이드 – FTP 서버 파일 목록 조회하기

PHP ftp_nlist() 함수란?

PHP의 ftp_nlist() 함수는 FTP 서버의 지정된 디렉터리에 있는 파일 목록을 배열 형태로 반환하는 함수입니다. 원격 서버의 파일을 확인하거나 관리하는 작업을 자동화할 때 매우 유용하게 사용됩니다.

문법(Syntax)

ftp_nlist(con, dir);

매개변수(Parameters)

• con − ftp_connect()로 생성한 FTP 연결 리소스를 지정합니다.

• dir − 파일 목록을 조회하고자 하는 디렉터리 경로를 지정합니다. 현재 디렉터리를 조회하려면 "."을 사용합니다.

반환값(Return Value)

ftp_nlist() 함수는 성공 시 해당 디렉터리 내 파일 이름들을 담은 배열(array)을 반환하고, 실패 시 FALSE를 반환합니다. 반환값이 FALSE인지 반드시 확인하여 오류 처리를 해주는 것이 좋습니다.

사용 예제

다음 예제는 FTP 서버에 접속한 후 현재 디렉터리의 파일 목록을 가져와 출력하는 코드입니다.

<?php
   $ftp_server = "192.168.0.4";
   $ftp_user = "tim";
   $ftp_pass = "wthbn#@121";
   
   // FTP 서버에 연결
   $con = ftp_connect($ftp_server) or die("Could not connect to $ftp_server");
   
   // 로그인
   $login = ftp_login($con, $ftp_user, $ftp_pass);
   
   // 현재 디렉터리(.)의 파일 목록 조회
   $list = ftp_nlist($con, ".");
   
   // 결과 출력
   var_dump($list);
   
   // 연결 종료
   ftp_close($con);
?>

참고 사항

• FTP 연결 후에는 반드시 ftp_login()으로 인증을 거쳐야 정상적으로 함수를 사용할 수 있습니다.

• 작업이 끝난 후에는 ftp_close()로 연결을 종료해 리소스 낭비를 방지하세요.

• PASV 모드가 필요한 환경에서는 ftp_pasv($con, true)를 호출한 뒤 목록을 조회하면 방화벽 문제를 피할 수 있습니다.