عرض مصدر PHP/is writable

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

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

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

تذكَّر دومًا أنَّ PHP قد تصل إلى الملف باستعمال مُعرِّف المستخدم (UID) إلا أنَّ خادم الويب يعمل على أنَّه "nobody" غالبًا. على أي حال، لا تؤخذ قيود الوضع الآمن بالحسبان قبل إصدار PHP 5.1.5.

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

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

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

== أمثلة ==
المثال 1: استعمال الدالة <code>is_writable()‎</code><syntaxhighlight lang="php">
<?php

$filename = 'test.txt';

if (is_writable($filename)) {

   echo 'The file is writable';

} else {

   echo 'The file is not writable';

}

?>

</syntaxhighlight>

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

== ملاحظات ==
* ستُخزَّن نتيجة هذه الدالة. راجع الدالة <code>[[PHP/clearstatcache|clearstatcache()‎]]</code> للمزيد من التفاصيل.
* يمكن أن تُستعمل هذه الدالة بدءًا من إصدار PHP 5.0.0 مع بعض بروتوكلات الروابط (URL wrappers).

== انظر أيضًا ==
* الدالة <code>[[PHP/is readable|is_readable()‎]]</code>: تتحقَّق إن كان الملف قابلًا للقراءة.
* الدالة <code>[[PHP/file exists|file_exists()‎]]</code>: تتحقَّق من وجود ملف أو مجلَّد محدَّد.
* الدالة <code>[[PHP/fwrite|fwrite()‎]]</code>: تكتب على الملف بطريقة آمنة ثنائيًّا.

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