Plantilla:PHP/Formularios/accionesFicheros

Acceso a un fichero
Entendemos por ello conseguir que php pueda actuar sobre su sistema de ficheros, es decir, en su disco duro, el disco duro que está en la máquina del servidor.

Ya vimos en la presentación que php nunca va a poder actuar sobre el disco duro del cliente (con la excepción de las cookies, como ya veremos en el apartado correspondiente, y siempre con el permiso del cliente).

Php tiene un rico abanico de funciones para realizar acciones sobre su sistema de ficheros, pero básicamente debemos saber realizar las típicas acciones CRUD en el sistema de ficheros.

http://php.net/manual/es/book.filesystem.php
 * 1.-Crear un fichero o abrirlo si ya existe.
 * 2.-Leer de un fichero.
 * 3.-Escribir en un fichero.
 * 4.-Borrar un fichero.
 * Podemos ver la lista de las funciones:

Crear/abrir un fichero para trabajar con él
Un fichero lo podemos abrir con tres intenciones


 * Leer de él.
 * Escribir en él.
 * Añadir en él.

Es importante a la hora de abrir un fichero saber para qué lo queremos y abrirlo en el modo adecuado.

Para poder trabajar con el contenido del fichero tenemos la función fopen. Esta función retorna un valor resource de tipo stream, será un objeto para gestionar ficheros que es creado y administrado por funciones del sistema de php.

Junto con la función fopen  que abre un recurso de tipo fichero para trabajar con él, hay que ver la función fclose, que nos libera el recurso de memoria. Es muy importante, podríamos decir que educado y limpio, cerrar todos los recursos que hayamos abierto y ya no vayamos a utilizar, garantizaremos un buen y correcto uso de la memoria del sistema.

Esta función retornará un booleano que indicará si pudo cerrar o no el puntero al fichero

Parar poder acceder a un fichero necesitamos tener una referencia a él (Tanto para escribir como para leer). A pesar de que no somos administradores/as debemos tener conocimientos para ciertos temas. Lo primero debemos tener claro es que cuando php le dice en el script a apache que actúe sobre el sistema de ficheros, es en última instancia el usuario apache quién quiere hacer la acciones
 * Temas de permisos de apache
 * Lee atentamente el siguiente cuadro y asegúrate de tener claro cada punto, si no, pregunta.

Por ejemplo:


 * Ejemplos
 * Recuerda que el $nombre_fichero  Es el nombre del fichero. Nos movemos en ruta respecto a la ubiciación del script que se está ejecutando. Podemos indicar también la ruta de forma absoluta como en el ejemplos segundo

Leer de un fichero
Una vez que hemos abierto un fichero podemos trabajar de dos formas, o bien leyendo su contenido, o bien escribiendo en él.

El modo en el que abramos el fichero deberá de ser dependiendo de la forma en la cual queremos trabajar con él. Una vez abierto en el modo adecuado vamos a proceder en este apartado, a leer de él. Si intentamos leer de un fichero que no está abierto en modo de lectura nos dará un error.

Para obtener el contenido o parte de él de un fichero debemos usar funciones de php. Entre las que vamos a usar para nuestro cometido serán de la lista siguente

Como hemos visto debemos usar la función file_get_contents retorna el contenido del fichero como un string.

Luego debemos mostrar este contenido respentando los caracteres especiales de html evitando que los interprete. Para ello usaremos la función htmlspecialchars Para dar un poco de sintaxis de color al código podemos usar la clase de css 'prettyprint''. Debemos descargar esta clase de internet, podemos referenciarlo el js que lo carga, como podemos ver en el código aportado


 * Vamos a hacer un ejercicio dónde si presionamos un botón mostramos el contenido del fichero
 * En la primera versión lo hacemos todo sencillo según hemos estudiado

Acceso a un directorio
En php tenemos diferentes formas de poder obtener este contenido, una de las más sencillas es usar la función scandir($dir), otra es crear un objeto de la clase Dir. Como aún no hemos visto objeto tomaremos la primera opción.
 * En realidad sería la forma que tengo de leer un directorio y acceder a todos los ficheros y directorios que tenemos.

Esta función nos retorna un array (conjunto de elementos ordenados) con los nombres de los ficheros y directorios del directorio que pasamos como argumento.

Podemos ver el contenido del array usando la función var_dump y vemos su contenido

Ejecutando este código vemos el siguiente listado, que sería el listado de ficheros y directorios que tengo actualmente en la carpeta especificada

Podemos usar alguna función como ver si un archivo es o no directorio. Para ello usaremos la función is_dir($nombre_fichero) que nos dirá si es o no directorio

Tened en cuenta que he de pasar el nombre del fichero, y si no está en el directorio actual, pasaré también su ubicación.

Por ejemplo si quisiera ver solo los directorios. Claro, ahora debemos de saber cómo recorrer un array. Lo veremos en el apartado correspondiente, pero adelantamos la estructura foreach. Esta estructura me permite recorrer un array accediendo a cada uno de sus elementos.Su sintaxis es

recorre el array $array,hasta que llegues al final en cada iteración, lee el elemento actual(el contenido y guárdalo en la variable $elemento en la siguiente iteración leerá el elementos siguiente así hasta que llegue al final
 * En este caso se debe de leer

?>
 * Veremos como salida




 * Seguimo profundizando en este ejemplo, imaginemos que solo queremos mostrar aquello ficheros que sean directorios. Para ello usaremos la función is_dir y además no mostrar el directorio actual . y el directorio del que vengo ..' (punto y punto punto respectivaemnte)

Para ello debemos ver si dentro de cada directorio existe un fichero llamado index.php. De ser así querremos mostrar ese directorio. Además querremos mostrarlo con una ancla &lta&gt , de modo que al presionar sobre ese texto se ejecute el fichero index de ese proyecto.
 * Podemos ver la salida
 * Para terminar supongamos que queremos tener una lista de nuestros proyectos. Por proyectos entendemos los directorios que tengamos en nuestro documentroot en cuyo contenido tengamos un index.php

Para este cometido nos falta la función que nos diga si un fichero existe o no. Esto lo podemos conseguir usando la función file_exists($dir), que nos devolverá un booleano con dicha información (si existe true, si no, false).


 * Podemos ver el resultado en la siguiente imagen

Escribir en un fichero
Esta función debe recibir obligatoriamente dos parámetros Por supuesto el fichero debe de estar abierto en modo de escritura, si no, no se podrá realizar la operación.
 * Ahora vamos a ver cómo escribir en un fichero. Para ello usaremos la función fwrite
 * $handle es una referencia al fichero abierto, el valor que retorno fopen
 * $string es la cadena que queremos escribir en el fichero
 * El valor entero que retorna será el número de bytes escritos

Es muy típico en nuestros proyectos que llevemos un log, anotando lo que se va escribiendo. Vamos a anotar la hora y un texto cualquiera
 * Vamos a hacer un ejemplo que genere un fichero llamado log.txt que contenga información de acciones
 * En esta caso cada vez que ejecutemos el script perderemos el contenido que tuviéramos en el fichero
 * Si queremos conservarlo debemos abrir en el modo añadir
 * Si ejecutamos el fichero cada vez que escribimos, escribimos 53 bytes. Después de ejecutarlo 20 veces se borra el fichero


 * Copiar/mover un fichero
 * Puede ser que en un momento dado queramos copiar un fichero


 * Para ello, usaremos el método rename, que lo que hace es mover un fichero