stat() (stat)
تابع stat اطلاعات فایل را می دهد. «تابع (Function)» یعنی یک دستور آماده. با stat() می توان زمان آخرین دسترسی، تغییرات و اندازه را دید. مثل کارت گزارش یک فایل.
تعریف و کاربرد تابع stat
stat(filename) آرایه ای از جزئیات فایل برمی گرداند. مثلاً اندازه بر حسب بایت، زمان آخرین دسترسی، و زمان آخرین تغییر. برخی مقادیر به صورت «یونیکس تایم استمپ (Unix Timestamp)» هستند؛ یعنی تعداد ثانیه از 1970.
مثال عملی
<?php
$stat = stat("test.txt");
echo "Access time: " . $stat["atime"] . "\n";
echo "Modification time: " . $stat["mtime"] . "\n";
echo "Device number: " . $stat["dev"] . "\n";
?>
خروجی به زبان ساده
size: اندازه فایل بر حسب بایت.atime: زمان آخرین دسترسی.mtime: زمان آخرین ویرایش.ctime: زمان آخرین تغییر اینود.dev,ino,mode: جزئیات سیستمی.
نکته: نتیجه در کش ذخیره می شود. برای پاک کردن کش از clearstatcache() استفاده کن.
هشدار: خروجی سرور به سرور فرق دارد. ممکن است اندیس ها عددی، اسمی، یا هر دو باشند.
گام های عملی
- مسیر فایل را بده و stat() را صدا بزن.
- کلیدهای مهم مثل
sizeوmtimeرا بخوان. - اگر فایل تغییر کرد، اول clearstatcache() را اجرا کن.
راهنمای تابع stat را برای جزئیات بیشتر ببین.
جمع بندی سریع
- stat() جزئیات کامل فایل می دهد.
- زمان ها به صورت تایم استمپ هستند.
- نتیجه کش می شود؛ کش را پاک کن.
- خروجی بین سرورها متفاوت است.