file_put_contents

(PHP 5)

file_put_contents -- Escribir una cadena sobre un archivo

Descripción

int file_put_contents ( string nombre_archivo, mixed datos [, int banderas [, resource contexto]] )

Idéntico a llamar fopen(), fwrite(), y fclose() sucesivamente.

También es posible especificar el parámetro datos como una matriz (matrices que no sean multi-dimensionales). Esto es equivalente a file_put_contents($nombre_archive, join('', $matriz)).

A partir de PHP 5.1.0, también es posible pasar un recurso de secuencia al parámetro datos. El resultado es que el resto del búfer de esa secuencia será copiado al archivo especificado. Esto es similar al uso de stream_copy_to_stream().

Lista de parámetros

nombre_archivo

El nombre del archivo en donde escribir los datos

datos

Los datos a escribir. Puede ser un valor tipo string, array o un recurso stream (explicado anteriormente).

banderas

banderas puede recibir FILE_USE_INCLUDE_PATH, FILE_APPEND y/o LOCK_EX (adquirir un bloqueo exclusivo), sin embargo la opción FILE_USE_INCLUDE_PATH debe ser usada con precaución.

contexto

Un recurso de contexto

Valores retornados

La función devuelve la cantidad de bytes escritos al archivo.

Registro de cambios

VersiónDescripción
5.1.0 Se agregó soporte para LOCK_EX y la habilidad de pasar un recurso de secuencia al parámetro datos

Notes

Nota: Esta función es segura binariamente.

Nota: Soporte de contexto fue introducido con PHP.5.0.0.

Sugerencia: Puede usar una URL como nombre de archivo con esta función si los fopen wrappers han sido activados. Consulte fopen() para más detalles sobre cómo especificar el nombre de fichero y Apéndice M una lista de protocolos URL soportados

Ver también

fopen()
fwrite()
file_get_contents()

Hosting by: hurra.com
Generated: 2007-01-26 18:00:42