getcwd

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

getcwdПолучает имя текущего рабочего каталога

Описание

getcwd(): string|false

Возвращает имя текущего рабочего каталога.

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

У этой функции нет параметров.

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

Возвращает текущий рабочий каталог в случае успешного выполнения или false в случае ошибки.

На некоторых вариантах Unix getcwd() вернёт false, если на каком-либо из родительских каталогов не установлен режим чтения или поиска, даже если он установлен на текущем каталоге. Больше информации о режимах доступа смотрите в документации функции chmod().

Примеры

Пример #1 Пример использования getcwd()

<?php

// Текущий каталог
echo getcwd() . "\n";

chdir('cvs');

// Текущий каталог
echo getcwd() . "\n";

?>

Вывод приведённого примера будет похож на:

/home/didou
/home/didou/cvs

Примечания

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

Если PHP-интерпретатор собрали с поддержкой ZTS (Zend Thread Safety), текущий рабочий каталог, который возвращает функция getcwd(), может отличаться от того, который возвращают интерфейсы операционной системы. Буду задействованы внешние библиотеки (подключённые через FFI), которые используют текущий рабочий каталог.

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

  • chdir() - Изменяет каталог
  • chmod() - Изменяет режим доступа к файлу