PHP의 filectime() 함수는 파일의 마지막 변경 시간(최종 수정 시점)을 확인할 때 사용하는 함수입니다. 이 함수는 파일의 마지막 변경 시간을 UNIX 타임스탬프 형식으로 반환하며, 실패할 경우 false를 반환합니다.
문법 (Syntax)
filectime ( file_path );
매개변수 (Parameters)
file_path − 마지막 변경 시간을 확인하고자 하는 파일의 경로입니다. 상대 경로 또는 절대 경로 모두 사용할 수 있습니다.
반환값 (Return)
filectime() 함수는 파일의 마지막 변경 시간을 UNIX 타임스탬프(정수형)로 반환합니다. 파일이 존재하지 않거나 접근 권한이 없는 등 오류가 발생하면 false를 반환합니다.
사용 예제 1 – 타임스탬프로 출력하기
다음 예제는 info.txt 파일의 마지막 변경 시간을 UNIX 타임스탬프 값으로 그대로 출력하는 코드입니다.
<?php
echo filectime("info.txt");
?>
출력 결과
19346322544
사용 예제 2 – 사람이 읽기 쉬운 날짜 형식으로 출력하기
UNIX 타임스탬프는 숫자로만 표시되기 때문에 직관적이지 않습니다. date() 함수와 함께 사용하면 사람이 읽기 쉬운 날짜 및 시간 형식으로 변환하여 출력할 수 있습니다.
<?php
echo "파일의 마지막 변경 시간: ".date("F d Y H:i:s.", filectime("info.txt"));
?>
출력 결과
파일의 마지막 변경 시간: September 23 2018 08:12:42
참고 사항
filectime()은 파일의 내용뿐만 아니라 권한(permission), 소유자(owner) 등 inode 정보가 변경된 시간도 함께 반영한다는 점에 유의해야 합니다. 단순히 파일 내용이 수정된 시간만 확인하고 싶다면 filemtime() 함수를 사용하는 것이 더 적합합니다. 또한 이 함수의 결과는 캐시될 수 있으므로, 동일 스크립트 내에서 여러 번 호출할 경우 clearstatcache() 함수를 먼저 실행하는 것이 좋습니다.