php7.4文件管理实战：按扩展名自动归类文件夹文件【实战】

先抛开一些常见的误解，PHP 7.4 本身并没有提供任何“自动归类”的魔法。所有逻辑都得一行行手动敲出来。业界最稳的做法，还是老老实实按扩展名来分类：用 `pathinfo()` 提取后缀，`strtolower()` 统一大小写，`scandir()` 安全地遍历目录，最后靠 `mkdir(..., 0755, true)` 和 `rename()` 完成移动。 但有个坑必须留意：跨分区移动会静默失败，这事得提前拦截。

### 为什么要慎用 glob() 或字符串比对来做扩展名判断 很多人第一反应是 `glob("*.jpg")`，然后对结果逐条处理。这有个致命短板：它一次只能筛一种类型，没法做多路分发。更常见的问题是，有人写 `$file . ".pdf"` 或者 `if (endswith($file, ".PDF"))` 来判断——这在 Linux 下会漏掉 `REPORT.PDF`，在 Windows 下又可能把 `archive.tar.gz` 错判成 `tar.gz`。 关键点在这： - `pathinfo($file, PATHINFO_EXTENSION)` 才是正路，它能正确解析 `data.tar.gz` 返回 `gz`，`image.JPG` 返回 `JPG`。 - 拿到结果后，立刻用 `strtolower()` 转成小写，否则分类映射表会失效。 - 空扩展名的情况（比如 `README`），会返回空字符串。这时候就得提前想清楚规则：是归入 `others` 目录，还是直接跳过。 ### 具体的遍历技巧 直接用 `opendir()` + `readdir()` 容易陷入子目录循环或者权限中断。相比之下，`scandir()` 更可控，但它默认会带上 `.` 和 `..`，而且不区分文件和目录。 实操建议： 1. 先通过 `$items = scandir($source)` 获取全部条目。 2. 显式过滤：`if (in_array($item, ['.', '..'])) continue;` 3. 再用 `is_file($full_path)` 排除子目录干扰（除非你明确要递归处理）。 4. 循环里千万别反复调 `filemtime()` 或 `filesize()`——归类阶段用不上这些元数据，白费性能。 ### 移动前必须核实的 4 个关键点 `rename()` 返回 `false` 时不抛异常，只静默失败。常见原因包括：目标目录不存在、同名文件已存在、跨文件系统、权限不足——这些都得主动检查。 - 用 `mkdir($target_dir, 0755, true)` 创建多级目录时，`true` 参数千万别省略。 - 拼路径用 `dirname(__FILE__) . '/output/' . $category . '/' . basename($file)`，手动拼斜杠容易出 bug。 - 同名文件策略要提前硬编码：是直接覆盖（危险）、重命名（比如 `report (2).pdf`）、跳过，还是记到日志里？ - 跨分区移动会失败：Linux/macOS 下用 `stat($source)['dev'] !== stat($target_dir)['dev']` 判断；Windows 则用 `pathinfo($source, PATHINFO_DRIVE)` 对比驱动器号。如果检测到跨盘，就改用 `copy()` + `unlink()`，并且逐个检查返回值。 ### 规则映射表怎么设计才真正可维护 把分类规则硬编码在 if-else 里？后续加个 `.epub` 就得改逻辑。用关联数组定义映射才是正经做法，清晰又易扩展。 - 示例结构：`$rules = ['documents' => ['pdf','docx','txt'], 'images' => ['jpg','png','webp']]` - 遍历时，可以用 `array_key_exists($ext, array_flip($rules[$cat]))` 查找，或者更高效地预先反转为 `$ext_map = ['pdf'=>'documents', 'jpg'=>'images']`。 - 未匹配的扩展名统一归入 `others` 目录，但一定要记录日志：哪些扩展名被忽略了，方便后续补全规则。 - 中文文件名不需要额外处理——PHP 7.4 默认 UTF-8，`basename()` 和 `rename()` 在 Linux 下原生支持；Windows 则需要确认系统 locale 是 UTF-8 兼容的（例如 CP65001）。 真正卡住人的，从来不是代码写不出来，而是那些边界情况：空扩展名怎么处理、软链接要不要跟随、`.env` 这类隐藏文件是否纳入分类、以及跨分区移动失败后没有提示导致文件凭空“消失”。这些细节不写进条件分支里，脚本就永远只是个半成品。