touch

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

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

Descripción

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

Devuelve true en caso de éxito o false en caso de 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:

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