filemtime() (filemtime)
می خواهی «زمان آخرین تغییر محتوا» را بدانی؟ با filemtime راحت است. «زمان آخرین تغییر محتوا» یعنی آخرین باری که متن فایل عوض شد.
تعریف ساده و سینتکس
filemtime «یونیکس تایم استمپ (Unix Timestamp)» آخرین ویرایش محتوا را می دهد. سپس با date آن را خوانا کن.
<?php
$ts = filemtime("webdictionary.txt");
echo $ts;
echo "\n";
echo "Content last changed: ".date("F d Y H:i:s.", $ts);
?>
کش نتایج و تازه سازی
نتیجه این تابع «کش (Cache)» می شود. برای مقدار تازه، از clearstatcache استفاده کن. سپس دوباره filemtime را بخوان.
<?php
clearstatcache();
$ts = filemtime("webdictionary.txt");
echo date("Y-m-d H:i:s", $ts);
?>
مقایسه با زمان های دیگر
اگر «تغییر متادیتا» مهم است، از filectime استفاده کن. اگر «آخرین دسترسی» مدنظر است، سراغ fileatime برو.
گام های عملی سریع
- مسیر فایل را درست بده.
- در نیاز، کش را پاک کن.
- filemtime را صدا بزن.
- با date خروجی را خوانا کن.
نکته: اگر خطا رخ داد، مقدار false برمی گردد. مسیر و دسترسی را بررسی کن.
هشدار: «زمان آخرین تغییر محتوا» را با زمان آخرین تغییر محتوا اشتباه نگیر؛ filectime متادیتا را می سنجد.
جمع بندی سریع
- filemtime زمان آخرین ویرایش محتواست.
- خروجی، یونیکس تایم استمپ است.
- برای تازه سازی از clearstatcache استفاده کن.
- برای متادیتا، از filectime کمک بگیر.