(PHP 4, PHP 5, PHP 7, PHP 8)
touch — Modifica la fecha de modificación y de último acceso de un fichero
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.
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.
Versión | Descripción |
---|---|
8.0.0 |
mtime y atime
ahora son nullable.
|
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';
}
?>
Nota:
Observe que el tiempo de resolución quizá varia según el sistema de ficheros.