عرض مصدر PHP/is readable

<noinclude>{{DISPLAYTITLE:الدالة <code>is_readable()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

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

== الوصف ==
<syntaxhighlight lang="php">
bool is_readable ( string $filename )
</syntaxhighlight>تتحقَّق هذه الدالة فيما إذا كان الملف <code>filename</code> موجودًا وقابلًا للقراءة.

== المعاملات ==

=== <code>filename</code> ===
مسار الملف المراد التحقُّق منه.

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

== أمثلة ==
المثال 1: استعمال الدالة <code>is_readable()‎</code><syntaxhighlight lang="php">
<?php
$filename = 'test.txt';
if (is_readable($filename)) {
    echo 'The file is readable';
} else {
    echo 'The file is not readable';
}
?>
</syntaxhighlight>

== الأخطاء والاستثناءات ==
سيُصدر تحذير من المستوى <code>E_WARNING</code> عند فشل العمليَّة.

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

== انظر أيضًا ==
* الدالة <code>[[PHP/is writable|is_writable()‎]]</code>: تتحقَّق إن كان الملف موجودًا وقابلًا للكتابة.
* الدالة <code>[[PHP/file exists|file_exists()‎]]</code>: تتحقَّق من وجود ملف أو مجلَّد محدَّد.
* الدالة <code>[[PHP/fgets|fgets()‎]]</code>: تجلب سطرًا واحدًا من الملف.

== مصادر ==
* [http://php.net/manual/en/function.is-readable.php صفحة الدالة is_readable في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Filesystem]]