PHP/chroot

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

تغيِّر الدالة chroot()‎ مجلَّد الجذر (root directory) الحالي.

الوصف

bool chroot ( string $directory )

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

هذه الدالة متاحةٌ فقط على أنظمة غنو (GNU)، وأنظمة BSD، وعند استعمال CLI أو CGI أو SAPI المضمَّنة. تتطلَّب هذه الدالة أيضًا صلاحيات مدير النظام (المستخدم الجذر، root) لتنفيذ العمليَّة.

المعاملات

directory

مسار المجلَّد المراد تغيير المجلَّد الجذر إليه.

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

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

أمثلة

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

<?php
chroot("/path/to/your/chroot/");
echo getcwd();
?>

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

/

ملاحظات

لا تعمل هذه الدالة على منصات ويندوز.

انظر أيضًا

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

مصادر

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