Plantilla:PHP/Formularios/transmisionFicheros

Transfirieno ficheros entre clinte y servidor

• Es muy sencillo y frecuente subir ficheros entre cliente y servidor

• Cuando vamos a subir ficheros hay que conocer acciones a indicar tanto en la parte de cliente como en la de servidor.

Acciones en el Cliente

input type=file

• Debemos especificar un elemento input con de type file en un formulario
• Como todo input debe tener asignado un name para acceder a él en el servidor

<input type=file name=fichero>

form method=POST enctype="multipart/form-data

• El formulario donde esté el input ha de tener especificado el atributo enctype establecido con el valor mutipart/form-data.
• Cuando no especificamos tipo, se asume por defecto el valor application/x-www-form-urlencoded. Este valor implica que enviamos texto plano y lo podremos enviar tanto por GET como por POST.
• No obstante si vamos a transferir un fichero no necesariamente de texto debemos especificarlo establemciendo el valor de enctype a mutipart/form-data. Este valor se emplea para tranferir gran cantidad de texto u otros formatos de fichero entre cliente y servidor

Recursos de la Web

https://www.w3.org/TR/1999/REC-html401-19991224/interact/forms.html#form-content-type

enctype es un atributo necesario para especificar el tipo de contendio usado para enviar la información del formulario al servidor

• Necesariamente hemos de usar el método POST para este cometido

<form action='' method=POST entype='multipart/form-data'>
....
</form>

Establecer tamaño en el cliente

• El tamaño de bytes que vamos a enviar también puede quedar establecido en el cliente, de modo que si el fichero tiene un tamaña mayor, no se envía
• Para esto se establece antes del input file, un input hidden con name = MAX_SIZE_FILE y value el valor del tamaño máximo.
• Este mecanismo no avisa al cliente de nada, simplemente dejará de enviar el fichero al servidor en caso de exceder el tamaño.
• En el servidor se recibirá un error de valor 2 o constante UPLOAD_ERR_FORM_SIZE, (Ver código de errores más abajo o en http://php.net/manual/es/features.file-upload.errors.php
• Con todo lo dicho, la especificación en el cliente quedaría

  <form action="descarga.php" method="POST" enctype="multipart/form-data">
            <input type="hidden" name="MAX_FILE_SIZE" value="10000000">
            <h3>Selecciona fichero </h3>
            <input type="file" name="fichero" id="" >
            <br />
            <input type="submit" value="Acceder" name="descarga">
        </form>

Acciones en el Servidor: $_FILES

Con el fichero que viene del cliente, en el servidor podemos hacer:

1. Capturar el fichero y dejarlo en un directorio concreto
2. Ver si se ha producido algún error especificando el código de error mediante una constante numérica
3. Ver el tamaño del fichero
4. Analizar el tipo de fichero para poder por ejemplo aceptarlo o descartarlo o decidir en qué carpeta dejarlo en función del tipo

Copiando el fichero a una carpeta

• Lógicamente primero deberemos crear esa carpeta y asegurarnos que tenga permisos de escritura en ella el usuario apache (normalmente www-data)
• Cuando viene la solicitud del cliente con un fichero como contenido de un formulario, se accede a ese input a través de la superglobal $_FILES.
• $_FILES va a ser un array asociativo con un elemento por cada input de tipo file que venga del servidor, o sea por cada fichero subido
• Cada posición a su vez contiene un array asociativo con información de ese fichero donde entre otros tenemos los siguientes campos que nos interesan

1. name Nombre del fichero en el cliente
2. type Tupo de fichero subido
3. size Tamaño en bytes del fichero
4. tpm_name Nombre asignado de forma temporal en el servidor
5. error Error que se haya podido producir o 0 si no ha habido ninguno

CÓDIGOS DE ERROR SUBIENDO FICHEROS

Valor enterio !! Constante !! Descripción

0	UPLOAD_ERR_OK	Fichero subido exitonsamente
1	UPLOAD_ERR_INI_SIZE	tamaño excedido según directiva upload_max_filesize de php.ini.
2	UPLOAD_ERR_FORM_SIZE	El fichero subido excede la directiva MAX_FILE_SIZE especificada en el formulario HTML.
3	UPLOAD_ERR_PARTIAL	El fichero fue sólo parcialmente subido.
4	UPLOAD_ERR_NO_FILE	No se subió ningún fichero.
5	UPLOAD_ERR_NO_TMP_DIR
6	UPLOAD_ERR_CANT_WRITE	Falta la carpeta temporal. Introducido en PHP 5.0.3.
7		No se pudo escribir el fichero en el disco. Introducido en PHP 5.1.0.
8	UPLOAD_ERR_EXTENSION	Una extensión de PHP detuvo la subida de ficheros

• Una vez presionado el submit en el cliente el fichero se copia en un fichero en una carpeta temporal

Almacenando el fichero en el servidor

• Una vez que está subido en la carpeta temporal y después de hacer las comprobaciones que consideremos, debemos guardarlo en el servidor
• Para ello usaremos la función

  $rtdo= move_uploaded_file($origen, $destino);

Cómo leer ficheros de un directorio en el servidor

• Vamos a usar la clase Directory
• El tema de programación orientado a objetos lo veremos mas tarde, pero sabemos que para invocar a un método de un objeto se usa el operador de indierección ->
• Los métodos los vemos como funciones que son de una clase y los puede invocar un objeto. (Esta idea imprecisa de momento es suficiente.
• Es una clase que me permite trabajar con ficheros (los directorios son ficheros igualmente)
• Para inicializarlo podemos usar un alias de new Directory() llamada dir(...)
• En su invocación pasamos el directorio que queremos ver

   $directorio = dir("/var/www/musica/subidas/");

• Para leer el contenido de un fichero o un directorio (los archivos que contiene), se usa el método read()
• Una forma de hacerlo es

 while ($archivo = $directorio -> read()){
        .................        }
 }

• No olvidemos cerrar el fichero con el método close

    $directorio->close();

[[Actividad Se pide que hagas un programa para subir ficheros de música a un servidor y qué este me visualice todos los ficheros subidos]]