الدالة rmdir()‎ في PHP

من موسوعة حسوب
< PHP
مراجعة 14:51، 24 أبريل 2018 بواسطة جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

(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()‎: تحذف ملفًا محدَّدًا.

مصادر