file_put_contents

file_put_contents(string $filename, mixed $data, [int $flags], [resource $context]): int
```php

Equivale a llamar a las funciones `fopen`, `fwrite` y `fclose` sucesivamente.

Si el fichero `filename` no existe, será creado. De lo contrario, el fichero existente será sobrescrito, a menos que la opción `FILE_APPEND` esté definida.

## Parámetros

`filename`  
Ruta de acceso al fichero en el que se deben escribir los datos.

`data`  
Los datos a escribir. Puede ser un string, un array o un recurso de flujo (explicación más abajo).

Si `data` es un recurso de tipo `stream`, el buffer restante de este flujo será copiado al fichero especificado. Esto equivale a utilizar la función `stream_copy_to_stream`.

Asimismo, puede especificarse el argumento `data` como un array de una sola dimensión. Esto equivale a `file_put_contents($filename, implode('', $array))`.

`flags`  
El valor del argumento `flags` puede ser cualquier combinación de los siguientes flags, unidos por el operador OR binario (`|`).

| Flag | Descripción |
|----|----|
| `FILE_USE_INCLUDE_PATH` | Busca el fichero `filename` en el directorio de inclusión. Ver [include_path](#ini.include-path) para más información. |
| `FILE_APPEND` | Si el fichero `filename` ya existe, esta opción permite añadir los datos al fichero en lugar de sobrescribirlo. |
| `LOCK_EX` | Adquiere un bloqueo exclusivo sobre el fichero durante la operación de escritura. En otras palabras, se realiza una llamada a la función `flock` entre la llamada a la función `fopen` y la llamada a la función `fwrite`. Este comportamiento no es idéntico a una llamada a la función `fopen` con el modo "x". |

Flags disponibles

`context`  
Un recurso de contexto válido creado con la función `stream_context_create`.

## Valores devueltos

Devuelve el número de bytes que han sido escritos al fichero, o `false` si ocurre un error.

> [!WARNING]
> Esta función puede retornar `false`, pero también puede retornar un valor equivalente a `false`. Por favor, lea la sección sobre los [booleanos](#language.types.boolean) para más información. Utilice el [operador ===](#language.operators.comparison) para probar el valor de retorno exacto de esta función.

## Ejemplos

Uso simple de file_put_contents

Uso de opciones para file_put_contents