chdir

(PHP 4, PHP 5, PHP 7, PHP 8)

chdirИзменяет каталог

Описание

chdir(string$directory): bool

Изменяет текущий каталог 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.

Смотрите также

  • getcwd() - Получает имя текущего рабочего каталога
To Top