pclose

parse_ini_file

Last updated: Tue, 27 Nov 2007

pathinfo

(PHP 4 >= 4.0.3, PHP 5)

pathinfo — Devuelve información sobre la ruta de un archivo

Descripción

mixed pathinfo ( string $ruta [, int $opciones ] )

pathinfo() devuelve una matriz asociativa que contiene información sobre ruta .

Lista de parámetros

ruta: La ruta a chequear.
opciones: Es posible especificar cuáles elementos son devueltos con el parámetro opcional opciones . Éste se compone de PATHINFO_DIRNAME, PATHINFO_BASENAME, PATHINFO_EXTENSION y PATHINFO_FILENAME. Su valor predeterminado es devolver todos los elementos.

Valores retornados

Los siguientes elementos del array asociativo son devueltos: dirname, basename y extension (si existe), y filename.

Si se define opciones , esta función devolverá un valor string si no todos los elementos son pedidos.

Registro de cambios

Versión	Descripción
5.2.0	La constante `PATHINFO_FILENAME` fue agregada.

Ejemplos

Example#1 Ejemplo de pathinfo()


<?php
$partes_ruta = pathinfo('/www/htdocs/index.html');

echo $partes_ruta['dirname'] . "\n";
echo $partes_ruta['basename'] . "\n";
echo $partes_ruta['extension'] . "\n";
echo $partes_ruta['filename'], "\n"; // desde PHP 5.2.0
?>

El resultado del ejemplo seria:

/www/htdocs
index.html
html
index

Notes

Note: Para información sobre la recuperación de información sobre la ruta actual, lea la sección relevante en variables reservadas predefinidas.

Ver también

pclose

parse_ini_file

Last updated: Tue, 27 Nov 2007

add a note User Contributed Notes
pathinfo

spam2 at rhsoft dot net
09-Nov-2007 05:54


There is missing some documentation, especially since what version the second-parameter that "zendstudio neon" tells in auto-completition is available.



Get the extension of a file in one line of code is a nice thing, but i need to know about backward-compatibility to older versions...



pathinfo(str file, int options)



PATHINFO_BASENAME

PATHINFO_DIRNAME

PATHINFO_EXTENSION

PATHINFO_FILENAME

anders.jenbo()pc.dk
12-Sep-2007 12:34


Heres a funciton to get the same results from php 4+ but you will have to call pathinfo_filename() instead of pathinfo().



<?php

if(version_compare(phpversion(), "5.2.0", "<")) {

    function pathinfo_filename($path) {

        $temp = pathinfo($path);

        if($temp['extension'])

            $temp['filename'] = substr($temp['basename'],0 ,strlen($temp['basename'])-strlen($temp['extension'])-1);

        return $temp;

    }

} else {

    function pathinfo_filename($path) {

        return pathinfo($path);

    }

}

?>

avi-team at inbox dot lv
15-Jul-2007 06:14


You shouldn't assign values as it is described in previous post

// wrong:

list( $dirname, $basename, $extension, $filename ) = array_values( pathinfo($file) );



if $file has no extension, you get wrong variable values: $extension would be assigned with 'filename' array element of pathinfo() result, but $filename - would be empty.

phpnet at whoisgregg dot com
30-May-2007 09:01


If you want to easily assign the values returned by pathinfo to separate variable names, list isn't enough. You can use array_values() first to convert the associative array into the indexed array that list() expects:



// throws notices, variables aren't set

list( $dirname, $basename, $extension, $filename ) = pathinfo($file);



// works

list( $dirname, $basename, $extension, $filename ) = array_values( pathinfo($file) );

cochise_chiracahua at hotmail.com
25-Nov-2005 09:55


Sometimes, it's interessant to get the basename without extension.

So, I appended a new entry 'basenameWE' (Basename Without Extension) to the returned array.



<?php



// pathinfo improved

function pathinfo_im($path) {

    

    $tab = pathinfo($path);

    

    $tab["basenameWE"] = substr($tab["basename"],0

    ,strlen($tab["basename"]) - (strlen($tab["extension"]) + 1) );

    

    return $tab;

}



$my_path = "/var/www/html/example.html";



echo "<pre>\n";

print_r( pathinfo_im($my_path) );

echo "</pre>\n";



?>



Out :



Array

(

    [dirname] => /var/www/html

    [basename] => example.html

    [extension] => html

    [basenameWE] => example

)

sgermain at icexnetworks dot com
08-Jul-2005 09:24


It is true that if you put a directory into pathinfo, usually the extension is empty. But, if the directory name is /www/example.com/ for example, you will have the following output:



