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

ThinkPHP多文件上传只存1个是因saveName默认uniqid('', '')导致同毫秒重名覆盖，须设$upload->saveName = array('uniqid', array('', true))；同时确保public/uploads目录存在、755权限，并用ROOT_PATH+DS拼接绝对路径或filesystem磁盘管理。

ThinkPHP项目上线后上传多个文件却只存下1个，本地测试正常但服务器上反复丢失文件，这种问题往往不是代码写错，而是工作目录设置不当导致文件名冲突或路径覆盖。

确认上传类默认saveName行为

打开ThinkPHP 3.2.3源码中的ThinkPHPLibraryThinkUpload.class.php，定位到getName()方法。该方法会根据$this->saveName配置生成文件名，默认值为array('uniqid', '')——注意第二个参数为空字符串，这会导致多次调用uniqid()时在毫秒级内返回相同前缀，多文件上传时极易重名覆盖。

必须修改saveName配置，否则无论路径怎么设，文件都会被后传的覆盖掉。

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

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

立即学习“PHP免费学习笔记（深入）”；

$upload = new ThinkUpload();

$upload->saveName = 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, 'avatars');

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

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