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