touch
(PHP 4, PHP 5, PHP 7)
touch — ファイルの最終アクセス時刻および最終更新日をセットする
説明
bool touch
( string
$filename
[, int $time = time()
[, int $atime
]] )
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 環境のもとでは この関数によってディレクトリの最終更新日を変更することはできませんでした。
忘却曲線を使ってこの関数を確実に記憶に残す
