Función file_put_contents() de PHP

Definición y uso

La función file_put_contents() escribe una cadena en un archivo.

Funciona de la misma manera que llamar sucesivamente a fopen(), fwrite() y fclose().

Sintaxis

file_put_contents(file,data,mode,context)
Parámetros Descripción
file Obligatorio. Define el archivo en el que se escribirán los datos. Si el archivo no existe, se creará un nuevo archivo.
data Opcional. Define los datos que se escribirán en el archivo. Puede ser una cadena, un array o un flujo de datos.
mode

Opcional. Define cómo abrir/escribir el archivo. Los valores posibles son:

  • FILE_USE_INCLUDE_PATH
  • FILE_APPEND
  • LOCK_EX
context

Opcional. Define el entorno del descriptor de archivo.

context Es un conjunto de opciones que permite modificar el comportamiento del flujo. Si se usa null, se ignora.

Descripción

Parámetros data puede ser un array (pero no un array multidimensional).

Desde PHP 5.1.0,data Los parámetros también se pueden especificar como recursos de flujo, los datos de caché guardados en el flujo se escribirán en el archivo especificado, este uso es similar al uso de la función stream_copy_to_stream().

para context El soporte para parámetros se agregó en PHP 5.0.0.

Valor devuelto

Esta función regresará el número de bytes de datos escritos en el archivo.

Consejos y comentarios

Consejo:El uso de FILE_APPEND evita que se elimine el contenido existente en el archivo.

Comentarios:Esta función se puede usar de manera segura para objetos binarios.

Ejemplo

<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>

Salida:

26