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

# touch

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

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

### Description

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open