Modifica la fecha de modificación y de último acceso de un fichero

# touch

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

touch — Modifica la fecha de modificación y de último acceso de un fichero

### Descripción

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

Intenta forzar la fecha de modificación del fichero designado por el parámetro `filename` a la fecha especificada por el parámetro `mtime`. Tenga en cuenta que la fecha de último acceso se modifica, independientemente del número de argumentos.

Si el fichero no existe, PHP intentará crearlo.

### Parámetros

`filename`

  El nombre del fichero a crear.

`mtime`

  La fecha de creación. Si `mtime` es omitido, se utiliza la hora actual time().

`atime`

  Si no es `null`, la hora de acceso al fichero proporcionado se establecerá a la valor del parámetro `atime`. De lo contrario, se establecerá a la valor pasada al parámetro `mtime`. Si ambos son `null`, se utilizará la hora actual del sistema.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `mtime` y `atime` ahora son nullable.

### Ejemplos

Ejemplo #1 Ejemplo con touch()

    <?php
    if (touch($FileName)) {
        echo "La fecha de modificación de $FileName ha sido modificada a la fecha actual";
    } else {
        echo "Lo sentimos, no es posible cambiar la fecha de modificación de $FileName";
    }
    ?>

Ejemplo #2 Ejemplo con touch() utilizando el parámetro `mtime`

    <?php
    /*
     * Esta es la fecha y hora del último acceso, le añadimos 1 hora
     * en el pasado.
     */
    $time = time() - 3600;

    /* ¡Toquemos el fichero! */
    if (!touch('some_file.txt', $time)) {
        echo '¡Ups, ha ocurrido un error...';
    } else {
        echo 'La llamada a la función touch() ha tenido éxito';
    }
    ?>

### Notas

> Nota: Tenga en cuenta que la precisión temporal puede variar según el sistema de archivos utilizado.

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