PHP
Referenzliste
touch
Dateisystem-Funktionen
Befehl:
bool touch ( string $filename [, int $time = time() [, int $atime ]] )
Parameter-Liste:
| Beschreibung | |
|---|---|
| Der Name der Datei, die berührt. | |
Die Touch-Zeit. Wenn time nicht angegeben wird, wird die aktuelle Systemzeit verwendet. | |
Falls vorhanden, die Zugriffszeit der angegebenen Datei auf den Wert der atime gesetzt ist. Andernfalls wird sie auf den Wert, der time-Parameter übergeben gesetzt. Wenn keiner vorhanden sind, wird die aktuelle Systemzeit verwendet. |
Rückgabewerte:
Gibt bei Erfolg
TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Beschreibung:
Mit touch() kann man versuchen, Datum und Uhrzeit der letzten Änderung einer Datei (filename) zu ändern. Wird der optionale Zeit-Parameter (time) im UNIX-Timestamp-Format (Beginn der UNIX-Epoche - 01.01.1970 , 0:00:00 GMT) angegeben, so wird dieses Datum für die Änderung genutzt.
Sollten Sie keinen Wert für die Zeit (time) angeben, so wird mit der Funktion time() die aktuelle Zeit ermittelt und für die Änderung genommen.
Falls die von Ihnen angegebene Datei nicht existieren sollte, so wird sie angelegt und mit dem Änderungsdatum versehen.
Im Erfolgsfall gibt diese Funktion true, sonst false zurück.
Sollten Sie keinen Wert für die Zeit (time) angeben, so wird mit der Funktion time() die aktuelle Zeit ermittelt und für die Änderung genommen.
Falls die von Ihnen angegebene Datei nicht existieren sollte, so wird sie angelegt und mit dem Änderungsdatum versehen.
Im Erfolgsfall gibt diese Funktion true, sonst false zurück.
Aktiv in Version:
(PHP 4, PHP 5, PHP 7)
Hinweis:
Hinweis:
Beachten Sie, dass Zeitauflösung kann von einem Dateisystem zum anderen.
Warnung:
Warnung:
Vor PHP 5.3.0 war es nicht möglich, den Zeitpunkt der letzten Änderung eines Verzeichnisses mit dieser Funktion unter Windows ändern.
touch() - Beispiel:
Eingabe:
<?php
if (touch($filename)) {
echo $filename . '-Modifikationszeit wurde auf die aktuelle Zeit gesetzt.';
} else {
echo 'Entschuldigung, die Änderung der Modifikationszeit von ' . $filename
' war nicht möglich.';
}
?>
Beschreibung:
Beachten Sie, dass die zeitliche Aufl�sung bei verschiedenen Dateisystemen unterschiedlich sein kann.
Beschreibung:
| Beschreibung | |
|---|---|
| 5.3.0 | Es wurde möglich, die Änderung der Zeit ein Verzeichnis unter Windows ändern. |
touch() - Beispiel 2: Nutzung von touch() mit dem time-Parameter
Eingabe:
<?php
// Modifikationszeit (eine Stunde in der Vergangenheit)
$time = time() - 3600;
// Ändern der Datei
if (!touch('eine_datei.txt', $time)) {
echo 'Ein Fehler ist aufgetreten ...';
} else {
echo 'Änderung der Modifikationszeit war erfolgreich';
}
?>
Beschreibung:
| Beschreibung | |
|---|---|
| 5.3.0 | Es wurde möglich, die Änderung der Zeit ein Verzeichnis unter Windows ändern. |
touch() - Beispiel 3:
Eingabe:
<?PHP
$date = mktime ( 12, 35, 32, 12, 30, 2008 ); //30.12.2008 - 12:35:32 Uhr
$datei = 'zukunft.php';
if ( touch ( $datei, $date ) )
{
echo 'Datum und Uhrzeit auf ' . strftime ( '%e.%m.%Y - %R', $date ) . ' geändert';
}
else
{
echo 'Datum und Uhrzeit konnten nicht geändert werden.';
}
?>
Ausgabe:
Datum und Uhrzeit auf 30.12.2008 - 12:35 ge�ndert
Beschreibung:
| Beschreibung | |
|---|---|
| 5.3.0 | Es wurde möglich, die Änderung der Zeit ein Verzeichnis unter Windows ändern. |
touch() - Beispiel 4:
Eingabe:
<?PHP
$date = mktime ( 8, 0, 0, 9, 1, 2008 ); //01.09.2008 - 08:00:00 Uhr
$datei = 'zukunft.php';
if ( touch ( $datei, $date ) )
{
echo 'Datum und Uhrzeit auf ' . strftime ( '%e.%m.%Y - %R', $date ) . ' geändert';
}
else
{
echo 'Datum und Uhrzeit konnten nicht geändert werden.';
}
?>
Ausgabe:
Datum und Uhrzeit auf 1.09.2008 - 08:00 ge�ndert
Beschreibung:
| Beschreibung | |
|---|---|
| 5.3.0 | Es wurde möglich, die Änderung der Zeit ein Verzeichnis unter Windows ändern. |
Dateisystem-Funktionen