touch

(PHP 4, PHP 5, PHP 7, PHP 8)

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

説明

touch(string $filename, ?int $mtime = null, ?int $atime = null): bool

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

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

パラメータ

filename

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

mtime

設定する時刻。 mtimenull の場合は、 現在時刻 (time()) を使用します。

atime

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

戻り値

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

変更履歴

バージョン 説明
8.0.0 mtimeatime は、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 
'ファイルの作成に成功しました';
}
?>

注意

注意:

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

関連キーワード:  時刻, 最終, アクセス, セット, 更新, mtime, ファイル, atime, 注意, パラメータ