dirname
(PHP 4, PHP 5, PHP 7, PHP 8)
dirname — Повертає ім'я батьківського каталогу із зазначеного шляху
Опис
dirname(string $path, int $levels = 1): string
Отримавши рядок, що містить шлях до файлу або каталогу, ця функція поверне батьківський каталог цього шляху на levels рівнів догори.
Зауваження :
Функцияdirname() наївно оперує виключно вихідним рядком та не враховує реальну файлову систему чи компоненти шляху типу "
.. .".
Застереження
В Windowsdirname() передбачає поточну встановлену кодову сторінку, тому щоб бачити правильне ім'я каталогу з шляхами багатобайтових символів, необхідно встановити відповідну кодову сторінку. Якщо path містить символи, неприпустимі для поточної кодової сторінки, поведінка **dirname()**не определено.
В інших системах dirname() припускає, що path закодований у кодуванні, сумісному з ASCII. В іншому випадку поведінка функції не визначена.
Список параметрів
path
Шлях.
На платформах Windows як роздільники імен директорій використовуються обидва сліші (прямий і зворотний \). В інших операційних системах роздільником служить прямий сліш (
levels
На скільки рівнів вкладеності нагору необхідно пройти.
Має бути цілим числом більше 0.
Значення, що повертаються
Повертає шлях до батьківської директорії. Якщо у параметрі path не міститься слішів, буде повернуто крапку (' '), що означає поточну директорію. В іншому випадку буде повернутий path без останнього компонента /component
Застереження
Будьте обережні при використанні цієї функції в циклі, який може досягти каталогу верхнього рівня, оскільки це може призвести до нескінченного циклу.
список змін
| Версия | Опис |
|---|---|
| 7.0.0 | Додано необов'язковий параметр levels |
Приклади
Приклад #1 Приклад використання функції dirname()****
Висновок наведеного прикладу буде схожим на:
/etc
/ (или \ в Windows)
.
C:\
/usr
Дивіться також
- basename() - Повертає останній компонент імені із зазначеного шляху
- pathinfo() - Повертає інформацію про шлях до файлу
- realpath() - Повертає абсолютний канонізований шлях до файлу