Manual do PHP
Anterior |  | Próxima

# file_put_contents

(PHP 5)

file_put_contents -- Escreve uma string para um arquivo

## Descrição

int file_put_contents ( string filename, mixed data [, int flags [, resource context]] )

Idêntico à chamar fopen(), fwrite(), e fclose() sucessivamente.

Você também pode especificar o parâmetro `data` como um array (não multi-dimensional). Isso é equivalente à `file_put_contents($filename, join('', $array))`.

A partir do PHP 5.1.0, você deve também passar o recurso de uma stream para o parâmetro `data`. Como resultado, o buffer remanescente daquele stream será copiado para o arquivo especificado. Isso é similar à usar stream_copy_to_stream().

## Parâmetros

`filename`

  O nome do arquivo onde escrever os dados

`data`

  Os dados a serem escritos; Pode ser uma string, um array ou um recurso stream (explicado acima).

`flags`

  `flags` pode receber `FILE_USE_INCLUDE_PATH`, `FILE_APPEND` e/ou `LOCK_EX` (adquire um lock exclusivo), no entanto, a opção `FILE_USE_INCLUDE_PATH` deve ser usada com cuidado.

`context`

  Um recurso de contexto

## Valores de retornado

A função retorna a quantidade de bytes que foi escrita no arquivo.

## Histórico

Versão | Descrição
--- | ---
5.1.0 | Adicionado o suporte para `LOCK_EX` e a habilidade para passar como parâmetro um recurso para stream `data`

## Notas

> Nota: Esta função é compatível com dados binários

> Nota: O suporte ao contexto foi adicionado com o PHP 5.0.0. Para uma descrição de `contentos`, veja Referência CLX, Stream Functions

> Dica: Você pode usar uma URL com esta função se fopen wrappers estiver habilitado. Veja fopen() para mais detalhes em como especificar o nome do arquivo e Apêndice N para uma lista de protocolos URL suportados.

## Veja também

fopen()
fwrite()
file_get_contents()

Anterior | Principal | Próxima
file_get_contents | Acima | file