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

(PHP 4, PHP 5, PHP 7)

تعيد الدالة lstat()‎ معلومات عن ملف أو وصلة رمزيَّة.

الوصف

array lstat ( string $filename )

تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف أو الوصلة الرمزيَّة التي يشير إليها المعامل filename.

المعاملات

filename

مسار الملف أو الوصلة الرمزيَّة.

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

تُعاد مصفوفة تحتوي على معلومات إحصائيَّة عن الملف أو الوصلة الرمزيَّة. بنية تلك المصفوفة مشروحة بالتفصيل في توثيق الدالة stat()‎. هذه الدالة مطابقة تمامًا للدالة stat()‎ باستثناء أنَّه إن كان المعامل filename وصلة رمزيَّة، فستُعاد حالة الوصلة الرمزيَّة وليس حالة الملف الذي تشير إليه.

أمثلة

المثال 1: الموازنة بين الدالة lstat()‎ والدالة stat()‎

<?php
symlink('uploads.php', 'uploads');

//uploads والوصلة الرمزية uploads.php موازنة المعلومات للملف
array_diff(stat('uploads'), lstat('uploads'));
?>

سيُظهر المثال السابق نتيجة شبيه بالتالي، وهي المعلومات المختلفة بين كلا الملفين.

Array
(
    [dev] => 771
    [ino] => 488704
    [mode] => 33188
    [nlink] => 1
    [uid] => 0
    [gid] => 0
    [rdev] => 0
    [size] => 1114
    [atime] => 1061067181
    [mtime] => 1056136526
    [ctime] => 1056136526
    [blksize] => 4096
    [blocks] => 8
)

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

سيُولَّد خطأ من المستوى E_WARNING عند فشل العمليَّة.

ملاحظات

• ستُخزَّن نتيجة هذه الدالة. راجع الدالة clearstatcache()‎ للمزيد من التفاصيل.
• يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

انظر أيضًا

• الدالة stat()‎: تعيد معلومات عن ملف محدَّد.

مصادر

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