Funkcje Systemu plików
PHP Manual

dirname

(PHP 4, PHP 5)

dirnameZwraca nazwę katalogu, będącego składową ścieżki

Opis

string dirname ( string $ścieżka )

Z podanego łańcucha zawierającego ścieżkę do pliku, funkcja ta zwróci nazwę katalogu.

Parametry

path

A path.

W Windows jako separator katalogu używany jest znak slash (/) i backslash (\). W innych środowiskach jest to slash (/).

Zwracane wartości

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.

Rejestr zmian

Wersja Opis
5.0.0 dirname() od teraz jest binarnie bezpieczna
4.0.3 dirname() poprawiono kompatybilność z POSIX.

Przykłady

Przykład #1 dirname() przykład

<?php
$sciezka 
"/etc/passwd";
$plik dirname($sciezka); // $plik jest ustawione na "/etc"
?>

Notatki

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 '\'

?>

Zobacz też:


Funkcje Systemu plików
PHP Manual