(PHP 4, PHP 5)
dirname — Zwraca nazwę katalogu, będącego składową ścieżki
$ścieżka
)Z podanego łańcucha zawierającego ścieżkę do pliku, funkcja ta zwróci nazwę nadrzędnego katalogu.
path
A path.
W Windows jako separator katalogu używany jest znak slash (/) i backslash (\). W innych środowiskach jest to slash (/).
Zwraca nazwę katalogu. Jeśli, w ścieżce nie znajdują się
ukośniki to zwracana jest kropka ('.'), oznaczająca
bieżący katalog. W innym przypadku, zwracany jest łańcuch znaków
ścieżka z usuniętymi wszystkimi koncowymi
/komponentami.
| Wersja | Opis |
|---|---|
| 5.0.0 | dirname() od teraz jest binarnie bezpieczna |
| 4.0.3 | dirname() poprawiono kompatybilność z POSIX. |
Przykład #1 Przykład dirname()
<?php
echo "1) " . dirname("/etc/passwd") . PHP_EOL; // 1) /etc
echo "2) " . dirname("/etc/") . PHP_EOL; // 2) / (lub \ pod Windows)
echo "3) " . dirname("."); // 3) .
?>
Informacja:
dirname() działa naiwnie na wejściowym łańcuchu znaków i nie jest świadoma bieżącego systemu plików lub składników ścieżki takich jak "..".
Informacja:
dirname() jest świadoma locale, aby widzieć prawidłową nazwę katalogu z ścieżek z wielobajtowymi znakami, musi zostać ustawione pasujące locale za pomocą funkcji setlocale().
Informacja:
Od PHP 4.3.0, często otrzymasz ukośnik lub kropkę z dirname() w sytuacjach gdzie starsza funkcjonalność mogła dać pusty łańcuch znaków.
Sprawdź poniższy przykład zmian:
<?php
//przed PHP 4.3.0
dirname('c:/'); // zwraca '.'
//po PHP 4.3.0
dirname('c:/x'); // zwraca 'c:\'
dirname('c:/Temp/x'); // zwraca 'c:/Temp'
dirname('/x'); // zwraca '\'
?>