Symfony中FileUploader的$targetDirectory参数来源及多目录使用问题

一、$targetDirectory参数的来源 #

%brochures_directory%是Symfony的配置参数，它并非来自控制器，而是提前在配置文件（通常是config/services.yaml）中定义的，示例如下：

# config/services.yaml
parameters:
    brochures_directory: '%kernel.project_dir%/public/uploads/brochures'

Symfony的服务容器会读取这个参数，在实例化FileUploader服务时自动将参数值注入到服务的$targetDirectory构造函数参数中，控制器无需额外声明。

二、让服务使用不同目录的两种方案 #

1. 配置多个服务实例（推荐，符合依赖注入原则） #

在config/services.yaml中为不同上传场景配置独立的FileUploader服务实例，绑定不同的目标目录参数：

# 先定义新的目录参数
parameters:
    brochures_directory: '%kernel.project_dir%/public/uploads/brochures'
    product_images_directory: '%kernel.project_dir%/public/uploads/product_images'

services:
    # 手册上传服务（默认实例）
    App\Service\FileUploader:
        arguments:
            $targetDirectory: '%brochures_directory%'

    # 产品图片上传服务（自定义实例）
    App\Service\FileUploader.product_image:
        arguments:
            $targetDirectory: '%product_images_directory%'

控制器中通过服务别名注入对应的实例：

use App\Service\FileUploader;
use Symfony\Component\DependencyInjection\Attribute\Autowire;

public function new(Request $request, #[Autowire(service: 'App\Service\FileUploader.product_image')] FileUploader $imageUploader): Response
{
    // 使用$imageUploader处理产品图片上传
    if ($form->isSubmitted() && $form->isValid()) {
        /** @var UploadedFile $imageFile */
        $imageFile = $form->get('product_image')->getData();
        if ($imageFile) {
            $imageFileName = $imageUploader->upload($imageFile);
            $product->setImageFilename($imageFileName);
        }
        // ...
    }
}

2. 修改服务类支持动态目录 #

如果需要更灵活的目录切换，可以修改FileUploader类，让upload方法支持传入自定义目录：

// src/Service/FileUploader.php
namespace App\Service;

use Symfony\Component\HttpFoundation\File\UploadedFile;

class FileUploader
{
    private $defaultDirectory;

    public function __construct(string $defaultDirectory)
    {
        $this->defaultDirectory = $defaultDirectory;
    }

    public function upload(UploadedFile $file, ?string $customDirectory = null): string
    {
        // 优先使用自定义目录，否则用默认目录
        $targetDir = $customDirectory ?? $this->defaultDirectory;
        
        // 原有的上传逻辑（生成文件名、移动文件等）
        $fileName = uniqid().'.'.$file->guessExtension();
        $file->move($targetDir, $fileName);

        return $fileName;
    }
}

使用时直接传入目标目录路径：

$imageFileName = $fileUploader->upload($imageFile, $this->getParameter('product_images_directory'));

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