Возвращает канонизированный абсолютный путь к файлу


(PHP 4, PHP 5)

realpathВозвращает канонизированный абсолютный путь к файлу

Описание

string realpath ( string $path )

realpath() раскрывает все символические ссылки, переходы типа '/./', '/../' и лишние символы '/' в пути path, возвращая канонизированный абсолютный путь к файлу.

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

path

Проверяемый путь.

Замечание:

Несмотря на то, что путь должен быть указан, переданное значение может быть пустой строкой или NULL. В этих случаях оно будет интерпретировано в качестве текущей директории.

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

В случае успеха возвращает канонизированный абсолютный путь. Результирующий путь не содержит символических ссылок и компонентов наподобие '/./' или '/../'.

realpath() возвращает FALSE при неудаче, например если файл не существует.

Замечание:

Запускаемый скрипт должен иметь права запуска на всех директориях в проверяемой иерархии, иначе realpath() вернет FALSE.

Замечание: Так как тип integer в PHP является целым числом со знаком и многие платформы используют 32-х битные целые числа, то некоторые функции файловых систем могут возвращать неожиданные результаты для файлов размером больше 2ГБ.

Список изменений

Версия Описание
5.3.0 До этого релиза realpath() не терпела неудачу на системах *BSD в случае отсутствия лишь последнего компонента пути path. Теперь realpath() не срабатывает также и в этом случае.

Примеры

Пример #1 Пример использования функции realpath()

<?php
chdir
('/var/www/');
echo 
realpath('./../../etc/passwd');
?>

Результат выполнения данного примера:

 /etc/passwd 

Пример #2 realpath() на Windows

На Windows realpath() изменит пути стиля Unix на стиль Windows.

<?php
echo realpath('/windows/system32');
?>

Результат выполнения данного примера:

 C:\WINDOWS\System32 

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

  • basename() - Возвращает последний компонент имени из указанного пути
  • dirname() - Возвращает имя родительского каталога из указанного пути
  • pathinfo() - Возвращает информацию о пути к файлу