Archivos (File) en PHP

En este tutorial, aprenderá a usar las funciones del sistema de archivos de PHP para crear dinámicamente, acceder (o leer) y manipular archivos.

Procesar archivos usando PHP

Dado que PHP es un lenguaje de programación del lado del servidor, le permite usar archivos y directorios almacenados en el servidor web. En este tutorial, aprenderá a usar las funciones del sistema de archivos de PHP en el servidor web para crear, acceder y operar con archivos.

Abrir archivos usando la función fopen() de PHP

Para usar archivos, primero debe abrir el archivo. La función fopen() de PHP se utiliza para abrir archivos. La sintaxis básica de esta función se puede presentar de la siguiente manera:

fopen(filename, mode)

El primer parámetro pasado a fopen() especifica el nombre del archivo que se debe abrir, y el segundo parámetro especifica en qué modo se debe abrir el archivo. Por ejemplo:

<?php
$handle = fopen("data.txt", "r");
?>

Puede abrir un archivo de la siguiente manera:

Si intenta abrir un archivo inexistente, PHP generará un mensaje de advertencia. Por lo tanto, para evitar estos mensajes de error, debe usar la función PHP file_exists() para realizar una simple verificación antes de intentar acceder a un archivo o directorio, para verificar si el archivo o directorio existe.

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//　Intente abrir este archivo
　　　　$handle = fopen($file, "r");
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

Uso de la función fclose() de PHP para cerrar archivos

Después de usar el archivo, debe cerrarlo. La función fclose() se utiliza para cerrar archivos, como se muestra en el siguiente ejemplo:

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Abrir el archivo a leer
　　　　$handle = fopen($file, "r") or die("ERROR: No se puede abrir el archivo.");
　　　　　　　　
　　　　/*　Aquí hay algunos códigos que se deben ejecutar　*/
　　　　　　　　
　　　　//Cerrando el puntero de archivo
　　　　fclose($handle);
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

Uso de la función fread() de PHP para leer archivos

Ahora que ya ha aprendido cómo abrir y cerrar archivos, en la próxima sección aprenderá cómo leer datos de un archivo. PHP tiene varias funciones para leer datos de archivos. Puede usar una sola operación para leer todo el archivo desde un carácter.

Lectura de un número fijo de caracteres

La función fread() se puede usar para leer un número específico de caracteres de un archivo. Puede usar la sintaxis básica de esta función.

fread(file handle, length in bytes)

Esta función acepta dos parámetros-El puntero de archivo y la cantidad de bytes a leer. El siguiente ejemplo lee desde el archivo "data.txt".20 bytes, incluyendo los espacios. Supongamos que el archivo "data.txt" contiene un texto "The quick brown fox jumps over the lazy dog.".

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Abrir el archivo a leer
　　　　$handle = fopen($file, "r") or die("ERROR: No se puede abrir el archivo.");
　　　　　　　　
　　　　//Leer una cantidad fija de bytes desde el archivo
　　　　$content = fread($handle, "20);
　　　　　　　　
　　　　//Cerrar el puntero del archivo
　　　　fclose($handle);
　　　　　　　　
　　　　//Mostrar el contenido del archivo
　　　　echo $content;
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

El ejemplo anterior producirá la siguiente salida:

The quick brown fox

Leer todo el contenido del archivo

La función fread() puede usarse junto con la función filesize() para leer todo el archivo de una vez. La función filesize() tiene la función de: devolver el tamaño del archivo en bytes.

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Abrir el archivo a leer
　　　　$handle = fopen($file, "r") or die("ERROR: No se puede abrir el archivo.");
　　　　　　　　
　　　　//Leiendo todo el archivo
　　　　$content = fread($handle, filesize($file));
　　　　　　　　
　　　　//Cerrando el puntero de archivo
　　　　fclose($handle);
　　　　　　　　
　　　　//Mostrar el contenido del archivo
　　　　echo $content;
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

El ejemplo anterior producirá la siguiente salida:

The quick brown fox jumps over the lazy dog.

La manera más sencilla de leer todo el contenido de un archivo en PHP es usar la función readfile(). Esta función permite leer el contenido del archivo sin necesidad de abrirlo. El siguiente ejemplo generará la misma salida que el anterior:

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Leer y mostrar todo el archivo
　　　　readfile($file) or die("ERROR: No se puede abrir el archivo.");
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

El ejemplo anterior producirá la siguiente salida:

The quick brown fox jumps over the lazy dog.

Otra manera de leer todo el contenido del archivo sin abrirlo es usar la función file_get_contents(). Esta función acepta el nombre y la ruta del archivo y lee todo el archivo en una variable de cadena. A continuación, se muestra un ejemplo:

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//　Leer todo el archivo en una cadena
　　　　$content = file_get_contents($file) or die("ERROR: No se puede abrir el archivo.");
　　　　　　　　
　　　　//Mostrar el contenido del archivo
　　　　echo $content;
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

Otra manera de leer todos los datos del archivo usando la función file() de PHP. Su funcionalidad es similar a la función file_get_content(), pero devuelve el contenido del archivo como un array de líneas, en lugar de como una única cadena. Cada elemento del array correspondiente a una línea en el archivo.

Para procesar los datos del archivo, necesita usarbucle foreachRecorrer el array. Este es un ejemplo que lee el archivo en un array y luego lo muestra con un bucle:

<?php
$file = "data.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Leer todo el archivo en un array
　　　　$arr = file($file) or die("ERROR: Cannot open the file.");
　　　　foreach($arr as $line){
　　　　　　　　echo $line;
　　　　}
} else {
　　　　echo "ERROR: File does not exist.";
}
?>

