本文介绍一种基于 php 脚本的轻量级方案，用于在 synology nas 环境下快速将含 thumbnails 子目录的文件夹批量迁移至独立父目录，实现 images 与 thumbnails 的物理分离，全程为原子级移动（非复制删除），兼顾效率与可靠性。
本文介绍一种基于 php 脚本的轻量级方案，用于在 synology nas 环境下快速将含 thumbnails 子目录的文件夹批量迁移至独立父目录，实现 images 与 thumbnails 的物理分离，全程为原子级移动（非复制删除），兼顾效率与可靠性。
在管理大量网站资源目录时，常遇到类似结构：每个项目子目录（如 /folder1, /folder2）均包含 images/，部分还包含 thumbnails/。为优化存储组织、简化 CDN 配置或便于权限隔离，需将所有 thumbnails/ 子目录统一抽离到全新目录树（如 /directory2/），同时保留原目录中仅含 images/ 的精简结构。
该需求无需依赖复杂工具或跨平台同步服务——PHP 即可优雅解决，尤其适合 Synology NAS（支持 Web Station + PHP 运行环境）配合 Windows 端远程执行的场景。
✅ 核心原理：原子移动，零冗余开销
关键在于利用 PHP 的 rename() 函数。它在同一文件系统内执行的是底层 mv 操作（Linux/macOS）或重命名系统调用（Windows），本质是更新 inode 或目录项指针，不复制数据、不占用额外磁盘空间、毫秒级完成。这完全规避了“复制+删除”的性能陷阱，即使处理数百个 thumbnails/ 目录也能在数秒内结束。
?️ 推荐脚本（可直接部署运行）
<?php
// config: 修改为你的实际路径（绝对路径更稳妥）
$sourceRoot = '/volume1/web/directory1'; // 原始根目录
$targetRoot = '/volume1/web/directory2'; // 新 thumbnails 根目录
// 允许脚本最长运行 3 小时（应对海量目录）
ini_set('max_execution_time', 10800);
// 创建目标根目录（若不存在）
if (!is_dir($targetRoot)) {
if (!mkdir($targetRoot, 0755, true)) {
die("❌ 无法创建目标根目录: $targetRoot\n");
}
echo "✅ 已创建目标根目录: $targetRoot\n";
}
// 扫描 sourceRoot 下所有一级子目录（跳过 . 和 ..）
$folders = array_filter(scandir($sourceRoot), function($item) use ($sourceRoot) {
return $item !== '.' && $item !== '..' && is_dir($sourceRoot . '/' . $item);
});
foreach ($folders as $folderName) {
$sourceThumbs = $sourceRoot . '/' . $folderName . '/thumbnails';
// 仅当 thumbnails 子目录存在时才处理
if (is_dir($sourceThumbs)) {
$targetPath = $targetRoot . '/' . $folderName . '/thumbnails';
// 创建目标文件夹路径（含父级 folderName）
$targetDir = dirname($targetPath);
if (!is_dir($targetDir)) {
if (!mkdir($targetDir, 0755, true)) {
echo "⚠️ 跳过 $folderName：无法创建目标路径 $targetDir\n";
continue;
}
}
// 执行原子移动
if (rename($sourceThumbs, $targetPath)) {
echo "✅ 已迁移: $folderName/thumbnails → directory2\n";
} else {
echo "❌ 迁移失败: $folderName/thumbnails\n";
}
}
}
echo "\n? 所有操作完成。\n";
?>⚠️ 关键注意事项
- 路径务必使用绝对路径：Synology 中推荐以 /volume1/... 开头，避免相对路径导致定位错误；
- 权限检查：确保 PHP 进程对源目录和目标目录均有 rwx 权限（可通过 DSM →「控制面板」→「共享文件夹」→ 编辑权限设置）；
- 同文件系统限制：rename() 的高效性依赖于源与目标位于同一挂载卷（如均为 /volume1）。若跨卷（如 /volume1 → /volume2），将自动降级为复制+删除，大幅降低速度并消耗双倍空间；
- 安全第一：首次运行前，建议先在测试目录中验证脚本逻辑，并备份关键数据；
- Windows 访问方式：可通过 Web Station 启用 PHP，将脚本保存为 split_thumbnails.php，再用浏览器访问 http://[NAS_IP]/split_thumbnails.php 执行；或通过 SSH 登录 NAS 后命令行运行 php /path/to/split_thumbnails.php。
✅ 效果验证与后续建议
执行后，原始 /directory1/ 中所有 thumbnails/ 子目录将消失，而 /directory2/ 下将精准重建对应目录结构（如 folder1/thumbnails, folder3/thumbnails）。建议后续：
- 对 /directory2 设置独立的 Web Server 别名（如 thumbs.example.com）；
- 在 Nginx/Apache 中配置 thumbnails/ 目录的缓存头与防盗链规则；
- 将此脚本加入定期任务（如每月扫描新增目录），实现半自动化维护。
该方案以最小技术栈达成最大实用性——无需安装新软件、不依赖 Shell 熟练度、代码清晰可审计，是 NAS 环境下结构化文件治理的理想实践。
