realpath - Возвращает канонизированный абсолютный путь к файлу
Вернуться к: Файловая система
realpath
(PHP 4, PHP 5, PHP 7)
realpath — Возвращает канонизированный абсолютный путь к файлу
Описание
$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() - Возвращает информацию о пути к файлу
Вернуться к: Файловая система