(PHP 4, PHP 5)
touch — Establece el momento de acceso y modificación de un archivo
$filename
[, int $time = time()
[, int $atime
]] )
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.
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.
Devuelve TRUE en caso de éxito o FALSE en caso de error.
| Versión | Descripción |
|---|---|
| 5.3.0 | Se hizo posible cambiar el momento de modificación de un directorio bajo Windows. |
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';
}
?>
Nota:
Observe que el tiempo de resolución quizá varia según el sistema de ficheros.
Antes de PHP 5.3.0 no era posible cambiar el momento de modificación de un directorio con esta función bajo Windows.