touch

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

    touch — Modifie la date de modification et de dernier accès d'un fichier

    Description

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

    Tente de forcer la date de modification du fichier désigné par le paramètre filename à la date spécifiée par le paramètre mtime. Notez bien que la date de dernier accès est modifiée, quel que soit le nombre de paramètres.

    Si le fichier n'existe pas, PHP tentera de le créer.

    Liste de paramètres

    filename

    Le nom du fichier à créer.

    mtime

    La date de création. Si mtime est omis, c'est l'heure courante time() qui est utilisée.

    atime

    Si non null, l'heure d'accès au fichier fourni sera défini à la valeur du paramètre atime. Sinon, elle sera définie à la valeur passée au paramètre mtime. Si tous les deux sont null, l'heure courante du système sera utilisée.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Historique

    VersionDescription
    8.0.0mtime et atime sont désormais nullable.

    Exemples

    Exemple #1 Exemple avec touch()

    <?php
    if (touch($FileName)) {
    echo     "La date de modification de $FileName a été modifiée à la date courante";
    } else {
    echo     "Désolé, il est impossible de changer la date de modification de $FileName";
    }
    ?>

    Exemple #2 Exemple avec touch() en utilisant le paramètre mtime

    <?php

    $time = time() - 3600;


    if (!touch('some_file.txt', $time)) {
    echo     'Whoops, une erreur est survenue...';
    } else {
    echo     'L\'appel à la fonction touch() a réussi';
    }
    ?>

    Notes

    Note:

    Notez que la précision temporelle peut varier selon le système de fichiers utilisé.

    To Top