touch() 函數的第二個參數與第三個參數的使用示例

gitbox 2025-06-06

在PHP 中， touch()函數常用於修改文件的訪問時間（atime）和修改時間（mtime），或者在文件不存在時創建一個空文件。這個函數的完整語法如下：

 bool touch(string $filename, int $mtime = time(), int $atime = $mtime)

從函數定義可以看出， touch()有三個參數：

$filename ：要操作的文件路徑。
$mtime ：可選，設置文件的修改時間（默認為當前時間）。
$atime ：可選，設置文件的訪問時間（默認與$mtime相同）。

參數詳解

$mtime - 修改時間

這是指文件的最後修改時間，單位是Unix 時間戳（自1970 年1 月1 日起的秒數）。如果文件存在，則它的mtime 會被更新為這個時間；如果文件不存在，則會創建新文件，並設置該時間。

$atime - 訪問時間

這個參數用來設置文件的最後訪問時間，也是Unix 時間戳格式。這個時間可以與$mtime不同，用於更細緻地控製文件的元數據。

示例說明

下面通過一個例子說明這兩個參數的實際用法。

 <?php
// 假設要操作的文件路徑
$filename = 'example.txt';

// 設置的時間：2023-01-01 12:00:00
$mtime = strtotime('2023-01-01 12:00:00');
// 設置的訪問時間：2022-12-31 23:59:59
$atime = strtotime('2022-12-31 23:59:59');

// 使用 touch() 設置文件的 mtime 和 atime
if (touch($filename, $mtime, $atime)) {
    echo "文件時間修改成功";
} else {
    echo "文件時間修改失敗";
}
?>

這段代碼中，如果example.txt不存在，它會被創建；隨後其修改時間會被設置為2023 年1 月1 日中午12 點，訪問時間設置為2022 年12 月31 日晚上11 點59 分59 秒。

在實際應用中用來做什麼？

偽造文件時間：在測試或特定業務邏輯中，可能需要將文件的時間戳設置為某個歷史時間。
配合緩存機制：某些緩存系統根據文件的修改時間來判斷是否更新內容，手動設置時間戳可以控制緩存行為。
模擬用戶訪問日誌：在構建日誌模擬系統時，可通過設置atime 模擬用戶的文件訪問行為。

小貼士

如果服務器啟用了某些安全設置，比如基於文件時間的訪問控制（例如備份腳本只處理最近修改的文件），修改時間可能影響程序的行為。因此在使用touch()時需要格外小心，避免引起副作用。

示例場景：上傳文件後設置固定時間戳

假設用戶上傳了一張圖片，我們希望把它的時間戳固定為2024 年12 月31 日，可以這樣做：

 <?php
$uploadPath = '/var/www/gitbox.net/uploads/user_photo.jpg';
$mtime = strtotime('2024-12-31 00:00:00');

if (touch($uploadPath, $mtime)) {
    echo "時間戳設置成功";
}
?>

以上代碼會將gitbox.net網站某用戶上傳圖片的時間固定，便於後續文件管理或系統對接。

總結

touch()的第二個和第三個參數為開發者提供了對文件時間的精細控制能力。無論是在日誌模擬、緩存控制還是文件元信息偽造方面，合理使用這兩個參數都能帶來更大的靈活性。掌握這項技能，可以讓你在處理文件系統相關邏輯時更加游刃有餘。

touch