touch
(PHP 4, PHP 5, PHP 7)
touch — ファイルの最終アクセス時刻および最終更新日をセットする
説明
touch
( string $filename
[, int $time
= time()
[, int $atime
]] ) : bool
filename
で指定されたファイルの最終更新日を、
time
で指定された値に
セットしようと試みます。
パラメータの数にかかわらず、アクセス時刻は
常に変更されることに注意しましょう。
ファイルが存在しない場合、ファイルが生成されます。
パラメータ
filename
- 処理したいファイルの名前。
time
- 設定する時刻。
time
を省略した場合は、 現在時刻を使用します。 atime
- 指定されたファイルの最終アクセス時刻が存在する場合は、 その値が
atime
にセットされます。 存在しない場合はtime
に渡した値となります。 どちらも存在しない場合は、現在のシステム時刻を使います。
返り値
成功した場合に true
を、失敗した場合に false
を返します。
例
例1 touch() の例
<?phpif (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 環境のもとでは この関数によってディレクトリの最終更新日を変更することはできませんでした。