array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.chroot.php', 1 => 'chroot', 2 => 'Изменяет корневой каталог', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Функции для работы с каталогами', ), 'prev' => array ( 0 => 'function.chdir.php', 1 => 'chdir', ), 'next' => array ( 0 => 'function.closedir.php', 1 => 'closedir', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/dir/functions/chroot.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

chroot

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

chroot — Изменяет корневой каталог

Описание

chroot(string $directory): bool

Функция изменяет корневой каталог текущего процесса на каталог, который указали в параметре directory, и изменяет текущий каталог на «/».

Функция доступна только на системах GNU и BSD и только при работе через CLI, CGI или Embed SAPI. Кроме того, функция требует прав суперпользователя.

Вызов функции не изменяет значения магических констант __DIR__ и __FILE__.

Список параметров

directory

Путь для изменения корневого каталога.

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Примеры

Пример #1 Пример использования функции chroot()

<?php

chroot("/path/to/your/chroot/");
echo getcwd();

?>

Результат выполнения приведённого примера: 

/

Примечания

Замечание: Для Windows-платформ функцию не реализовали.

Замечание: Функция недоступна в PHP-интерпретаторах, которые собрали с поддержкой ZTS (англ. Zend Thread Safety — потокобезопасность движка Zend). Команда php -i или встроенная константа PHP_ZTS указывает, собрали ли PHP с поддержкой ZTS.