(PHP 4, PHP 5, PHP 7, PHP 8)
touch — ファイルの最終アクセス時刻および最終更新日をセットする
$filename, ?int $mtime = null, ?int $atime = null): bool
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 'ファイルの作成に成功しました';
}
?>
注意:
時刻の精度は、 ファイルシステムによって異なることがあります。