如何获取表单中上传的客户图片值并将其保存到指定文件夹

1. 首要检查：表单enctype属性配置 #

上传文件的表单必须设置enctype="multipart/form-data"属性，否则浏览器不会将上传的文件内容包含在请求中，后端自然无法获取到文件值。
如果你使用的是PrestaShop类的表单生成组件，在表单根配置项中添加如下配置即可：

// 表单初始化时添加enctype配置
$formBuilder->setEnctype('multipart/form-data');

2. 修正代码中的方法名拼写错误 #

你当前的表单配置代码中，文件字段的类型设置方法写的是小写开头的settype，正确的驼峰命名方法应该是setType，错误的方法名会导致字段类型设置不生效，实际渲染的input可能不是file类型：

// 修正前
->settype('file')
// 修正后
->setType('file')

3. 正确获取上传的文件内容 #

不要使用普通表单字段的获取方式读取文件，需要使用框架专用的文件获取方法，或者原生PHP的$_FILES全局变量：

• 基于Symfony内核的框架（如PrestaShop、Laravel等）：

// 从请求中获取文件对象
$uploadedFile = $request->files->get('CustomerImage');

• 原生PHP：

$uploadedFile = $_FILES['CustomerImage'];

4. 实现文件保存到指定文件夹的逻辑 #

拿到文件对象后，先做合法性校验，再移动到目标存储路径，示例代码如下：

if ($uploadedFile && $uploadedFile->getError() === UPLOAD_ERR_OK) {
    // 配置允许的图片后缀
    $allowedExt = ['jpg', 'jpeg', 'png', 'webp', 'gif'];
    $fileExt = $uploadedFile->guessExtension();

    // 校验文件类型合法性
    if (!in_array(strtolower($fileExt), $allowedExt)) {
        // 此处抛出文件类型不合法的提示即可
        throw new \Exception('仅支持上传jpg、png、webp、gif格式的图片');
    }

    // 配置文件保存路径，示例为站点根目录下的upload/customer_logo文件夹
    $saveDir = __DIR__ . '/../../upload/customer_logo/';
    // 自动创建不存在的目录，权限设置为755
    if (!is_dir($saveDir)) {
        mkdir($saveDir, 0755, true);
    }

    // 生成唯一文件名，避免重名覆盖，这里用客户ID+时间戳组合
    $customerId = $request->get('id_customer');
    $fileName = $customerId . '_' . time() . '.' . $fileExt;

    // 移动文件到目标目录
    $uploadedFile->move($saveDir, $fileName);

    // 后续可将$fileName存入客户表对应的logo字段，方便前端调用
}

5. 额外注意事项 #

• 确保目标存储文件夹有web服务运行用户（如www-data、apache）的写入权限，否则会出现文件移动失败的问题
• 可以根据业务需要添加文件大小校验，避免用户上传过大的图片占用存储空间

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