CakePHP3文件上传报错：Illegal string offset 'tmp_name' 求助

嘿，这个错误我之前帮好几个开发者排查过，其实本质是你尝试把一个字符串当成数组来访问['tmp_name']键了，咱们一步步拆解原因和解决方法：

1. 表单缺少关键的enctype属性 #

这是文件上传最容易踩的坑！HTML表单如果要上传文件，必须添加enctype="multipart/form-data"属性，否则服务器根本不会解析文件数据，只会把文件名当作普通字符串传递过来。

正确的表单写法应该是这样：

<form method="post" action="/your/upload/endpoint" enctype="multipart/form-data">
    <input type="file" name="upload_file">
    <button type="submit">确认上传</button>
</form>

如果没加这个属性，你在控制器里通过$this->request->getData('upload_file')拿到的就是纯文件名字符串，而非包含tmp_name的数组，自然就会触发Illegal string offset 'tmp_name'错误。

2. 请求数据的访问逻辑有误 #

在CakePHP 3中，文件上传数据需要通过$this->request->getData()获取（别直接操作原生的$_FILES，框架封装的方法更安全规范）。而且要确保你访问的键名和表单中input的name属性完全一致。

举个正确的控制器处理示例：

// 获取上传文件数据
$uploadedFile = $this->request->getData('upload_file');

// 先校验是否是有效的上传文件
if (!empty($uploadedFile['tmp_name']) && is_uploaded_file($uploadedFile['tmp_name'])) {
    // 这里写你的文件保存、移动逻辑
    $destination = WWW_ROOT . 'uploads' . DS . $uploadedFile['name'];
    move_uploaded_file($uploadedFile['tmp_name'], $destination);
}

如果你跳过校验直接写$uploadedFile['tmp_name']，而$uploadedFile实际是字符串的话，就会触发错误。

3. 表单字段名的层级/格式错误 #

如果你的表单用了数组式字段名（比如name="files[]"实现多文件上传），或者嵌套字段（比如name="user[avatar]"），那你得对应调整数据获取的方式：

• 多文件上传：需要循环遍历$this->request->getData('files')数组
• 嵌套字段：通过$this->request->getData('user.avatar')获取文件数据

要是搞错了层级，拿到的可能就是字符串而非文件数组。

4. 服务器配置限制（间接诱因） #

虽然不会直接导致这个错误，但如果PHP配置里的upload_max_filesize或post_max_size设置过小，超过限制的文件会上传失败，此时$uploadedFile['tmp_name']可能为空甚至变成字符串。建议检查php.ini里的这两个参数，确保值足够容纳你要上传的文件。

小调试技巧 #

排查的时候可以先在控制器里加一句debug($this->request->getData())，看看返回的结构到底是数组还是字符串，这样能快速定位问题出在哪一步。

内容的提问来源于stack exchange，提问作者user7362769