Função PHP file_put_contents()
❮ Referência do sistema de arquivos PHPExemplo
Gravar dados em um arquivo:
<?php
echo file_put_contents("test.txt","Hello World. Testing!");
?>
A saída do código acima será:
21
Definição e uso
O file_put_contents() grava dados em um arquivo.
Esta função segue estas regras ao acessar um arquivo:
- Se FILE_USE_INCLUDE_PATH estiver definido, verifique o caminho de inclusão para uma cópia do nome do arquivo
- Crie o arquivo se ele não existir
- Abra o arquivo
- Bloqueie o arquivo se LOCK_EX estiver definido
- Se FILE_APPEND estiver definido, mova para o final do arquivo. Caso contrário, limpe o conteúdo do arquivo
- Escreva os dados no arquivo
- Feche o arquivo e libere todos os bloqueios
Nota: Use FILE_APPEND para evitar excluir o conteúdo existente do arquivo.
Sintaxe
file_put_contents(filename, data, mode, context)
Valores de parâmetro
Parameter | Description |
---|---|
filename | Required. Specifies the path to the file to write to. If the file does not exist, this function will create one |
data | Required. The data to write to the file. Can be a string, array, or a data stream |
mode | Optional. Specifies how to open/write to the file. Possible values:
|
context | Optional. Specifies the context of the file handle. Context is a set of options that can modify the behavior of a stream. |
Detalhes técnicos
Valor de retorno: | O número de bytes gravados no arquivo em caso de sucesso, FALSE em caso de falha |
---|---|
Versão do PHP: | 5.0+ |
Binário Seguro: | sim |
Registro de alterações do PHP: | PHP 5.1 - Adicionado suporte para LOCK_EX e a capacidade de passar um recurso de fluxo para o parâmetro de dados |
❮ Referência do sistema de arquivos PHP