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:
|
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