Função file_put_contents() do PHP

Definição e Uso

A função file_put_contents() escreve uma string em um arquivo.

Funciona da mesma forma que chamar fopen(), fwrite() e fclose() uma após a outra.

Sintaxe

file_put_contents(file,data,mode,context)
Parâmetro Descrição
file Obrigatório. Define o arquivo onde os dados serão escritos. Se o arquivo não existir, será criado um novo arquivo.
data Opcional. Define os dados a serem escritos no arquivo. Pode ser uma string, um array ou um fluxo de dados.
mode

Opcional. Define como abrir/escrever o arquivo. Valores possíveis:

  • FILE_USE_INCLUDE_PATH
  • FILE_APPEND
  • LOCK_EX
context

Opcional. Define o ambiente do descritor de arquivo.

context É um conjunto de opções que podem modificar o comportamento do fluxo. Se usar null, será ignorado.

Descrição

Parâmetro data pode ser um array (mas não pode ser um array multidimensional).

Desde o PHP 5.1.0,data Os parâmetros também podem ser especificados como recursos de stream, onde os dados do cache armazenados no stream serão escritos no arquivo especificado, o que é semelhante ao uso da função stream_copy_to_stream().

para context O suporte para parâmetros foi adicionado no PHP 5.0.0.

Retorno

Esta função retornará o número de bytes de dados escritos no arquivo.

Dicas e Comentários

Dica:Usar FILE_APPEND pode evitar que o conteúdo existente no arquivo seja excluído.

Comentário:Esta função pode ser usada de forma segura para objetos binários.

Exemplo

<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>

Saída:

26