Symfony Doctrine：实现OneToMany关联实体的高效搜索

// src/Entity/Image.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;

/**
 * @ORM\Entity(repositoryClass="App\Repository\ImageRepository")
 */
class Image
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    private $id;

    /**
     * @ORM\Column(type="string", length=255)
     */
    private $imageName; // 建议使用 camelCase

    /**
     * @ORM\OneToMany(targetEntity=Tags::class, mappedBy="imageStock", cascade={"persist"}) // 注意这里修正为 imageStock
     */
    private $tags;

    public function __construct()
    {
        $this->tags = new ArrayCollection();
    }

    // ... getters and setters ...

    public function getImageName(): ?string
    {
        return $this->imageName;
    }

    public function setImageName(string $imageName): self
    {
        $this->imageName = $imageName;
        return $this;
    }

    /**
     * @return Collection|Tags[]
     */
    public function getTags(): Collection
    {
        return $this->tags;
    }

    public function addTag(Tags $tag): self
    {
        if (!$this->tags->contains($tag)) {
            $this->tags[] = $tag;
            $tag->setImageStock($this);
        }
        return $this;
    }

    public function removeTag(Tags $tag): self
    {
        if ($this->tags->removeElement($tag)) {
            // set the owning side to null (unless already changed)
            if ($tag->getImageStock() === $this) {
                $tag->setImageStock(null);
            }
        }
        return $this;
    }
}

// src/Entity/Tags.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity(repositoryClass="App\Repository\TagsRepository")
 */
class Tags
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    private $id;

    /**
     * @ORM\Column(type="string", length=255)
     */
    private $tagName; // 建议使用 camelCase

    /**
     * @ORM\ManyToOne(targetEntity=Image::class, inversedBy="tags")
     * @ORM\JoinColumn(nullable=false)
     */
    private $imageStock; // 关联到 Image 实体

    // ... getters and setters ...

    public function getTagName(): ?string
    {
        return $this->tagName;
    }

    public function setTagName(string $tagName): self
    {
        $this->tagName = $tagName;
        return $this;
    }

    public function getImageStock(): ?Image
    {
        return $this->imageStock;
    }

    public function setImageStock(?Image $imageStock): self
    {
        $this->imageStock = $imageStock;
        return $this;
    }
}

// src/Repository/ImageRepository.php
namespace App\Repository;

use App\Entity\Image;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;

/**
 * @method Image|null find($id, $lockMode = null, $lockVersion = null)
 * @method Image|null findOneBy(array $criteria, array $orderBy = null)
 * @method Image[]    findAll()
 * @method Image[]    findBy(array $criteria, array $orderBy = null)
 */
class ImageRepository extends ServiceEntityRepository
{
    public function __construct(ManagerRegistry $registry)
    {
        parent::__construct($registry, Image::class);
    }

    /**
     * 根据图片名称或标签名称搜索图片
     *
     * @param string $searchQuery 搜索关键词
     * @return Image[] 返回匹配的图片实体数组
     */
    public function searchByImageNameOrTagName(string $searchQuery): array
    {
        $qb = $this->createQueryBuilder('img'); // 'img' 是 Image 实体的主别名

        // 使用 leftJoin 关联 Tags 实体，别名为 'tag'
        // 这样我们就可以在 WHERE 子句中引用 Tags 的属性
        $qb->leftJoin('img.tags', 'tag')
           ->orderBy('img.id', 'ASC');

        // 构建 WHERE 子句：使用 orX 表达式组合两个 LIKE 条件
        // 1. 图片名称匹配搜索词
        // 2. 任意关联标签的名称匹配搜索词
        $qb->andWhere(
            $qb->expr()->orX(
                $qb->expr()->like('img.imageName', ':search_param'), // 搜索 Image 的 imageName 属性
                $qb->expr()->like('tag.tagName', ':search_param')    // 搜索关联 Tags 的 tagName 属性
            )
        )
        // 设置参数，注意 LIKE 操作符需要将搜索词包裹在 '%' 中以实现模糊匹配
        ->setParameter('search_param', "%{$searchQuery}%");

        // 执行查询并返回结果
        return $qb->getQuery()->getResult();
    }
}