murph-doc/docs/utils/file_handler.md

# File upload handler

`App\Core\Form\FileUploadHandler` is a service and helps you to upload a file. See example below.

```php-inline
use App\Core\Form\FileUploadHandler;
use App\Entity\Foo;
use App\Form\FooType;
use Symfony\Component\HttpFoundation\Request;

public function upload(Request $request, FileUploadHandler $fileUpload)
{
    $entity = new Foo();
    $form = $this->createForm(FooType::class, $foo);

    if ($request->isMethod('POST')) {
        $form->handleRequest($request);

        if ($form->isValid()) {
            $fileDirectory = 'uploads/';
            $keepOriginalFilename = false;

            $fileUpload->handleForm(
                $form->get('image')->getData(), // Symfony\Component\HttpFoundation\File\UploadedFile or null
                $fileDirectory,
                // optional
                function ($filename) use ($entity, $fileDirectory) {
                    $entity->setImage($fileDirectory.$filename);
                },
                // optional
                $keepOriginalFilename
            );

            // ...
        }
    }
}
```