Subir archivos con PHP (mediante HTTP POST)

Antes de comenzar con el código, veremos algunas cuestiones de la configuración relacionada con este tema en el archivo php.ini. Dentro de este archivo, existe una sección llamada "File Uploads". A continuación les muestro el contenido de esta sección en mi archivo php.ini (esta con los valores por defecto, con los que se instala para Ubuntu 8.10)

;;;;;;;;;;;;;;;;
; File Uploads ;
;;;;;;;;;;;;;;;;


; Whether to allow HTTP file uploads.
file_uploads = On

; Temporary directory for HTTP uploaded files (will use system default if not
; specified).
;upload_tmp_dir =

; Maximum allowed size for uploaded files.
upload_max_filesize = 2M

Como puedes notar, la primera opción (file_uploads = On) es realmente importante, ya que si le cambiamos el valor por "Off" imaginaras lo que pasa ....SI, se deshabilita la subida de archivos!!.

La segunda ("upload_tmp_dir") esta comentada, y podemos dejarla así, ya que de esta manera se usara el directorio del sistema por defecto para subir los archivos en forma temporal, esto es debido a que el archivo primero se sube a un directorio temporal y luego lo podemos mover a algún otro lado, si es que nos interesa guardarlo de forma permanente (ya veremos como se hace esto).

La tercera opción, nos permite especificar el tamaño máximo del archivo que podremos subir al servidor (en este caso 2 Megas).

Existe una cuarta opción muy ligada con la tercera, que se llama "post_max_size" e indica el tamaño máximo de datos enviados por POST que aceptará PHP; con lo cual, por mas que pongamos que "upload_max_filesize" sea de 100M, si "post_max_size" es menor que esto, no podremos enviar un archivo de 100M, ya que "post_max_size" tiene prioridad. Esta opción se encuentra en la sección "Data Handling" del archivo php.ini, y en mi caso el valor por defecto es de 8M.

;;;;;;;;;;;;;;;;;
; Data Handling ;
;;;;;;;;;;;;;;;;;

......
......

; Maximum size of POST data that PHP will accept.
post_max_size = 8M

......
......

Importante: Para que los cambios que realices en el archivo php.ini tengan efecto, debes reiniciar el servidor web (con Apache sobre Ubuntu 8.10 puedes usar sudo service apache2 restart, o bien sudo /etc/init.d/apache2 restart para otras versiones de Ubuntu, y muchas otras distribuciones también).

Dicho todo esto, es hora de comenzar con el código. Lo primero será crear un simple formulario HTML que nos permita seleccionar el archivo y enviarlo al servidor.

Código del archivo "prueba.html"

<form method="POST" action="subir_archivo.php" enctype="multipart/form-data">

   <input type="file" name="archivo">

   <input type="submit" value="Subir archivo">

</form>

En este formulario (y cualquiera que hagas para enviar archivos) debes tener en cuenta dos cosas principales: el method debe ser "POST" y el enctype debe ser "multipart/form-data". Aquí sólo hemos definido una campo de tipo "file" (con lo cual el navegador ya sabrá que debe mostrar el botón de "examinar" para que se pueda elegir el archivo) y un botón "submit" para enviar el archivo al servidor. La página que determinara que hacer con el archivo será "subir_archivo.php" (especificada en el atributo action del formulario). En la siguiente imagen se muestra como quedaría el formulario en el navegador (Firefox 3.0.5 en este caso):

Código del archivo "subir_archivo.php"

<?php
//Obtengo la ruta completa (con el nombre incluido) del archivo subido
$ruta_archivo_a_subir = $_FILES['archivo']['tmp_name'];

/*Armo la ruta completa (con el nombre incluido) de
donde quiero guardar el archivo en forma permanente*/
$ruta_destino = 'archivos_subidos/' . $_FILES['archivo']['name'];

//Si el archivo se subio correctamente, lo muevo a la ubicacion permanente
if( move_uploaded_file($ruta_archivo_a_subir, $ruta_destino) )
echo 'El archivo se ha subido exitosamente';
else
echo 'Ha ocurrido un problema al cargar el archivo';

?>

Este pequeño código, nos da una idea de como funciona la subida de archivos. Como vemos existe un array llamado $_FILES (que es superglobal). En $_FILES tendremos la información relacionada con los archivos que se subieron (en nuestro caso subimos un único archivo, pero podría haber mas). Dentro de $_FILES existe la siguiente información (para cada archivo subido):

//Nombre original del archivo (sólo el nombre)
$_FILES['nombre_del_campo_file_del_form']['name']

//Ruta temporal del archivo (con el nombre)
$_FILES['nombre_del_campo_file_del_form']['tmp_name']

//Tipo de archivo
$_FILES['nombre_del_campo_file_del_form']['type']

//Tamaño del archivo en bytes
$_FILES['nombre_del_campo_file_del_form']['size']

//Codigo de error que se produjo al subir archivo (si no hubo error, es 0)
$_FILES['nombre_del_campo_file_del_form']['error']

Con esta información disponible, el código averigua donde fue subido el archivo en forma temporal (['tmp_name']), arma la ruta hasta donde guardar el archivo; que en este caso lo guardaremos en un directorio llamado "archivos_subidos", y que si bien tendrá el nombre del archivo original ([' name']), podría ser cualquier otro nombre (muchas veces se lo cambia, dependiendo de la situación, ya que si los archivos los suben personas distintas, y se repite el nombre de archivo, el ultimo reemplaza al primero sin pedir confirmación alguna); por ultimo el archivo es movido desde el directorio temporal al definitivo con la función move_uploaded_file. Si la función move_uploaded_file no devuelve un error, el archivo se subió satisfactoriamente, de lo contrario hubo algún problema.

Te aconsejo que hagas todo tipo de pruebas, como intentar subir archivos de mayor tamaño que lo especificado como máximo en el archivo php.ini; mostrar el tamaño del archivo que se subió; ver si hubo algún código de error al subir el archivo; modificar el código para subir dos o mas archivos y todo lo que se te ocurra. En otro post, veremos un poco mas sobre el manejo de errores relacionado con archivos, pero por el momento hasta aquí llegamos. Si haces alguna prueba, comentala así la vemos todos.