PHP의 ftp_rename() 함수는 FTP 서버에 저장된 파일 또는 디렉터리의 이름을 변경하는 데 사용됩니다. FTP를 통해 원격 서버의 파일을 관리하거나 업로드 후 파일명을 정리하는 등의 작업을 자동화할 때 유용하게 활용할 수 있습니다.
문법(Syntax)
ftp_rename(conn, oldname, newname);
매개변수(Parameters)
conn −
ftp_connect()로 생성한 FTP 연결 리소스입니다.old_name − 이름을 변경할 기존 파일 또는 디렉터리의 경로입니다.
new_name − 변경할 새로운 파일 또는 디렉터리의 이름입니다.
반환 값(Return)
ftp_rename() 함수는 이름 변경에 성공하면 TRUE를, 실패하면 FALSE를 반환합니다. 따라서 조건문과 함께 사용하면 작업 결과에 따라 다른 처리를 수행할 수 있습니다.
예제(Example)
다음은 FTP 서버에 접속한 뒤, demo.txt 파일의 이름을 new.txt로 변경하는 예제입니다.
<?php
$ftp_server = "192.168.0.4";
$ftp_user = "jacob";
$ftp_pass = "tywg61gh";
// FTP 서버에 연결
$conn = ftp_connect($ftp_server) or die("$ftp_server 에 연결할 수 없습니다");
// 로그인
$login = ftp_login($conn, $ftp_user, $ftp_pass);
$old_file = "demo.txt";
$new_file = "new.txt";
// 파일 이름 변경
if (ftp_rename($conn, $old_file, $new_file)) {
echo "$old_file 을(를) $new_file 로 이름을 변경했습니다";
} else {
echo "$old_file 의 이름을 $new_file 로 변경할 수 없습니다";
}
// 연결 종료
ftp_close($conn);
?>
참고 사항
파일 경로는 FTP 서버 기준의 상대 경로 또는 절대 경로로 지정할 수 있습니다.
이름 변경 권한이 없는 계정으로 로그인한 경우 함수가 FALSE를 반환하므로, 계정 권한을 반드시 확인해야 합니다.
작업이 끝난 후에는
ftp_close()를 호출하여 연결을 명시적으로 종료하는 것이 좋습니다.