الدالة fileatime()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تجلب الدالة fileatime()‎ آخر وقت جرى فيه الوصول إلى الملف.

الوصف

int fileatime ( string $filename )

تعيد هذه الدالة آخر وقت جرى فيه الوصول إلى الملف filename.

المعاملات

filename

مسار الملف الذي ستُجرى عليه العمليَّة.

القيم المعادة

يُعاد وقت آخر وصول إلى الملف filename أو تُعاد القيمة FALSE عند فشل العمليَّة. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp).

أمثلة

المثال 1: استعمال الدالة fileatime()‎

<?php

$filename = 'somefile.txt';
if (file_exists($filename)) {
    echo "$filename was last accessed: " . date("F d Y H:i:s.", fileatime($filename));
}

//”somefile.txt was last accessed: December 29 2002 22:16:23.” :ستظهر النتيجة بالشكل
?>

الأخطاء والاستثناءات

سيُصدَر تحذير من المستوى E_WARNING عند فشل الدالة.

ملاحظات

• يُفترض أن يتغيَّر وقت الوصول لأيِّ ملف في كلِّ مرة يُقرأ فيها محتوى هذا الملف. يمكن لذلك أن يقلِّل من الأداء خصوصًا عندما يصل تطبيق ما إلى عدد كبير جدًا من الملفات أو المجلدات. يمكن الوصول إلى بعض أنظمة الملفات في يونكس مع تعطيل تحديث وقت الوصول وذلك لزيادة أداء بعض التطبيقات، وخدمة الأخبار USENET خير مثال على ذلك. ستكون هذه الدالة على بعض أنظمة الملفات عديمة الفائدة.
• الجدير بالملاحظة أنَّ دقَّة الوقت قد تختلف من نظام ملفات إلى آخر.
• ستُخزَّن نتيجة هذه الدالة. راجع صفحة الدالة clearstatcache()‎ للمزيد من التفاصيل.

فائدة: يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

انظر أيضًا

• الدالة filemtime()‎: تجلب آخر وقت جرى فيه تعديل الملف.
• الدالة fileinode()‎: تجلب رقم مؤشِّر الفهرسة (inode) للملف.
• الدالة date()‎: تنسيق الوقت والتاريخ المحلِّي.

مصادر

• صفحة الدالة fileatime في توثيق PHP الرسمي.