# touch

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

touch — Establece el momento de acceso y modificación de un archivo

### Descripción

touch(string `$filename`, int `$time` = time(), int `$atime` = ?): bool

Intenta establecer los momentos de acceso y modificación del archivo nombrado por el parámetro `filename` al valor dado en `time`. Observe que el momento de acceso se modifica siempre, sin importar el número de parámetros.

Si el archivo no existe, será creado.

### Parámetros

`filename`

  El nombre del archivo que va a ser afectado.

`time`

  El momento de afectación. Si `time` no es proporcionado, se usa la hora actual del sistema.

`atime`

  Si está presente, el momento de acceso del nombre de archivo dado se establece al valor de `atime`. De otro modo, se establece al valor pasado al parámetro `time`. Si ninguno está presente, se usa el momento actual del sistema.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
5.3.0 | Se hizo posible cambiar el momento de modificación de un directorio bajo Windows.

### Ejemplos

Ejemplo #1 Ejemplo de touch()

`<?php
if (touch($nombre_archivo)) {
echo 'El momento de modificación de ' . $nombre_archivo . ' ha sido cambiada a la hora actual';
} else {
echo 'Lo siento, no se pudo cambiar el momento de modificación de ' . $nombre_archivo;
}
?>`

Ejemplo #2 touch() usando el parámetro `time`

`<?php
// Este es el momento afectado, lo estableceremos a una hora antes
$momento = time() - 3600;
// Afectar el archivo
if(!touch('archivo.txt', $momento)) {
echo 'Lo sieno, algo fue mal...';
} else {
echo 'Archivo afectado con éxito';
}
?>`

### Notas

> Nota:

> Observe que el tiempo de resolución quizá varia según el sistema de ficheros.

Advertencia

Antes de PHP 5.3.0 no era posible cambiar el momento de modificación de un directorio con esta función bajo Windows.