PHP의 rename() 함수는 파일이나 디렉터리의 이름을 변경하는 데 사용됩니다. 이름 변경에 성공하면 TRUE를 반환하고, 실패하면 FALSE를 반환합니다.
문법(Syntax)
rename(old_filename, new_filename, context)
매개변수(Parameters)
old_filename − 이름을 변경할 기존 파일 또는 디렉터리의 이름입니다.
new_filename − 변경할 새로운 파일 또는 디렉터리의 이름입니다.
context − 스트림(stream)의 동작 방식을 지정합니다. 선택적으로 사용할 수 있습니다.
반환값(Return)
rename() 함수는 이름 변경에 성공하면 TRUE, 실패하면 FALSE를 반환합니다.
예제 1 – 같은 폴더 내에서 파일 이름 변경하기
다음 예제는 현재 디렉터리에서 one.txt 파일의 이름을 two.txt로 변경하는 코드입니다.
<?php
rename("one.txt", "two.txt");
?>
출력 결과
TRUE
예제 2 – 다른 경로로 파일 이동하며 이름 유지하기
rename() 함수는 단순히 이름만 바꾸는 것이 아니라, 새 경로를 지정하면 파일 이동 기능으로도 활용할 수 있습니다. 아래 예제는 java.docx 파일을 programming 폴더로 이동시키는 코드입니다.
<?php
rename("D:\new\tutorials\java.docx", "D:\new\tutorials\programming\java.docx");
?>
출력 결과
TRUE
정리
rename() 함수 하나로 파일 이름 변경과 파일(디렉터리) 이동을 모두 처리할 수 있습니다. 다만 대상 파일이 존재하지 않거나 권한이 없으면 FALSE가 반환되므로, 실무에서는 file_exists()로 파일 존재 여부를 먼저 확인하고 사용하는 것이 안전합니다.