touch

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

touchModifie 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

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é.