Escribir en el archivo usando la función fwrite() de PHP

Del mismo modo, puede usar la función fwrite() de PHP para escribir datos en un archivo o añadir a un archivo existente. La sintaxis básica de la función se puede expresar de la siguiente manera:

fwrite(puntero de archivo, cadena)

La función fwrite() acepta dos parámetros: el puntero de archivo y la cadena de datos que se escribirán, como se muestra en el siguiente ejemplo:

<?php
$file = "note.txt";
　　　　
//La cadena de datos a escribir
$data = "The quick brown fox jumps over the lazy dog.";
　　　　
//Abrir el archivo para escritura
$handle = fopen($file, "w") or die("ERROR: Cannot open the file.");
　　　　
//Escribir datos en el archivo
fwrite($handle, $data) or die("ERROR: Cannot write the file.");
　　　　
//Cerrar el puntero de archivo
fclose($handle);
　　　　
echo "Los datos se han escrito con éxito en el archivo.";
?>

En el ejemplo anterior, si el archivo "note.txt" no existe, PHP lo creará automáticamente y escribirá los datos. Sin embargo, si el archivo "note.txt" ya existe, PHP borrará el contenido del archivo (si hay alguno) antes de escribir nuevos datos, pero si solo desea añadir datos al archivo y mantener el contenido existente, utilice el ejemplo anterior.Modo a en lugar de w.

Otra forma es utilizar la función file_put_contents(). Es la función correspondiente a file_get_contents(), que ofrece una manera sencilla de escribir datos en un archivo sin necesidad de abrirlo. La función acepta el nombre y la ruta del archivo y los datos que se escribirán en el archivo. Aquí hay un ejemplo:

<?php
$file = "note.txt";
　　　　
//La cadena de datos a escribir
$data = "The quick brown fox jumps over the lazy dog.";
　　　　
//Escribir datos en el archivo
file_put_contents($file, $data) or die("ERROR: Cannot write the file.");
　　　　
echo "Los datos se han escrito con éxito en el archivo.";
?>

Si el archivo especificado en file_put_contents() ya existe, PHP lo sobrescribirá por defecto. Si desea mantener el contenido del archivo, puede pasar el marcador especial FILE_APPEND como tercer parámetro a la función file_put_contents(). Simplemente añadirá nuevos datos al archivo sin sobrescribirlo. Aquí hay un ejemplo:

<?php
$file = "note.txt";
　　　　
//La cadena de datos a escribir
$data = "The quick brown fox jumps over the lazy dog.";
　　　　
//Escribir datos en el archivo
file_put_contents($file, $data, FILE_APPEND) or die("ERROR: Cannot write the file.");
　　　　
echo "Los datos se han escrito con éxito en el archivo.";
?>

Renombrar archivos usando la función rename() de PHP

Puede usar la función rename() de PHP para renombrar archivos o directorios, como se muestra a continuación:

<?php
$file = "file.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Intentar renombrar el archivo
　　　　if(rename($file, "newfile.txt")){
　　　　　　　　echo "El archivo se ha renombrado con éxito.";
　　　　} else {
　　　　　　　　echo "Error: No se puede renombrar el archivo.";
　　　　}
} else {
　　　　echo "Error: El archivo no existe.";
}
?>

Eliminar archivos usando la función unlink() de PHP

Puede usar la función unlink() de PHP para eliminar archivos o directorios, como se muestra a continuación:

<?php
$file = "note.txt";
　
//Verificar si el archivo existe
if(file_exists($file)){
　　　　//Intentar eliminar el archivo
　　　　if(unlink($file)){
　　　　　　　　echo "El archivo se ha eliminado con éxito.";
　　　　} else {
　　　　　　　　echo "Error: No se puede eliminar el archivo.";
　　　　}
} else {
　　　　echo "Error: El archivo no existe.";
}
?>

En el siguiente capítulo, aprenderemos sobre el uso de PHPde directorio o carpetaMás información.

Funciones de sistema de archivos de PHP

La siguiente tabla resume algunas otras funciones útiles de sistema de archivos de PHP, que se pueden usar para leer y escribir archivos dinámicamente.

Por favor, consulte la referencia del sistema de archivos de PHP para obtener otras funciones útiles de sistema de archivos de PHP.