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

(PHP 4, PHP 5, PHP 7)

تجلب الدالة filectime()‎ آخر وقت جرى فيه تعديل مؤشِّر الفهرسة (inode) لملف محدَّد.

الوصف

int filectime ( string $filename )

تعيد هذه الدالة آخر وقت جرى فيه تعديل مؤشر الفهرسة (inode) للملف filename.

المعاملات

filename

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

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

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

أمثلة

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

<?php

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

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

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

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

ملاحظات

• تفترض أغلب أنظمة الملفات في يونكس أنَّ تعديلاتٍ حدثت للملف عندما يُعدَّل محتوى مؤشر الفهرسة ( inode) لذلك الملف؛ أي عندما تُحدَّث الأذونات أو المالك أو المجموعة المالكة أو أيٌّ من بنى البيانات الوصفيَّة الأخرى (metadata) في مؤشر الفهرسة. راجع الدالة filemtime()‎ -التي تحتاجها عندما تريد إنشاء "آخر تعديل (Last Modified)" في تذييل صفحات الويب- والدالة fileatime()‎ أيضًا.
• لاحظ أنَّه قد يُشار إلى آخر وقت جرى فيه التعديل في بعض مراجع يونكس إلى أنَّه الوقت الذي أُنشئ فيه الملف، وهذا خطأ. لا يوجد وقت يشير إلى لحظة إنشاء الملف في أغلب أنظمة الملفات في يونكس.
• الجدير بالملاحظة أنَّ دقَّة الوقت قد تختلف من نظام ملفات إلى آخر.
• ستُخزَّن نتيجة هذه الدالة. راجع صفحة الدالة clearstatcache()‎ للمزيد من التفاصيل.

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

انظر أيضًا

• الدالة filemtime()‎: تجلب آخر وقت جرى فيه تعديل الملف.

مصادر

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