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

説明

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

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

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

パラメータ

filename: 処理したいファイルの名前。
time: 設定する時刻。 time を省略した場合は、現在時刻を使用します。
atime: 指定されたファイルの最終アクセス時刻が存在する場合は、その値が atime にセットされます。存在しない場合は time に渡した値となります。どちらも存在しない場合は、現在のシステム時刻を使います。

返り値

成功した場合に 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;
}
?>

例2 touch() で time パラメータを使用する例


<?php
// 作成時刻を、ここでは 1 時間前に設定します
$time = time() - 3600;

// ファイルを作成します
if (!touch('some_file.txt', $time)) {
    echo 'おっと、何かがおかしいようです...';
} else {
    echo 'ファイルの作成に成功しました';
}
?>

注意

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

警告

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