is_uploaded_file
Manual de PHP
AnteriorSiguiente

is_uploaded_file

(PHP 3 >= 3.0.17, PHP 4 >= 4.0.3, PHP 5)

is_uploaded_file -- Indica si un archivo fue cargado a trav茅s de HTTP POST

Descripci贸n

bool is_uploaded_file ( string nombre_archivo )

Devuelve TRUE si el archivo dado por nombre_archivo fue cargado a trav茅s de HTTP POST. Esto es 煤til para ayudar a verificar que un usuario malicioso no ha intentado enga帽ar al script haci茅ndole trabajar sobre archivos con los que no deber铆a trabajar--por ejemplo, /etc/passwd.

Este tipo de chequeo es especialmente importante si existe alguna posibilidad de que cualquier cosa realizada con archivos cargados pueda revelar sus contenidos al usuario, o incluso a otros usuarios en el mismo sistema.

Para que trabaje adecuadamente, la funci贸n is_uploaded_file() necesita un argumento como $_FILES['archivo_usuario']['tmp_name'], - el nombre del archivo cargado en la m谩quina del cliente $_FILES['archivo_usuario']['name'] no funciona.

Ejemplo 1. Ejemplo de is_uploaded_file()

<?php

if (is_uploaded_file($_FILES['archivo_usuario']['tmp_name'])) {
   echo "El archivo ". $_FILES['archivo_usuario']['name'] ." fue cargado
   satisfactoriamente.\n";
   echo "Mostrando su contenido\n";
   readfile($_FILES['archivo_usuario']['tmp_name']);
} else {
   echo "Posible ataque de carga de archivo: ";
   echo "nombre de archivo '". $_FILES['archivo_usuario']['tmp_name'] . "'.";
}

?>

is_uploaded_file() se encuentra disponible 煤nicamente en versiones de PHP 3 superiores a PHP 3.0.16, y en versiones de PHP 4 superiores a 4.0.2. Si est谩 atrapado usando una versi贸n anterior, puede usar la siguiente funci贸n para protegerse:

Nota: El siguiente ejemplo no trabajar谩 con versiones de PHP 4 superiores a 4.0.2. Depende en la funcionalidad interna de PHP que fue modificada luego de esa versi贸n.

Ejemplo 2. Ejemplo de is_uploaded_file() para PHP 4 < 4.0.3

<?php
/* Prueba de usuario para verificar un archivo cargado. */
function is_uploaded_file_4_0_2($nombre_archivo)
{
    if (!$archivo_tmp = get_cfg_var('upload_tmp_dir')) {
        $archivo_tmp = dirname(tempnam('', ''));
    }
    $archivo_tmp .= '/' . basename($nombre_archivo);
    /* El usuario puede tener una barra final en php.ini... */
    return (ereg_replace('/+', '/', $archivo_tmp) == $nombre_archivo);
}

/* Asi es como se usa, ya que tampoco se cuenta con
* move_uploaded_file() en estas versiones antiguas: */
if (is_uploaded_file_4_0_2($HTTP_POST_FILES['archivo_de_usuario'])) {
    copy($HTTP_POST_FILES['archivo_de_usuario'], "/lugar/a/colocar/el/archivo/cargado");
} else {
    echo "Posible ataque de archivo entrante: nombre de archivo '$HTTP_POST_FILES[archivo_de_usuario]'.";
}
?>

Vea tambi茅n move_uploaded_file(), y la secci贸n Gesti贸n de carga de archivos para un ejempo de uso sencillo.

AnteriorInicioSiguiente
is_readableSubiris_writable