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ãoDescriçã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()