English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Tutorial Básico PHP

Tutorial Avançado PHP

PHP & MySQL

Manual de Referência PHP

Uso e exemplo da função PHP file_put_contents()

PHP Filesystem Referência

A função file_put_contents() pode escrever uma string no arquivo.

Sintaxe

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ] ] )

Quando o arquivo é acessado pela função, ele segue as seguintes regras:

  1. Se FILE_USE_INCLUDE_PATH foi configurado, será verificado *filename* Caminho interno do arquivo de cópia

  2. Se o arquivo não existir, um arquivo será criado

  3. Abrir arquivo

  4. Se LOCK_EX foi configurado, o arquivo será bloqueado

  5. Se FILE_APPEND foi configurado, o cursor será movido para o final do arquivo. Caso contrário, o conteúdo do arquivo será limpo

  6. Escrever dados no arquivo

  7. Fechar o arquivo e desbloquear todos os arquivos

Se sucesso, a função pode retornar o número de caracteres escritos no arquivo. Se falhar, pode retornar false.

Parâmetros

ParâmetrosDescrição
fileObrigatório. Especificar o arquivo onde os dados serão escritos. Se o arquivo não existir, um novo arquivo será criado.
dataObrigatório. Especificar os dados a serem escritos no arquivo. Pode ser uma string, um array ou um fluxo de dados.
modeOpcional. Especificar como abrir/Escrever no arquivo. Valores possíveis:
  • FILE_USE_INCLUDE_PATH

  • FILE_APPEND

  • LOCK_EX

contextOpcional. Especificar o ambiente do handle de arquivo. Contexto é um conjunto de opções que podem modificar o comportamento do fluxo.

Exemplo1

Escrever conteúdo no arquivo sample.txt

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

Resultados de saída

11

Exemplo2

Use FILE_APPEND para adicionar conteúdo, evitando que o conteúdo existente no arquivo seja apagado.

<?php
   $file = "sample.txt";
   //Novo usuário a ser adicionado ao arquivo
   $test = " w3codebox";
   //Use o sinal FILE_APPEND para adicionar conteúdo ao final do arquivo
   //e o sinal LOCK_EX, para evitar que outra pessoa escreva no arquivo ao mesmo tempo
   file_put_contents($file, $test, FILE_APPEND | LOCK_EX);
   echo "O conteúdo foi adicionado com sucesso ao arquivo.";
?>

Resultados de saída

O conteúdo foi adicionado com sucesso ao arquivo.

PHP Filesystem Referência