realpath
(PHP 4, PHP 5, PHP 7, PHP 8)
realpath — Повертає абсолютний канонізований шлях до файлу
Опис
realpath(string $path): string|false
realpath() розкриває всі символічні посилання, переходи типу /./ /../ та зайві символи в дорозі path, повертаючи абсолютний канонізований шлях до файлу.
Список параметрів
path
Перевірений шлях.
Зауваження :
Незважаючи на те, що шлях повинен бути вказаний, передане значення може бути пустим рядком. У таких випадках значення інтерпретується як поточна робоча директорія.
Значення, що повертаються
У разі успішного виконання повертає абсолютний канонізований шлях. Результуючий шлях не містить символічних посилань та компонентів на кшталт /./ або '/../. Розділювачі \и в конце пути также удаляются.
realpath() повертає **false**при неудаче, наПриклад, если файл не существует.
Зауваження :
Скрипт, що запускається, повинен мати права запуску на всіх директоріях в ієрархії, що перевіряється, інакше realpath() поверне
false
Зауваження :
Для реєстронезалежних файлових систем, realpath() може нормалізувати чи нормалізувати регістр символів.
Зауваження :
Функцияrealpath() не працюватиме з файлом усередині архіву Phar, оскільки шлях може бути не реальним, а віртуальним.
Зауваження :
У Windows переходи та символічні посилання на каталоги розширюються лише на один рівень.
Зауваження: Так як тип integer в PHP є цілим числом зі знаком, і багато платформ використовують 32-бітові цілі числа, то деякі функції файлових систем можуть повертати несподівані результати для файлів розміром більше 2 Гб.
Приклади
Приклад #1 Приклад використання функції realpath()****
Результат виконання наведеного прикладу:
/etc/passwd
/tmp
Приклад #2realpath()на Windows
На Windows**realpath()**изменит пути стиля Unix на стиль Windows.
Результат виконання наведеного прикладу:
C:\WINDOWS\System32
C:\Program Files
Дивіться також
- basename() - Повертає останній компонент імені із зазначеного шляху
- dirname() - Повертає ім'я батьківського каталогу із зазначеного шляху
- pathinfo() - Повертає інформацію про шлях до файлу