ThinkPHP工作目录设置：避免文件丢失的实操指南【技巧】

项目上线后上传多个文件却只存下1个，本地测试正常但服务器上反复丢失文件——这种问题，往往不是代码写错，而是工作目录设置不当，导致文件名冲突或路径覆盖。先搞清楚几个关键环节，问题就能迎刃而解。

确认上传类默认sa veName行为

打开ThinkPHP 3.2.3源码中的ThinkPHPLibraryThinkUpload.class.php，定位到getName()方法。该方法根据$this->sa veName配置生成文件名，默认值为array('uniqid', '')——注意第二个参数为空字符串。这意味着多次调用uniqid()时，在毫秒级内返回相同前缀，多文件上传时极易重名覆盖。无论如何，都要把这一层逻辑理清楚，否则路径怎么设都没用。

修复多文件上传丢失的核心操作

在控制器中实例化Upload对象后，立即重置sa veName属性：

$upload = new ThinkUpload();
$upload->sa veName = array('uniqid', array('', true));

这个true参数会让uniqid()启用更严格的唯一性生成逻辑（基于微秒+进程ID），彻底杜绝同批次上传文件名重复。不加这句，所有补救路径设置都是徒劳。

设置上传根目录并确保可写

第一步：确认public目录下已存在uploads子目录。
第二步：给该目录设置755权限：chmod -R 755 public/uploads。权限不足时move()会静默失败，需留意的是，不要设成777。
第三步：在控制器中调用move()时传入绝对路径：$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads');

ROOT_PATH是框架常量，指向项目根目录；DS是目录分隔符，自动适配Windows/Linux。硬编码相对路径如./uploads在CLI或某些部署环境下会失效。

用filesystem磁盘统一管理上传路径

方法一：编辑config/filesystem.php，在disks数组中添加：

'uploads' => [
    'type' => 'local',
    'root' => app()->getRootPath() . 'public/uploads',
    'url' => '/uploads',
    'visibility' => 'public'
]

方法二：控制器中调用：Filesystem::disk('uploads')->putFile('images', $file);

注意：public/uploads目录必须手动创建且可写，putFile不会自动创建public父目录，只创建其下的子路径。

动态生成带日期和用户ID的子路径

第一步：编写路径生成函数（可放在common/function.php）：

function generateUploadPath($file, $prefix = '') {
    $date = date('Y/m/d');
    $userId = request()->user->id ?? 'guest';
    return trim($prefix . '/' . $userId . '/' . $date, '/');
}

第二步：在上传逻辑中调用：

$path = generateUploadPath($file, 'a vatars');
$result = Filesystem::disk('public')->putFile($path, $file);

生成的路径形如a vatars/123/2026/06/04/xxx.jpg，自动按日隔离，避免单目录海量文件。但public目录本身必须存在且可写，否则整个链路中断。