الدالة `is_readable()`‎ في PHP

(PHP 4, PHP 5, PHP 7)

تتحقَّق الدالة is_readable()‎ إن كان الملف قابلًا للقراءة.

الوصف

bool is_readable ( string $filename )

تتحقَّق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للقراءة.

مسار الملف المراد التحقُّق منه.

تُعاد القيمة TRUE إن كان الملف filename موجودًا وقابلًا للقراءة، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ.

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

<?php
$filename = 'test.txt';
if (is_readable($filename)) {
    echo 'The file is readable';
} else {
    echo 'The file is not readable';
}
?>

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

تذكَّر دومًا أنَّ PHP قد تصل إلى الملف باستعمال معرِّف المستخدم (UID) إلا أنَّ خادم الويب يعمل على أنَّه "nobody" غالبًا. على أي حال، لا تؤخذ قيود الوضع الآمن بالحسبان قبل إصدار PHP 5.1.5.
ستُخزَّن نتيجة هذه الدالة. راجع الدالة clearstatcache()‎ للمزيد من التفاصيل.
يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).
سيُجرى التحقُّق باستعمال معرِّف المستخدم أو المجموعة UID/GID الحقيقي عوضًا عن المعرِّف الفعال EUID/EGID.
قد تعيد الدالة أحيانًا القيمة TRUE إن ظهر أنَّ الملف هو في الحقيقة مجلَّد. استعمل الدالة is_dir()‎ للتفريق بين الملف والمجلَّد.