array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.chdir.php', 1 => 'chdir', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Функции для работы с каталогами', ), 'prev' => array ( 0 => 'ref.dir.php', 1 => 'Функции для работы с каталогами', ), 'next' => array ( 0 => 'function.chroot.php', 1 => 'chroot', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/dir/functions/chdir.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
chdir — Изменяет каталог
Изменяет текущий каталог 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
Если PHP-интерпретатор собран с поддержкой ZTS (Zend Thread Safety), любые изменения в текущем каталоге, сделанные с помощью chdir(), не будут обнаружены операционной системой. Все встроенные функции PHP будут по-прежнему учитывать изменения в текущем каталоге; это не относится к вызываемым функциям внешних библиотек, подключённых через FFI. Используйте php -i или встроенную константу PHP_ZTS
, чтобы узнать, собран ли PHP с ZTS.