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() - Изменяет режим доступа к файлу