fwrite

fwrite

Escribe en un fichero en modo binario

Descripción#

fwrite(resource $stream, string $data, [int $length]): int
```php

`fwrite` escribe el contenido de la cadena `data` en el fichero apuntado por `stream`.

## Parámetros

`stream`  
Un puntero al sistema de ficheros de tipo `resource` que típicamente se crea utilizando `fopen`.

`data`  
La cadena a escribir.

`length`  
Si se proporciona la longitud `length`, la escritura se detendrá después de `length` bytes, o al final de la cadena (lo que ocurra primero).

## Valores devueltos

`fwrite` devuelve el número de bytes escritos o `false` si ocurre un error.

## Errores/Excepciones

La función `fwrite` emite una `E_WARNING` si ocurre un error.

## Historial de cambios

| Versión | Descripción                 |
|---------|-----------------------------|
| 8.0.0   | `length` ahora es nullable. |

## Ejemplos

Ejemplo con `fwrite`

```php

Notas#

[!NOTE] La escritura en un flujo puede terminar antes de que la cadena completa sea escrita. El valor devuelto por la función fwrite puede ser verificado de la siguiente manera:

```

```

[!NOTE] En los sistemas que hacen la distinción entre ficheros binarios y ficheros de texto (por ejemplo, Windows), el fichero debe ser abierto con la opción 'b' incluida en el parámetro de modo de fopen.

[!NOTE] Si stream está abierto en modo añadir (append), fwrite será atómico (excepto si el tamaño de data excede el tamaño del bloque del sistema de ficheros, en algunas plataformas, y siempre que el fichero se encuentre en el sistema de ficheros local). Por lo tanto, no es necesario utilizar la función flock en un recurso antes de llamar a la función fwrite; todos los datos serán escritos sin interrupción.

[!NOTE] Si se escribe dos veces en el fichero, los datos serán añadidos al final del fichero; esto significa que el siguiente ejemplo no dará el resultado esperado:

``` <?php $fp = fopen('data.txt', 'w'); fwrite($fp, '1'); fwrite($fp, '23'); fclose($fp);

// el contenido de 'data.txt' es ahora 123 y no 23 ! ?>

```

Véase también#

fread, fopen, fsockopen, popen, file_get_contents, pack