PHP/chdir

(PHP 4, PHP 5, PHP 7)

تغيِّر الدالة chdir()‎ مجلَّد PHP الحالي إلى مجلَّد آخر معطى.

الوصف

bool chdir ( string $directory )

تغيِّر هذه الدالة مجلَّد PHP الحالي إلى المجلَّد directory المعطى.

المعاملات

directory

المجلَّد الحالي الجديد.

القيم المعادة

تُعاد القيمة TRUE عند نجاح العمليَّة، والقيمة FALSE خلاف ذلك.

الأخطاء والاستثناءات

سيُصدر خطأ من المستوى E_WARNING عند فشل العمليَّة.

أمثلة

المثال 1: استعمال الدالة chdir()‎

<?php

// معرفة المجلَّد الحالي
echo getcwd() . "\n";

chdir('public_html');

// معرفة المجلَّد الحالي بعد تغييره
echo getcwd() . "\n";

?>

سيُظهر المثال السابق نتيجة شبيهة بالتالي:

/home/vincent
/home/vincent/public_html

ملاحظات

إن كان الوضع الآمن (safe mode) مفعَّلًا، فستتحقَّق PHP فيما إذا كان الملف أو المجلَّد الذي ستُجرى عليه العمليَّة يملك مُعرِّف المستخدم المالك (UID) ذاته الذي يملكه السكربت الذي ينفَّذ آنذاك.

انظر أيضًا

• الدالة getcwd()‎: تعيد مجلَّد العمل الحالي.

مصادر

• صفحة الدالة chdir في توثيق PHP الرسمي.