الدالة chroot()
في PHP
< PHP
(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();
?>
سيُظهر المثال السابق النتيجة التالية:
/
ملاحظات
لا تعمل هذه الدالة على منصات ويندوز.