Bolt 4 如何在程序化创建条目时填充图片及图片列表字段

核心逻辑 #

Bolt的Image类字段会自动序列化数组结构为JSON存入数据库，不需要手动拼接JSON字符串，你只需要先上传文件生成Media实体拿到对应参数，再把对应结构的数组传入setFieldValue方法即可。

步骤1：上传文件生成Media实体 #

你可以直接使用Bolt内置的上传服务处理本地文件或者远程URL文件，示例代码如下：

// 依赖注入示例（推荐通过构造函数注入，以下为Container快速获取写法仅作参考）
/** @var \Bolt\Filesystem\UploadHandler $uploadHandler */
$uploadHandler = $this->get('Bolt\Filesystem\UploadHandler');
/** @var \Bolt\Doctrine\Repository\MediaRepository $mediaRepository */
$mediaRepository = $this->get('Bolt\Doctrine\Repository\MediaRepository');
/** @var \Doctrine\ORM\EntityManagerInterface $entityManager */
$entityManager = $this->get('doctrine')->getManager();

// 处理外部URL文件：先下载到临时目录
$remoteImageUrl = '你的外部图片链接';
$tempFilePath = tempnam(sys_get_temp_dir(), 'bolt_upload');
file_put_contents($tempFilePath, file_get_contents($remoteImageUrl));

// 生成UploadedFile对象上传到Bolt文件系统
$uploadedFile = new \Symfony\Component\HttpFoundation\File\File($tempFilePath);
$mediaEntity = $uploadHandler->upload($uploadedFile, 'files'); // 第二个参数为上传位置，默认files对应public/files目录

// 保存Media实体获取ID
$mediaRepository->add($mediaEntity);
$entityManager->flush();

// 用完删除临时文件避免占用空间
unlink($tempFilePath);

步骤2：给单Image字段赋值 #

直接传入数组结构即可，Bolt会自动处理序列化：

$content->setFieldValue('你的图片字段名', [
    'media' => $mediaEntity->getId(),
    'alt' => '自定义图片alt文本',
    'filename' => $mediaEntity->getFilename(), // 直接从Media实体获取路径即可，不需要手动拼接
]);

// 保存内容实体
$entityManager->persist($content);
$entityManager->flush();

步骤3：给Image List字段赋值 #

传入多个上述结构的数组即可：

// 假设你已经生成了多个Media实体
$imageList = [
    [
        'media' => $media1->getId(),
        'alt' => '第一张图alt',
        'filename' => $media1->getFilename(),
    ],
    [
        'media' => $media2->getId(),
        'alt' => '第二张图alt',
        'filename' => $media2->getFilename(),
    ]
];

$content->setFieldValue('你的图片列表字段名', $imageList);
$entityManager->persist($content);
$entityManager->flush();

注意事项 #

• 如果是本地已存在的文件，不需要走下载临时文件流程，直接将本地文件路径传入Symfony\Component\HttpFoundation\File\File实例即可
• CLI脚本执行时需要保证public/files目录的写入权限和web访问权限一致，避免出现文件可读但前端访问403的问题

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