# 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

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