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

Примечания

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

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

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

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