ファイルの最終アクセス時刻および最終更新日をセットする

# touch

(PHP 4, PHP 5, PHP 7, PHP 8)

touch — ファイルの最終アクセス時刻および最終更新日をセットする

### 説明

function touch(string `$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 'ファイルの作成に成功しました';
    }
    ?>

### 注意

> 注意: 時刻の精度は、 ファイルシステムによって異なることがあります。

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open