怎樣避免使用touch() 函數時意外創建空文件？有哪些實用技巧？

gitbox 2025-08-16

在PHP開發過程中， touch()函數常用於更新文件的訪問時間和修改時間，或者當文件不存在時，創建一個空文件。然而，很多開發者在使用touch()時，可能會遇到意外創建空文件的問題，尤其是在文件不存在的情況下， touch()會自動創建一個新的空文件。這在某些場景下可能會引發問題，特別是當不希望意外生成空文件時。本文將探討如何避免這一問題，並分享一些實用技巧。

1. 理解touch()函數的行為

首先，我們需要了解touch()函數的基本行為。 touch()函數用於修改文件的訪問時間和修改時間。其函數原型如下：

 <span><span><span class="hljs-keyword">bool</span></span><span> </span><span><span class="hljs-title function_ invoke__">touch</span></span><span> ( </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$filename</span></span><span> [, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$time</span></span><span> = </span><span><span class="hljs-title function_ invoke__">time</span></span><span>() [, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$atime</span></span><span> = </span><span><span class="hljs-title function_ invoke__">time</span></span><span>() ]] )
</span></span>

$filename ：需要操作的文件名。
$time ：修改時間，默認為當前時間。
$atime ：訪問時間，默認為當前時間。

如果指定的文件不存在且沒有權限創建文件， touch()會返回false ，但是如果指定的文件不存在且有權限創建文件，則會創建一個空文件並返回true 。

2. 避免意外創建空文件

為了避免touch()在文件不存在時創建一個空文件，可以採取以下幾種方法：

2.1 檢查文件是否存在

最簡單且有效的方式是在使用touch()之前，先檢查目標文件是否存在。可以使用file_exists()或is_file()函數來判斷文件是否已存在。如果文件不存在，可以跳過touch()調用。

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">file_exists</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>)) {
    </span><span><span class="hljs-title function_ invoke__">touch</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-comment">// 文件不存在，執行其他操作或日誌記錄</span></span><span>
}
</span></span>

這樣，只有在文件已經存在的情況下， touch()才會被調用，從而避免了創建空文件。

2.2 使用is_file()確保目標是文件

有時候，目標路徑可能是一個目錄而不是文件，這也可能導致錯誤的行為。使用is_file()來確保目標是一個文件而不是目錄，可以進一步避免不必要的空文件創建。

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">is_file</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>)) {
    </span><span><span class="hljs-title function_ invoke__">touch</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-comment">// 處理文件不是常規文件的情況</span></span><span>
}
</span></span>

2.3 設置文件權限和目錄檢查

如果你希望在文件不存在時創建文件，考慮提前創建文件所在的目錄，並設置合適的文件權限，避免空文件被創建。如果目標目錄不存在，可以先創建目錄，然後再使用touch() 。

 <span><span><span class="hljs-variable">$dir</span></span><span> = </span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">is_dir</span></span><span>(</span><span><span class="hljs-variable">$dir</span></span><span>)) {
    </span><span><span class="hljs-title function_ invoke__">mkdir</span></span><span>(</span><span><span class="hljs-variable">$dir</span></span><span>, </span><span><span class="hljs-number">0777</span></span><span>, </span><span><span class="hljs-literal">true</span></span><span>); </span><span><span class="hljs-comment">// 創建目錄並設置權限</span></span><span>
}
</span><span><span class="hljs-title function_ invoke__">touch</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>);
</span></span>

3. 使用@錯誤抑制符

雖然使用錯誤抑制符@不是推薦的最佳實踐，但如果你只關心是否成功執行，而不關心錯誤的具體細節，可以在touch()調用前使用@來抑制錯誤。

 <span><span>@</span><span><span class="hljs-title function_ invoke__">touch</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>);
</span></span>

這樣即使文件不存在，也不會產生警告信息。然而，注意這並不會解決創建空文件的問題，因此結合其他策略使用可能會更有效。

4. 自定義文件創建邏輯

如果你想要更精細地控製文件創建過程，可以根據需求自定義文件操作邏輯。例如，在某些情況下，可能希望創建一個特定內容的文件，而不是空文件。這時，你可以先檢查文件是否存在，如果不存在，創建文件並寫入一些初始化內容。

 <span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">file_exists</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>)) {
    </span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>, </span><span><span class="hljs-string">"Initial content"</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-title function_ invoke__">touch</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>);
}
</span></span>

這樣可以避免創建完全空白的文件，同時提供一些默認內容。

5. 結合file_put_contents()或fopen()更精細地控製文件創建

如果你需要更靈活的文件創建和修改操作，可以使用file_put_contents()或fopen()來控製文件的創建與寫入。這些方法允許你在文件創建時同時寫入數據，避免生成空文件。

 <span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">file_exists</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>)) {
    </span><span><span class="hljs-title function_ invoke__">file_put_contents</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>, </span><span><span class="hljs-string">"Initial content"</span></span><span>);
}
</span></span>

或者使用fopen() ，如果文件不存在則創建並寫入內容：

 <span><span><span class="hljs-variable">$handle</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-variable">$filename</span></span><span>, </span><span><span class="hljs-string">"w"</span></span><span>);  </span><span><span class="hljs-comment">// 'w' 模式會創建文件並清空文件內容</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$handle</span></span><span>) {
    </span><span><span class="hljs-title function_ invoke__">fwrite</span></span><span>(</span><span><span class="hljs-variable">$handle</span></span><span>, </span><span><span class="hljs-string">"Initial content"</span></span><span>);
    </span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$handle</span></span><span>);
}
</span></span>

總結

在使用touch()函數時，避免意外創建空文件的關鍵是事先判斷文件是否存在，或者採取其他方法來避免空文件的生成。通過結合file_exists() , is_file() , mkdir()等函數，你可以有效地避免不必要的空文件創建。每種方法都有其適用場景，根據具體需求選擇合適的策略，可以提升代碼的健壯性和可維護性。