touch

(PHP 3, PHP 4, PHP 5)

touch -- ファイルの最終アクセス時刻および最終更新日をセットする

説明

bool touch ( string filename [, int time [, int atime]] )

filename で指定されたファイルの最終更新日を、 time で指定された値に セットしようと試みます。 パラメータ timeが指定されない場合、 現在時刻を使用します。 これは utime(しばしばutimesとも呼ばれる)によって行われることと等価です。 3 番目のパラメータが指定された場合、 指定されたファイルの最終アクセス時刻が atime にセットされます。パラメータの数にかかわらず、アクセス時刻は 常に変更されることに注意しましょう。

ファイルが存在しない場合、ファイルが生成されます。成功した場合に TRUE を、失敗した場合に FALSE を返します。

警告

現在は、Windows 環境のもとでは この関数によってディレクトリの最終更新日を変更することはできません。

例 1. touch() の例

<?php
if (touch($FileName)) {
    echo
"$FileName modification time has been changed to present time";
} else {
    echo
"Sorry, could not change modification time of $FileName";
}
?>