Função touch

A função touch permite alterar o tempo do último acesso e modificação de um arquivo. Se o arquivo especificado não existir, o touch pode criá-lo (por padrão). O tempo pode ser especificado explicitamente ou o atual pode ser usado.

Sintaxe

phptouch(string $filename, int $time = null, int $atime = null): bool

Exemplo

Criando um novo arquivo com o tempo atual:

php<?php
  $file = 'newfile.txt';
  
  if (touch($file)) {
    echo "Arquivo $file criado";
  }
?>

Resultado da execução do código:

php"Arquivo newfile.txt criado"

Exemplo

Alterando o tempo de um arquivo existente:

php<?php
  $file = 'existing.txt';
  $time = strtotime('2023-01-01 12:00:00');
  if (touch($file, $time)) {
    echo "Tempo do arquivo $file alterado";
  }
?>

Resultado da execução do código:

php"Tempo do arquivo existing.txt alterado"

Exemplo

Alterando o tempo de acesso e modificação separadamente:

php<?php
  $file = 'test.txt';
  $mtime = strtotime('2023-01-01 12:00:00');
  $atime = strtotime('2023-01-02 12:00:00');
  
  if (touch($file, $mtime, $atime)) {
    echo "Carimbos de tempo do arquivo atualizados";
  }
?>

Veja também

  • a função filemtime,
    que retorna o tempo da última modificação do arquivo
  • a função fileatime,
    que retorna o tempo do último acesso ao arquivo
  • a função fopen,
    que abre um arquivo ou URL