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. Il est à noter 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

Version	Description
8.0.0	`mtime` 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
/*
 * Ceci est la date et l'heure du dernier accès, nous y ajoutons 1 heure
 * dans le passé.
 */
$time = time() - 3600;

/* Touchons le fichier ! */
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é.