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.

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:

http://php.net/manual/es/book.filesystem.php

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.

Resource

http://php.net/manual/es/language.types.resource.php

fopen

resource $archivo = fopen(string $nombre_fichero, string $modo) Esta función retorna un descriptor de fichero (un objeto de tipo recurso stream) $nombre_fichero es el nombre (se puede incluir la ruta) de fichero que queremos abrir. $modo es el modo de apertura (lectura, creación, añadir )· Hay varios modos como podemos ver en la tabla de más abajo, si bien los podemos clasificar en tres grupos r => Lectura. Abre el fichero para leer, si no existe da un error w => Escritura (Trunca el contenido). Abre el fichero para escribir, Si no existe el fichero lo intenta crear, si existe se borrará su contenido a => append o añadir. Abre el fichero para añadir en él Si no existe el fichero lo intenta crear, si existe se pondrá el puntero al final des fichero para escribir (respetando lo que hubiera escrito).

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

bool fclose ( resource $handle )

Parar poder acceder a un fichero necesitamos tener una referencia a él (Tanto para escribir como para leer).

Temas de permisos de apache

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

• Lee atentamente el siguiente cuadro y asegúrate de tener claro cada punto, si no, pregunta.

Puntos fundamentales sobre permisos

1.- En linux todo fichero tiene un propietario, y también todo proceso. El propietario del proceso es el usuario que lazó dicho proceso. Cuando un proceso quiere hacer algo sobre un fichero, el usuario que lanzó el proceso, debe tener permisos sobre el fichero para hacerlo. El usuario que lanza apache es www-data Para hacer a un usuario propietario de un fichero o a su grupo usamos la sentencia sudo chown usuario:grupo fichero (-R) }} (: *-R parámetro opcional que actuaría de forma recursiva. En php un directorio es igual que un fichero cuyo contenido son los ficheros y directorios que contiene.) Para dar permisos sobre un fichero a un usuario usamos la sentencia sudo chmod permisos fichero (-R) }} (: permisos' es un número de tres dígitos en octal, ver tabla de abajo. fichero al cual le queremos dar permisos, se puede usar * para especificar todos. -R parámetro opcional que actuaría de forma recursiva. )

Número	Binario	Lectura (r)	Escritura (w)	Ejecución (x)
0	000
1	001
2	010
3	011
4	100
5	101
6	110
7	111

Por ejemplo:

chmod 766 file.txt   # brinda acceso total al dueño
                     # y lectura y escritura a los demás
chmod 770 file.txt   # brinda acceso total al dueño y al grupo
                     # y elimina todos los permisos a los demás usuarios
chmod 635 file.txt   # Permite lectura y escritura al dueño, 
                     # escritura y ejecución al grupo,
                     # y lectura y ejecución al resto

(: Recuerda que es el usuario apache el que ha de tener los permisos necesarios (leer(r),escribir (w), ejecutar (x))

Ejemplos

 //Ruta relativa al directorio donde se encuentra el proyecto
 $archivo = fopen('log.txt',$modo);
 //Ruta absoluta
 $archivo = fopen('/var/www/html/log.txt',$modo);

• 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

Parámetro	Acción	Descripción
r	Lee un fichero desde el principio.	Se abre el fichero sólo para leer. Sitúa el cursor al principio del archivo. Si el fichero no existe o no hay permisos de lectura retorno false.
r+	Abre el fichero para lectura y permite la escritura.	Abre el archivo para lectura y escritura. Sitúa el cursor o puntero al principio del archivo. Si el fichero no existe o no hay permisos de lectura retorno false.
w	Escribe un archivo y corta su contenido.	Abre el fichero sólo para escribir. Sitúa el puntero al principio y perdiéndose cualquier contenido que hubiera si existía y contenía datos. Si el archivo no existe, intenta crearlo, retornando false si no ha podido.
w+	Escribe un archivo desde el principio, corta su contenido, y permite la lectura.	Abre un archivo para lectura y escritura. Sitúa el puntero al principio dejando eliminando el contenido del archivo si hubiera algo. Si el archivo no existe, intenta crearlo.
a	Abre el fichero en modo añadir .	Abierto sólo en escritura. Sitúa el puntero al final del archivo. Si el archivo no existe, intenta crearlo.
a+	Abre el fichero en modo lectura y añadir .	Se abre el archivo para lectura y escritura. Sitúa el puntero al final del archivo. Si el archivo no existe, intenta crearlo.

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

funciones de lectura

fgetc() - Obtiene un carácter de un puntero a un archivo string fgetc ( resource $handle ) fgets() — Obtiene una línea desde el puntero a un fichero string fgets ( resource $handle [, int $length ] ) fgetss() - Obtiene un línea desde un puntero a un archivo y elimina las etiquetas HTML string fgetss ( resource $handle [, int $length [, string $allowable_tags ]] ) fread() - Lectura de un fichero en modo binario seguro string fread ( resource $handle , int $length ) Leemos de un fichero la longuitd en bytes que indique el segundo parámetro En este caso la lectura es en un fichero binario. file() — Transfiere un fichero completo a un array array file ( string $filename [, int $flags = 0 [, resource $context ]] ) Obtenemos en un array todo el contenido de un fichero El criterio para separar los campos es el salto de línea Tendremos tantos elementos como líneas tenga el fichero file_get_contents() — Transmite un fichero completo a una cadena string file_get_contents ( string $filename [, bool $use_include_path = FALSE [, resource $context [, int $offset = 0 [, int $maxlen ]]]] ) Como resultado tendré un string con todo el contenido del fichero Observa que en este caso, no necesitamos pasar el descriptor del fichero , sino su nombre (y ruta si no es relativo al proyecto)

Recursos de la Web

Lectura de ficheros https://diego.com.es/lectura-de-archivos-en-php

Actividad

Escribe un fichero de texto con 20 nombres llamado "nombres.txt" y léelo usando las funciones anteriores Cada vez que uses una nueva forma cierra y vuelve a abrir el fichero

Actividad

Haz un programa que muestre el contenido del fichero que estás ejecutando

usando la función file()

Crea un fichero con nombres sigen cada línea María Ruiz Mercedes Naranjo Manuel Romero Sara Rodríguez Jorge Martínez Eduarlo Laborda Nieves Rodera Usando file visualiza de cada nombre

• la función file_get_contents() retorna el contenido del fichero como un string.

echo "<div class='fichero'>";
echo "<h2>Fichero index.php </h2>";
echo "<pre class=\"prettyprint\">".htmlspecialchars($index)."</pre>";
echo "<hr />";
echo "</div> ";

• 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 seǵun hemos estudado

<?php
$index = null;
if ($_POST['submit']) {
 $index = file_get_contents("index.php");
}
?>
<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title></title>
    </head>
    <body>
        <fieldset>
            <legend>Presionar</legend>
 
            <form action="index.php" method ='POST'>
                <input type="submit" value="Ver contenido" name="submit">
            </form>
            <?php
            if (!is_null($index)
               echo htmlspecialchars($index));
            ?>
        </fieldset>
    </body>
</html>

• Vemos que el resultado no es muy agradable a la vista

Escribir en un fichero

fwrite($fichero, "texto para escribir");

Acceso a un directorio

<?php
 
 
$base = "/var/www/";
 
$dir = scandir($base);
 
var_dump($dir);
 
foreach ($dir as $directorio){
    if (is_dir("$base$directorio")){
        if ($directorio!="." && $directorio!=".."){
               $ficheros = scandir ($directorio);
               if (in_array("index.php", $ficheros)){
                   $txt .= "<h2><a href=$directorio/index.php>$directorio</a></h2>";
               }
        }
    }
}
 
 
 
?>
 
 
<!DOCTYPE html>
<!--
To change this license header, choose License Headers in Project Properties.
To change this template file, choose Tools | Templates
and open the template in the editor.
-->
<html>
    <head>
        <meta charset="UTF-8">
        <title></title>
    </head>
    <body>
        <?php
        echo $txt;
        ?>
    </body>
</html>