The filectime() function in PHP is an inbuilt function which is used to return the last time the specified file was changed. The filectime() function returns the last time the file was changed as a Unix Timestamp on success and False on failure. The filectime() function checks for inode changes which are the updations in permissions, owner, group or other metadata as well as regular changes.
The filename is passed as a parameter to the filectime() function. The result of the filectime() function is cached and a function called clearstatcache() is used to clear the cache.
Syntax:
filectime($filename)
Parameters: The filectime() function in PHP accepts only one parameter $filename. It specifies the file whose last changed time you want to check.
Return Value: It returns the last changed time of a file as a Unix Timestamp on success and False on failure.
Errors And Exception:
- The time resolution may differ from one file system to another.
- This function doesn’t works on some unix systems which have access time updates are disabled to increase performance.
Examples:
Input : echo filectime("gfg.txt"); Output : 1525159574 Input : echo "Last changed: ".date("F d Y H:i:s.", filectime("gfg.txt")); Output : Last changed: May 1 2018 07:26:14.
Below programs illustrate the filectime() function.
Program 1:
<?php // checking last time a file was changed echo filectime ( "gfg.txt" ); ?> |
Output:
1525159574
Program 2:
<?php // checking last time a file was changed echo filectime ( "gfg.txt" ); // checking last time a file was changed // and formatting the output of the date echo "Last changed: " . date ( "F d Y H:i:s." , filectime ( "gfg.txt" )); ?> |
Output:
1525159574 Last changed: May 1 2018 07:26:14.