الدالة rmdir() في PHP
< PHP
(PHP 4, PHP 5, PHP 7)
تحذف الدالة rmdir() مجلَّدًا محدَّدًا.
الوصف
bool rmdir ( string $dirname [, resource $context ] )
تحاول هذه الدالة حذف المجلَّد ذو المسار pathname المُعطى. يجب أن يكون هذا المجلَّد فارغًا ويملك أذونات تسمح بإجراء هذه العمليَّة. سيُصدر تحذير من المستوى E_WARNING عند فشل العلميَّة.
المعاملات
pathname
مسار المجلَّد المُراد حذفه.
context
ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context).
القيم المعادة
تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE عند فشلها.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 5.0.0 | يمكن استخدام الدالة rmdir() بدءًا من الإصدار PHP 5.0.0 مع بعض بروتوكولات URL. راجع صفحة البروتوكولات المدعومة لمعرفة البروتوكول الذي يدعم الدالة rmdir().
|
أمثلة
المثال 1: استعمال الدالة rmdir()
<?php
if (!is_dir('examples')) {
mkdir('examples');
}
rmdir('examples');
?>
ملاحظات
- إن كان الوضع الآمن (safe mode) مفعَّلًا، فستتحقَّق PHP فيما إذا كان الملف أو المجلَّد الذي ستُجرى عليه العمليَّة يملك مُعرِّف المستخدم المالك (UID) ذاته الذي يملكه السكربت الذي ينفَّذ آنذاك.
انظر أيضًا
- الدالة
is_dir(): تتحقَّق إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلدًا. - الدالة
mkdir(): تنشئ مجلَّدًا جديدًا. - الدالة
unlink(): تحذف ملفًا محدَّدًا.