الدالة is_writable() في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تتحقَّق الدالة is_writable() إن كان الملف قابلًا للكتابة أو لا.
الوصف
bool is_writable ( string $filename )
تتحقَّق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للكتابة. تسمح الدالة بأن تكون قيمة المعامل filename اسم مجلَّد للتأكُّد من أنَّ هذا المجلَّد قابلٌ للكتابة.
تذكَّر دومًا أنَّ PHP قد تصل إلى الملف باستعمال مُعرِّف المستخدم (UID) إلا أنَّ خادم الويب يعمل على أنَّه "nobody" غالبًا. على أي حال، لا تؤخذ قيود الوضع الآمن بالحسبان قبل إصدار PHP 5.1.5.
المعاملات
filename
مسار الملف المراد التحقُّق منه.
القيم المعادة
تُعاد القيمة TRUE إن كان الملف filename موجودًا وقابلًا للكتابة، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ.
أمثلة
المثال 1: استعمال الدالة is_writable()
<?php
$filename = 'test.txt';
if (is_writable($filename)) {
echo 'The file is writable';
} else {
echo 'The file is not writable';
}
?>
الأخطاء والاستثناءات
سيُصدر تحذير من المستوى E_WARNING عند فشل العمليَّة.
ملاحظات
- ستُخزَّن نتيجة هذه الدالة. راجع الدالة
clearstatcache()للمزيد من التفاصيل. - يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).
انظر أيضًا
- الدالة
is_readable(): تتحقَّق إن كان الملف قابلًا للقراءة. - الدالة
file_exists(): تتحقَّق من وجود ملف أو مجلَّد محدَّد. - الدالة
fwrite(): تكتب على الملف بطريقة آمنة ثنائيًّا.