正确使用 filetype 和 file_exists 函数，避免常见的错误用法

gitbox 2025-09-28
<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 一些无关的前置内容</span></span><span>
</span><span><span class="hljs-variable">$now</span></span><span> = </span><span><span class="hljs-title function_ invoke__">date</span></span><span>(</span><span><span class="hljs-string">"Y-m-d H:i:s"</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"当前时间：<span class="hljs-subst">{$now}</span></span></span><span>\n";

</span><span><span class="hljs-comment">// --------------------------------------------</span></span><span>

<span class="hljs-comment">/**
 * 正确使用 filetype 和 file_exists 函数，避免常见的错误用法
 * 
 * 在 PHP 中，文件操作是日常开发中非常常见的需求，例如检查文件是否存在、
 * 判断文件类型等。在这些场景下，`file_exists()` 与 `filetype()` 函数经常会被使用。
 * 然而，如果对它们的用法理解不够清晰，就可能出现错误的写法或逻辑漏洞。
 * 
 * 一、file_exists() 的正确用法
 * --------------------------
 * `file_exists()` 用于检查文件或目录是否存在。它返回布尔值 `true` 或 `false`。
 * 需要注意的是：
 * - `file_exists()` 不区分文件和目录，只要路径存在就会返回 true。
 * - 在某些操作系统或权限受限的情况下，即便文件存在，如果没有读取权限，也可能导致返回 `false`。
 * 
 * 示例：
 * ```php
 * if (file_exists("data.txt")) {
 *     echo "文件存在";
 * } else {
 *     echo "文件不存在";
 * }
 * ```
 * 
 * 常见错误用法：
 * - 误以为 `file_exists()` 只判断文件，不判断目录。
 * - 忽略权限问题导致的假阴性（文件存在却返回 false）。
 * 
 * 二、filetype() 的正确用法
 * ------------------------
 * `filetype()` 用于返回路径的类型字符串，比如：
 * - `file`   表示普通文件
 * - `dir`    表示目录
 * - 其他类型如 `block`, `char`, `fifo`, `link`, `socket` 在不同系统下可能出现
 * 
 * 使用前必须保证路径存在，否则会产生警告。因此在调用 `filetype()` 前，通常要先使用 `file_exists()`。
 * 
 * 示例：
 * ```php
 * $path = "data.txt";
 * if (file_exists($path)) {
 *     echo "类型是：" . filetype($path);
 * } else {
 *     echo "路径不存在";
 * }
 * ```
 * 
 * 常见错误用法：
 * - 直接调用 `filetype()` 而不先确认文件是否存在，导致 PHP 警告。
 * - 将 `filetype()` 的返回值误认为布尔值。实际上它返回的是字符串，如 `file` 或 `dir`。
 * 
 * 三、结合使用的最佳实践
 * ----------------------
 * 当我们既需要判断文件是否存在，又要区分它是文件还是目录时，可以这样写：
 * 
 * ```php
 * $path = "uploads";
 * if (!file_exists($path)) {
 *     echo "路径不存在";
 * } else {
 *     $type = filetype($path);
 *     if ($type === "file") {
 *         echo "这是一个文件";
 *     } elseif ($type === "dir") {
 *         echo "这是一个目录";
 *     } else {
 *         echo "其他类型：" . $type;
 *     }
 * }
 * ```
 * 
 * 总结
 * ----
 * - `file_exists()` 用于判断路径是否存在，但不区分文件和目录。
 * - `filetype()` 用于判断类型，但必须在路径存在时使用。
 * - 避免的常见错误是：忽视权限问题、误解返回值类型、未先判断存在性。
 * 
 * 只有正确地理解和组合使用这两个函数，才能在文件操作中避免常见的坑，提高代码的健壮性和可靠性。
 */</span>
</span></span>
filetype