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

説明

bool touch(string $filename, intnull $mtime = null, intnull $atime = null)

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

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

パラメータ

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

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン	説明
8.0.0	`mtime` と `atime` は、nullable になりました。

例

例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 で mtime パラメータを使用する例

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

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

注意

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