murph-doc/docs/entities/query.md

Repository Query

A Repository query is an abstraction of the doctrine repository.

Requirement

Entities must implements App\Core\Entity\EntityInterface.

namespace App\Entity;

use App\Repository\MyEntityRepository;
use Doctrine\ORM\Mapping as ORM;
use App\Core\Entity\EntityInterface;

/**
 * @ORM\Entity(repositoryClass=MyEntityRepository::class)
 */
class MyEntity implements EntityInterface
{
    // ...
}

Generation

The generation is performed in CLI. These information are required:

• The namespace of the repository (eg: MyEntityRepository)

Simply run php bin/console make:repository-query.

Each entity has its own repository query which is a service.

namespace App\Repository;

use App\Core\Repository\RepositoryQuery;
use Knp\Component\Pager\PaginatorInterface;

class MyEntityRepositoryQuery extends RepositoryQuery
{
    public function __construct(MyEntityRepository $repository, PaginatorInterface $paginator)
    {
        parent::__construct($repository, 'm', $paginator);
    }

    // Example of custom filter
    public function filterByFooBar(bool $foo, bool $bar): self
    {
        $this
            ->andWhere('.foo = :foo')
            ->andWhere('.bar = :bar')
            ->setParameter(':foo', $foo)
            ->setParameter(':bar', $bar);

        return $this;
    }
}

Usage

You are able to find entities in an easy way, without knowing the identification variable and without creating a query builder.

namespace App\Controller;

use App\Repository\MyEntityRepositoryQuery
use Symfony\Component\HttpFoundation\Response;

class FooController
{
    public function foo(MyEntityRepositoryQuery $query): Response
    {
        $entities = $query->create()->find();
        $entity = $query->create()->findOne();

        // Filtered and sorted entities
        $entities = $query->create()
            ->orderBy('.id', 'DESC')
            ->where('.isPublished = true')
            ->find();

        // ...
    }
}

Custom methods

// ...

class MyEntityRepositoryQuery extends RepositoryQuery
{
	// ...

    public function filterByFooBar(bool $foo, bool $bar): self
    {
        $this
            ->andWhere('.foo = :foo')
            ->andWhere('.bar = :bar')
            ->setParameter(':foo', $foo)
            ->setParameter(':bar', $bar);

        return $this;
    }
}

$entities = $query->create()
    ->filterByFoo($foo, $bar)
    ->find();

Pager

You can paginate entities (Knp\Component\Pager\Pagination\PaginationInterface):

$pager = $query->create()->paginate($page, $maxPerPage);