無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

touch

(PHP 4, PHP 5)

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

説明

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

filename で指定されたファイルの最終更新日を、 time で指定された値に セットしようと試みます。 パラメータの数にかかわらず、アクセス時刻は 常に変更されることに注意しましょう。

ファイルが存在しない場合、ファイルが生成されます。

パラメータ

filename

処理したいファイルの名前。

time

設定する時刻。 time を省略した場合は、 現在時刻を使用します。

atime

指定されたファイルの最終アクセス時刻が atime にセットされます。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

変更履歴

バージョン 説明
5.3.0 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";
}
?>

注意

注意: 時刻の精度は、 ファイルシステムによって異なることがあります。

警告

PHP 5.3.0 より前のバージョンでは、Windows 環境のもとでは この関数によってディレクトリの最終更新日を変更することはできませんでした。