Array

(

    [dirname] => /www

    [basename] => example.com

    [extension] => com

)



So, it is the same as a file.

n0dalus
08-Feb-2005 11:47


If a file has more than one 'file extension' (seperated by periods), the last one will be returned.

For example:

<?php

$pathinfo = pathinfo('/dir/test.tar.gz');

echo 'Extension: '.$pathinfo['extension'];

?>

will produce:

Extension: gz



and not tar.gz

03-Dec-2004 02:39


If you want only the file extension, use this:

<?php

$extension = substr(strrchr($filename, "."), 1);

?>

This is many times faster than using pathinfo() and getting the value from array.

rob at webdimension dot co dot uk
04-Oct-2004 03:48


Further to my previous post.



This affects servers that run PHP as a cgi module



If you have your own server:

You can use the AcceptPathInfo directive to force the core handler to accept requests with PATH_INFO and thereby restore the ability to use PATH_INFO in server-side includes.



Further information:

http://httpd.apache.org/docs-2.0/mod/core.html#acceptpathinfo

junk at plaino dot com
19-Aug-2004 04:41


Convert a URL to the local file path and vice versa, convert a local file path to a URL.



// this sets the sytem / or \ :

strstr( PHP_OS, "WIN") ? $slash = "\\" : $slash = "/";



// This is the location of the php file that contains this

// function. Usually this request is made to files/folders 

// down the directory structure, so the php file that 

// contains these functions is a good "where am i" 

// reference point:

$WIMPY_BASE['path']['physical'] = getcwd();

$WIMPY_BASE['path']['www'] = "http://".$_SERVER['HTTP_HOST'];



function url2filepath($theURL){

    global $WIMPY_BASE, $slash;

    $AtheFile = explode ("/", $theURL);

    $theFileName = array_pop($AtheFile);

    $AwimpyPathWWW = explode ("/", $WIMPY_BASE['path']['www']);

    $AtheFilePath = array_values (array_diff ($AtheFile, $AwimpyPathWWW));

    if($AtheFilePath){

        $theFilePath = $slash.implode($slash, $AtheFilePath).$slash.$theFileName;

    } else {

        $theFilePath = implode($slash, $AtheFilePath).$slash.$theFileName;

    }

    return ($WIMPY_BASE['path']['physical'].$theFilePath);

}



function filepath2url ($theFilepath){

    global $WIMPY_BASE, $slash;

    $AtheFile = explode ($slash, $theFilepath);

    $theFileName = array_pop($AtheFile);

    $AwimpyPathFILE = explode ($slash, $WIMPY_BASE['path']['physical']);

    $AtheFilePath = array_values (array_diff ($AtheFile, $AwimpyPathFILE));

    $thFileURL = implode("/", $AtheFilePath)."/".$theFileName;

    return ($WIMPY_BASE['path']['www']."$thFileURL");

}

albertof at deltasoft dot com dot ar
29-May-2002 11:10


This code is to work in index.php/var/var



if(isset($PATH_INFO)) {

      $viewcode = explode('/', $PATH_INFO);

        $num = count($viewcode);

        if($num % 2 == 0) {

            $viewcode[] = '';

            $num++;

        }

        for($i = 1; $i < $num; $i += 2) {



            $$viewcode[$i] = $viewcode[$i+1];



          }

    }

m-symons at home dot com
25-Aug-2001 05:01


And, of course, to account for the problem noted in the first post whereby calling a directory, not a file, messes with the output of pathinfo(), you can include the following test:





if($pathinfo[extension] == "") {





$deep++;





}





Ooops...sorry for missing that.

m-symons at home dot com
25-Aug-2001 04:54


Here's a neat wee function to grab the relative path to root (especially useful if you're using mock-directories to pass variables into scripts with mod_rewrite).  The function simply iterates through every occurence of "/" within the REQUEST_URI environment variable, appending "../" to the output for every instance:





<?php





function path_to_root($path) {





    $pathinfo = pathinfo($path);


    


    $deep = substr_count($pathinfo[dirname], "/");


    


    $path_to_root = "./";


    


    for($i = 1; $i <= $deep; $i++) {


    


        $path_to_root .= "../";


        


    }


    


    return $path_to_root;


}





path_to_root($REQUEST_URI);





?>

mikep at oeone dot com
22-Aug-2001 08:27


If you run this on a directory, basename is the last directory in the path, dirname is the path before the final directory and extension is empty.

add a note

pclose

parse_ini_file

Last updated: Tue, 27 Nov 2007