Php/docs/function.touch

提供:Dev Guides
< Php
移動先:案内検索

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 環境のもとでは この関数によってディレクトリの最終更新日を変更することはできませんでした。