Ustawia czas modyfikacji pliku

Opis

bool touch ( string $nazwa_pliku [, int $czas = time() [, int $dczas ]] )

Próbuje ustawić czas dostępu i modyfikacji pliku o nazwie nazwa_pliku na wartość podaną przez czas. Zauważ, że czas dostępu jest zawsze modyfikowany, niezależnie od ilości parametrów.

Jeśli plik nie istnieje, to zostanie utworzony.

Parametry

nazwa_pliku: Nazwa pliku, który ma być zmodyfikowany.
czas: Czas modyfikacji. Jeśli czas nie został podany, zostanie użyty bieżący czas systemowy.
dczas: Jeśli podano, to czas dostępu do podanego pliku zostanie ustawiony na wartość dczas. W przeciwnym wypadku zostanie ustawiony na wartość przekazaną w parametrze time. Jeśli, żaden nie występuje, zostanie użyty bieżący czas.

Zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

Rejestr zmian

Wersja	Opis
5.3.0	Możliwa jest zmiana czasu modyfikacji katalogu pod Windows.

Przykłady

Przykład #1 touch() przykład


<?php
if (touch($filename)) {
    echo $filename . ' czas modyfikacji został zmieniony na bieżący czas';
} else {
    echo 'Przykro mi ale Nie Mogę zmienić czasu modyfikacji pliku ' . $filename;
}
?>

Przykład #2 touch() użycie parametru czas


<?php
// To jest czas modyfikacji, ustawimy go na jedną godzinę wstecz.
$time = time() - 3600;

// Modyfikujemy czas pliku
if (!touch('jakis_plik.txt', $time)) {
    echo 'Coś się nie udało...';
} else {
    echo 'Czas modyfikacji pliku ustawiony';
}
?>

Notatki

Informacja:
Proszę zauważyć, że informacja o czasie dostępu może się różnić w zależności od systemu plików.

Ostrzeżenie

Przed wersją PHP 5.3.0 nie istniała mozliwość zmiany czasu modyfikacji katalogu za pomocą tej funkcji pod systemem Windows.