PHP | función file_put_contents()

La función file_put_contents() en PHP es una función incorporada que se usa para escribir una string en un archivo. La función file_put_contents() busca el archivo en el que el usuario desea escribir y, si el archivo no existe, crea un archivo nuevo.

La ruta del archivo en el que el usuario quiere escribir y los datos que deben escribirse se envían como parámetros a la función y devuelve la cantidad de bytes que se escribieron en el archivo en caso de éxito y FALSO en caso de falla.

Sintaxis:

file_put_contents($file, $data, $mode, $context)

Parámetros: La función file_put_contents() en PHP acepta dos parámetros obligatorios y dos parámetros opcionales.

1. $archivo : especifica el archivo en el que desea escribir.
2. $datos : especifica los datos que se deben escribir en el archivo. Puede ser una string, una array o un flujo de datos.
3. $context : es un parámetro opcional que se usa para especificar un contexto personalizado o el comportamiento de la transmisión.
4. $mode : es un parámetro opcional que se usa para especificar cómo se deben escribir los datos en el archivo, como FILE_USE_INCLUDE_PATH, FILE_APPEND, LOCK_EX.

Valor devuelto: Devuelve el número de bytes que se escribieron en el archivo en caso de éxito y FALSO en caso de error.

Errores y excepciones :

1. La función file_put_contents() devuelve FALSO booleano, pero también puede devolver un valor no booleano que se evalúa como FALSO.
2. Esta función no puede escribir contenidos si el directorio proporcionado no es válido.

Ejemplos:

Input : file_put_contents("gfg.txt", "A computer 
                     science portal for geeks!");
Output : 36

Input : $file_pointer = 'gfg.txt';
        $open = file_get_contents($file_pointer);
        $open .= "A computer science portal for geeks!";
        file_put_contents($file_pointer, $open);
Output : 36

Los siguientes programas ilustran la función file_put_contents().

Programa 1 :

<?php
  
// writing content on gfg.txt
echo file_put_contents("gfg.txt", "A computer 
                  science portal for geeks!");
?>

Producción:

36

Programa 2 :

<?php
  
$file_pointer = 'gfg.txt';
  
// Open the file to get existing content
$open = file_get_contents($file_pointer);
  
// Append a new person to the file
$open .= "A computer science portal for geeks!";
  
// Write the contents back to the file
file_put_contents($file_pointer, $open);
  
?>

Producción:

36

Referencia:
http://php.net/manual/en/function.file-put-contents.php