怎样避免使用 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() 等函数，你可以有效地避免不必要的空文件创建。每种方法都有其适用场景，根据具体需求选择合适的策略，可以提升代码的健壮性和可维护性。