PHP fileatime() 함수 완벽 정리 – 파일의 마지막 접근 시간 확인하기

fileatime() 함수란?

PHP의 fileatime() 함수는 지정한 파일에 마지막으로 접근한 시간(last access time)을 확인하는 함수입니다. 반환되는 값은 UNIX 타임스탬프(1970년 1월 1일 00:00:00 UTC부터 경과한 초 단위 시간)이며, 함수 실행에 실패하면 false를 반환합니다.

파일을 읽거나 열었을 때 접근 시간이 갱신되므로, 로그 분석이나 파일 변경 감지 등 다양한 용도로 활용할 수 있습니다.

구문(Syntax)

fileatime ( file_path );

매개변수(Parameters)

• file_path − 마지막 접근 시간을 확인하고자 하는 파일의 경로를 문자열로 전달합니다.

반환 값(Return)

파일의 마지막 접근 시간을 UNIX 타임스탬프 형태의 정수로 반환하며, 파일이 존재하지 않거나 권한 문제 등으로 실패하면 false를 반환합니다.

기본 사용 예제

<?php
    echo fileatime("new.txt");
?>

출력 결과

1315416291

위 예제는 UNIX 타임스탬프 그대로 출력되기 때문에 사람이 직관적으로 이해하기 어렵습니다. 이번에는 date() 함수를 함께 사용해 날짜와 시간을 읽기 쉬운 형식으로 변환해 보겠습니다.

읽기 쉬운 날짜 형식으로 출력하기

<?php
    echo "파일의 마지막 접근 시간: ".date("F d Y H:i:s.", fileatime("new.txt"));
?>

출력 결과

Last access time of the file: September 22 2018 11:23:52

정리

fileatime()은 파일의 마지막 접근 시간을 손쉽게 확인할 수 있는 유용한 함수입니다. UNIX 타임스탬프로 반환된 값을 date() 함수와 조합하면 원하는 날짜 형식으로 자유롭게 표시할 수 있으며, 파일 관리 기능이나 모니터링 스크립트 작성 시 활용도가 높습니다.