A função file_put_contents() grava uma string em um arquivo.
Quando esta função acessa arquivos, ela segue as seguintes regras:
Se FILE_USE_INCLUDE_PATH estiver definido, então o caminho interno para a cópia de *filename* será verificado
Se o arquivo não existir, um arquivo será criado
abrir arquivo
Se LOCK_EX estiver definido, o arquivo será bloqueado
Se FILE_APPEND estiver definido, ele será movido para o final do arquivo. Caso contrário, o conteúdo do arquivo será apagado
Gravar dados em arquivo
Feche os arquivos e desbloqueie todos os arquivos
Se for bem-sucedido, a função retornará o número de caracteres gravados no arquivo. Se falhar, False será retornado.
int file_put_contents (string $filename, misto $data [, int $flags = 0 [, recurso $context]])
parâmetro | descrever |
---|---|
arquivo | Obrigatório. Especifica o arquivo no qual os dados serão gravados. Se o arquivo não existir, um novo arquivo será criado. |
dados | Obrigatório. Especifica os dados a serem gravados no arquivo. Pode ser uma string, array ou fluxo de dados. |
modo | Opcional. Especifica como abrir/gravar o arquivo. Valores possíveis: FILE_USE_INCLUDE_PATH FILE_APPEND LOCK_EX |
contexto | Opcional. Especifica o ambiente para um identificador de arquivo. contexto é um conjunto de opções que podem modificar o comportamento do fluxo. |
NOTA: Use FILE_APPEND para evitar a exclusão de conteúdo que já existe no arquivo.
A saída de execução do exemplo acima é:
6
A seguir, anexamos conteúdo ao arquivo sites.txt:
Após a execução bem-sucedida, abra o arquivo sites.txt, o conteúdo é:
CoderctoGoogle