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

(PHP 4, PHP 5, PHP 7)

تعيد الدالة filemtime()‎ وقت آخر تعديل أُجري على الملف.

الوصف

int filemtime ( string $filename )

تعيد هذه الدالة وقت آخر مرَّةٍ أُضيفت فيها بيانات إلى الملف filename أي وقت آخر تعديل أُجري على محتوى ذاك الملف.

المعاملات

filename

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

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

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

أمثلة

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

<?php

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

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

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

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

ملاحظات

• الجدير بالملاحظة أنَّ دقَّة الوقت قد تختلف من نظام ملفات إلى آخر.
• ستُخزَّن نتيجة هذه الدالة. راجع صفحة الدالة clearstatcache()‎ للمزيد من التفاصيل.

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

انظر أيضًا

• الدالة filectime()‎: تعيد آخر وقت جرى فيه تعديل مؤشِّر الفهرسة (inode) لملف محدَّد.
• الدالة stat()‎: تعيد معلومات عن الملف.
• الدالة touch()‎: تضبط وقت الوصول والتعديل للملف.
• الدالة getlastmod()‎: تعيد وقت آخر تعديل أُجري على الصفحة.

مصادر

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