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

(PHP 4, PHP 5, PHP 7)

تعيد الدالة fstat()‎ معلومات عن ملف باستعمال مؤشِّر ملف مفتوح يشير إليه.

الوصف

array fstat ( resource $handle )

تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف المفتوح الذي يشير إليه المورد handle. تشبه هذه الدالة إلى حدٍّ كبير الدالة stat()‎ باستثناء أنَّها تتعامل مع مؤشِّر ملف مفتوح عوضًا عن مسار الملف.

المعاملات

handle

مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎.

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

تُعاد مصفوفة تحتوي على معلومات إحصائيَّة عن الملف. بنية تلك المصفوفة مشروحة بالتفصيل في توثيق الدالة stat()‎.

أمثلة

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

<?php

// فتح الملف
$fp = fopen("/etc/passwd", "r");

// جلب المعلومات الإحصائية
$fstat = fstat($fp);

// إغلاق الملف
fclose($fp);

// طباعة جزء من المعلومات
print_r(array_slice($fstat, 13));

?>

سيُظهر المثال السابق نتيجة شبيه بالتالي:

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
)

ملاحظات

لن تُنفَّذ هذه الدالة على الملفات البعيدة إذ يجب أن يكون الملف قابلًا للوصول عبر نظام ملفات الخادم.

مصادر

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