PHP: dirname - Manual

Opis

string dirname ( string ścieżka )

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

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

Przykład 1. dirname() przykład


<?php

$path = "/etc/passwd";

$file = dirname($path); // $file zawiera "/etc"

?>

Notatka: W PHP 4.0.3, dirname() została poprawiona aby być zgodną z POSIX. To znaczy, że jeśli w parametrze ścieżka nie ma slasha, to zostanie zwrócona kropka ('.'), oznaczająca bieżący katalog. W przeciwnym wypadku, zostanie zwrócony łańcuch podany w parametrze path z usuniętymi /komponentami. Zauważ, że to oznacza uzyskiwanie slasha lub kropki z dirname() w sytuacjach w których starsza funkcjonalność mogła dać Tobie pusty łańcuch.

Zachowanie dirname() zostało zmienione w PHP 4.3.0. Sprawdź następujące przykłady:


<?php 

    

  //przed PHP 4.3.0 

  dirname('c:/'); // zwracało '.' 

    

  //po PHP 4.3.0 

  dirname('c:/'); // zrwaca 'c:' 

    

  ?>

dirname() jest binarnie bezpieczna od PHP 5.0.0

Patrz także: basename(), pathinfo() i realpath().

User Contributed Notes


--- Edited by tularis@php.net ---


You could also have a look at the getcwd() function


--- End Edit ---





A nice "current directory" function.





function current_dir()


{


$path = dirname($_SERVER[PHP_SELF]);


$position = strrpos($path,'/') + 1;


print substr($path,$position);


}





current_dir();





I find this usefull for a lot of stuff! You can maintain a modular site with dir names as modules names. At least I would like PHP guys to add this to the function list!





If there is anything out there like it, please tell me.


Attention with this. Dirname likes to mess with the slashes.

On Windows, Apache: 



<?php

echo '$_SERVER[PHP_SELF]: ' . $_SERVER['PHP_SELF'] . '<br />';

echo 'Dirname($_SERVER[PHP_SELF]: ' . dirname($_SERVER['PHP_SELF']) . '<br>';

?>



prints out



$_SERVER[PHP_SELF]: /index.php

Dirname($_SERVER[PHP_SELF]: \


Since the paths in the examples given only have two parts (e.g. "/etc/passwd") it is not obvious whether dirname returns the single path element of the parent directory or whether it returns the whole path up to and including the parent directory.  From experimentation it appears to be the latter.



e.g. 



dirname('/usr/local/magic/bin');



returns '/usr/local/magic'  and not just 'magic'



Also it is not immediately obvious that dirname effectively returns the parent directory of the last item of the path regardless of whether the last item is a directory or a file.  (i.e. one might think that if the path given was a directory then dirname would return the entire original path since that is a directory name.)



Further the presense of a directory separator at the end of the path does not necessarily indicate that last item of the path is a directory, and so 



dirname('/usr/local/magic/bin/');  #note final '/'



would return the same result as in my example above.



In short this seems to be more of a string manipulation function that strips off the last non-null file or directory element off of a path string.