touch

    (PHP 4, PHP 5, PHP 7, PHP 8)

    touch — Define horário de acesso e de modificação de arquivo

    Descrição

    touch(string$filename, ?int$mtime = null, ?int$atime = null): bool

    Tenta mudar os horários de acesso e modificação do arquivo no parâmetro filename para o valor informado em mtime. Note que o horário de acesso é sempre modificado, independente do número de parâmetros.

    Se o arquivo não existe, ele será criado.

    Parâmetros

    filename

    O nome do arquivo a ser atualizado.

    mtime

    Horário da atualização. Se mtime for null, o horário atual do sistema (time()) é usado.

    atime

    Se não null, o horário de acesso do arquivo é definido para o valor de atime. Caso contrário, é definido para o valor passado ao parâmetro mtime. Se ambos forem null, o horário atual do sistema é usado.

    Valor Retornado

    Retorna true em caso de sucesso ou false em caso de falha.

    Registro de Alterações

    VersãoDescrição
    8.0.0mtime e atime agora podem ser nulos.

    Exemplos

    Exemplo #1 Exemplo da função touch()

    <?php
    if (touch ($nomedoarquivo)) {
    echo     'O horário de ' . $nomedoarquivo . ' foi modificado para o horário atual';
    } else {
    echo     'Desculpe, não foi possivel modificar o horário de ' . $nomedoarquivo;
    }
    ?>

    Exemplo #2 touch() usando o parâmetro mtime

    <?php
    // Este é o horário de modificação, vamos defini-lo para uma hora no passado.
    $hora = time() - 3600;

    // Toca o arquivo
    if (!touch('algum_arquivo.txt', $hora)) {
    echo     'Opa, algo deu errado...';
    } else {
    echo     'Horário modificado com sucesso';
    }
    ?>

    Notas

    Nota:

    Note que a resolução de tempo pode variar de um sistema de arquivos para outro.

    To Top