126 lines
2.7 KiB
Markdown
126 lines
2.7 KiB
Markdown
# Repository Query
|
|
|
|
A Repository query is an abstraction of the doctrine repository.
|
|
|
|
## Requirement
|
|
|
|
Entities must implements `App\Core\Entity\EntityInterface`.
|
|
|
|
```php-inline title="src/Entity/MyEntity.php"
|
|
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.
|
|
|
|
|
|
```php-inline title="src/Repository/MyEntityRepositoryQuery"
|
|
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.
|
|
|
|
```php-inline title="src/Controller/FooController.php"
|
|
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
|
|
|
|
```php-inline
|
|
// ...
|
|
|
|
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;
|
|
}
|
|
}
|
|
```
|
|
|
|
```php-inline
|
|
$entities = $query->create()
|
|
->filterByFoo($foo, $bar)
|
|
->find();
|
|
```
|
|
|
|
## Pager
|
|
|
|
You can paginate entities (`Knp\Component\Pager\Pagination\PaginationInterface`):
|
|
|
|
```php-inline
|
|
$pager = $query->create()->paginate($page, $maxPerPage);
|
|
```
|