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

Примечания

Предостережение

Операционная система не заметит изменений в текущем каталоге, которые сделали через функцию chdir(), если PHP-интерпретатор собрали с поддержкой потокобезопасного режима ZTS (Zend Thread Safety). Все встроенные PHP-функции по-прежнему будут учитывать изменения в текущем каталоге; это не относится к вызываемым функциям внешних библиотек, которые подключили через модуль FFI. Собрали ли PHP с поддержкой ZTS, покажет команда php -i или встроенная константа PHP_ZTS.

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

  • getcwd() - Получает текущую рабочую директорию