Skip to content

Commit 093aede

Browse files
vinceAmstoutzvinceAmstoutz
committed
feat(doctrine): search filters like laravel eloquent filters
1 parent f67f6f1 commit 093aede

File tree

14 files changed

+880
-0
lines changed

14 files changed

+880
-0
lines changed

‎src/Doctrine/Common/Filter/IriSearchFilterTrait.php

+87
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
<?php
2+
3+
/*
4+
* This file is part of the API Platform project.
5+
*
6+
* (c) Kévin Dunglas <[email protected]>
7+
*
8+
* For the full copyright and license information, please view the LICENSE
9+
* file that was distributed with this source code.
10+
*/
11+
12+
declare(strict_types=1);
13+
14+
namespace ApiPlatform\Doctrine\Common\Filter;
15+
16+
use ApiPlatform\Metadata\Parameter;
17+
use ApiPlatform\OpenApi\Model\Parameter as OpenApiParameter;
18+
19+
trait IriSearchFilterTrait
20+
{
21+
public function getDescription(string $resourceClass): array
22+
{
23+
$description = [];
24+
25+
$properties = $this->getProperties();
26+
if (null === $properties) {
27+
$metadata = $this->getClassMetadata($resourceClass);
28+
$fieldNames = array_fill_keys($metadata->getFieldNames(), null);
29+
$associationNames = array_fill_keys($metadata->getAssociationNames(), null);
30+
31+
$properties = array_merge($fieldNames, $associationNames);
32+
}
33+
34+
foreach ($properties as $property => $strategy) {
35+
if (!$this->isPropertyMapped($property, $resourceClass, true)) {
36+
continue;
37+
}
38+
39+
if ($this->isPropertyNested($property, $resourceClass)) {
40+
$propertyParts = $this->splitPropertyParts($property, $resourceClass);
41+
$field = $propertyParts['field'];
42+
$metadata = $this->getNestedMetadata($resourceClass, $propertyParts['associations']);
43+
} else {
44+
$field = $property;
45+
$metadata = $this->getClassMetadata($resourceClass);
46+
}
47+
48+
$propertyName = $this->normalizePropertyName($property);
49+
if ($metadata->hasField($field)) {
50+
$typeOfField = $this->getType($metadata->getTypeOfField($field));
51+
$filterParameterNames = [$propertyName];
52+
53+
foreach ($filterParameterNames as $filterParameterName) {
54+
$description[$filterParameterName] = [
55+
'property' => $propertyName,
56+
'type' => $typeOfField,
57+
'required' => false,
58+
'strategy' => $strategy,
59+
'is_collection' => str_ends_with((string) $filterParameterName, '[]'),
60+
];
61+
}
62+
} elseif ($metadata->hasAssociation($field)) {
63+
$filterParameterNames = [
64+
$propertyName,
65+
$propertyName.'[]',
66+
];
67+
68+
foreach ($filterParameterNames as $filterParameterName) {
69+
$description[$filterParameterName] = [
70+
'property' => $propertyName,
71+
'type' => 'string',
72+
'required' => false,
73+
'strategy' => 'exact',
74+
'is_collection' => str_ends_with((string) $filterParameterName, '[]'),
75+
];
76+
}
77+
}
78+
}
79+
80+
return $description;
81+
}
82+
83+
public function getOpenApiParameters(Parameter $parameter): OpenApiParameter|array|null
84+
{
85+
return new OpenApiParameter(name: $parameter->getKey().'[]', in: 'query', style: 'deepObject', explode: true);
86+
}
87+
}

‎src/Doctrine/Odm/Filter/IriSearchFilter.php

+81
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
<?php
2+
3+
/*
4+
* This file is part of the API Platform project.
5+
*
6+
* (c) Kévin Dunglas <[email protected]>
7+
*
8+
* For the full copyright and license information, please view the LICENSE
9+
* file that was distributed with this source code.
10+
*/
11+
12+
declare(strict_types=1);
13+
14+
namespace ApiPlatform\Doctrine\Odm\Filter;
15+
16+
use ApiPlatform\Doctrine\Common\Filter\IriSearchFilterTrait;
17+
use ApiPlatform\Metadata\OpenApiParameterFilterInterface;
18+
use ApiPlatform\Metadata\Operation;
19+
use Doctrine\ODM\MongoDB\Aggregation\Builder;
20+
use Doctrine\ODM\MongoDB\Mapping\MappingException;
21+
use Doctrine\ODM\MongoDB\Types\Type as MongoDbType;
22+
use Doctrine\Persistence\ManagerRegistry;
23+
use Psr\Log\LoggerInterface;
24+
use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
25+
26+
class IriSearchFilter extends AbstractFilter implements OpenApiParameterFilterInterface
27+
{
28+
use IriSearchFilterTrait;
29+
30+
public function __construct(
31+
?ManagerRegistry $managerRegistry = null,
32+
?LoggerInterface $logger = null,
33+
?array $properties = null,
34+
?NameConverterInterface $nameConverter = null,
35+
) {
36+
parent::__construct($managerRegistry, $logger, $properties, $nameConverter);
37+
}
38+
39+
/**
40+
* @throws MappingException
41+
*/
42+
public function filterProperty(string $property, $value, Builder $aggregationBuilder, string $resourceClass, ?Operation $operation = null, array &$context = []): void
43+
{
44+
if (
45+
null === $value
46+
|| !$this->isPropertyEnabled($property, $resourceClass)
47+
|| !$this->isPropertyMapped($property, $resourceClass, true)
48+
) {
49+
return;
50+
}
51+
52+
$extraProperties = $operation?->getExtraProperties();
53+
$resource = $extraProperties['_value'] ?? null;
54+
55+
if (!$resource) {
56+
$this->logger->warning(\sprintf('No resource found for property "%s".', $property));
57+
58+
return;
59+
}
60+
61+
$aggregationBuilder
62+
->match()
63+
->field($property)
64+
->equals($resource->getId());
65+
}
66+
67+
/**
68+
* {@inheritdoc}
69+
*/
70+
protected function getType(string $doctrineType): string
71+
{
72+
// TODO: remove constantes deprecations when doctrine/dbal:3 support is removed
73+
return match ($doctrineType) {
74+
MongoDbType::INT, MongoDbType::INTEGER => 'int',
75+
MongoDbType::BOOL, MongoDbType::BOOLEAN => 'bool',
76+
MongoDbType::DATE, MongoDbType::DATE_IMMUTABLE => \DateTimeInterface::class,
77+
MongoDbType::FLOAT => 'float',
78+
default => 'string',
79+
};
80+
}
81+
}

‎src/Doctrine/Orm/Filter/IriSearchFilter.php

+83
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
<?php
2+
3+
/*
4+
* This file is part of the API Platform project.
5+
*
6+
* (c) Kévin Dunglas <[email protected]>
7+
*
8+
* For the full copyright and license information, please view the LICENSE
9+
* file that was distributed with this source code.
10+
*/
11+
12+
declare(strict_types=1);
13+
14+
namespace ApiPlatform\Doctrine\Orm\Filter;
15+
16+
use ApiPlatform\Doctrine\Common\Filter\IriSearchFilterTrait;
17+
use ApiPlatform\Doctrine\Orm\Util\QueryNameGeneratorInterface;
18+
use ApiPlatform\Metadata\OpenApiParameterFilterInterface;
19+
use ApiPlatform\Metadata\Operation;
20+
use Doctrine\DBAL\Types\Types;
21+
use Doctrine\ORM\QueryBuilder;
22+
use Doctrine\Persistence\ManagerRegistry;
23+
use Psr\Log\LoggerInterface;
24+
use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
25+
26+
class IriSearchFilter extends AbstractFilter implements OpenApiParameterFilterInterface
27+
{
28+
use IriSearchFilterTrait;
29+
30+
public function __construct(
31+
?ManagerRegistry $managerRegistry = null,
32+
?LoggerInterface $logger = null,
33+
?array $properties = null,
34+
?NameConverterInterface $nameConverter = null,
35+
) {
36+
parent::__construct($managerRegistry, $logger, $properties, $nameConverter);
37+
}
38+
39+
protected function filterProperty(string $property, mixed $value, QueryBuilder $queryBuilder, QueryNameGeneratorInterface $queryNameGenerator, string $resourceClass, ?Operation $operation = null, array $context = []): void
40+
{
41+
if (
42+
null === $value
43+
|| !$this->isPropertyEnabled($property, $resourceClass)
44+
|| !$this->isPropertyMapped($property, $resourceClass, true)
45+
) {
46+
return;
47+
}
48+
49+
$extraProperties = $operation?->getExtraProperties();
50+
$resource = $extraProperties['_value'] ?? null;
51+
if (!$resource) {
52+
$this->logger->warning(\sprintf('No resource found for property "%s".', $property));
53+
54+
return;
55+
}
56+
57+
$alias = $queryBuilder->getRootAliases()[0];
58+
$parameterName = $queryNameGenerator->generateParameterName($property);
59+
60+
$queryBuilder
61+
->andWhere(\sprintf('%s.%s = :%s', $alias, $property, $parameterName))
62+
->setParameter($parameterName, $resource->getId());
63+
}
64+
65+
/**
66+
* {@inheritdoc}
67+
*/
68+
public function getType(string $doctrineType): string
69+
{
70+
// TODO: remove this test when doctrine/dbal:3 support is removed
71+
if (\defined(Types::class.'::ARRAY') && Types::ARRAY === $doctrineType) {
72+
return 'array';
73+
}
74+
75+
return match ($doctrineType) {
76+
Types::BIGINT, Types::INTEGER, Types::SMALLINT => 'int',
77+
Types::BOOLEAN => 'bool',
78+
Types::DATE_MUTABLE, Types::TIME_MUTABLE, Types::DATETIME_MUTABLE, Types::DATETIMETZ_MUTABLE, Types::DATE_IMMUTABLE, Types::TIME_IMMUTABLE, Types::DATETIME_IMMUTABLE, Types::DATETIMETZ_IMMUTABLE => \DateTimeInterface::class,
79+
Types::FLOAT => 'float',
80+
default => 'string',
81+
};
82+
}
83+
}

‎src/State/Provider/IriConverterParameterProvider.php

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
<?php
2+
3+
/*
4+
* This file is part of the API Platform project.
5+
*
6+
* (c) Kévin Dunglas <[email protected]>
7+
*
8+
* For the full copyright and license information, please view the LICENSE
9+
* file that was distributed with this source code.
10+
*/
11+
12+
declare(strict_types=1);
13+
14+
namespace ApiPlatform\State\Provider;
15+
16+
use ApiPlatform\Doctrine\Odm\Filter\IriSearchFilter as IriSearchFilterOdm;
17+
use ApiPlatform\Doctrine\Orm\Filter\IriSearchFilter as IriSearchFilterOrm;
18+
use ApiPlatform\Metadata\Exception\InvalidArgumentException;
19+
use ApiPlatform\Metadata\Exception\ItemNotFoundException;
20+
use ApiPlatform\Metadata\IriConverterInterface;
21+
use ApiPlatform\Metadata\Operation;
22+
use ApiPlatform\Metadata\Parameter;
23+
use ApiPlatform\State\ParameterProviderInterface;
24+
use Psr\Log\LoggerInterface;
25+
26+
final readonly class IriConverterParameterProvider implements ParameterProviderInterface
27+
{
28+
public function __construct(
29+
private IriConverterInterface $iriConverter,
30+
private LoggerInterface $logger,
31+
) {
32+
}
33+
34+
public function provide(Parameter $parameter, array $parameters = [], array $context = []): ?Operation
35+
{
36+
$operation = $context['operation'] ?? null;
37+
$value = $parameter->getValue();
38+
$filter = $parameter->getFilter();
39+
40+
if (!$parameter->getValue() || (!$filter instanceof IriSearchFilterOrm && !$filter instanceof IriSearchFilterOdm)) {
41+
return $operation;
42+
}
43+
44+
$iri = $context['request']->getRequestUri() ?? null;
45+
if (null === $iri) {
46+
return $operation;
47+
}
48+
49+
try {
50+
$resource = $this->iriConverter->getResourceFromIri($value, $context);
51+
52+
$operation = $operation->withExtraProperties(array_merge(
53+
$operation->getExtraProperties() ?? [],
54+
['_value' => $resource]
55+
));
56+
} catch (InvalidArgumentException|ItemNotFoundException $e) {
57+
$this->logger->error(\sprintf('Invalid IRI "%s": %s', $iri, $e->getMessage()));
58+
59+
return null;
60+
}
61+
62+
return $operation;
63+
}
64+
}

‎src/Symfony/Bundle/Resources/config/doctrine_mongodb_odm.xml

+13
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,19 @@
4747
<argument type="collection"></argument>
4848
</service>
4949

50+
<service id="api_platform.doctrine_mongodb.odm.iri_search_filter" class="ApiPlatform\Doctrine\Odm\Filter\IriSearchFilter" public="false" abstract="true">
51+
<argument type="service" id="api_platform.iri_converter"/>
52+
<argument type="service" id="logger" on-invalid="ignore"/>
53+
<argument type="service" id="doctrine_mongodb"/>
54+
<argument key="$nameConverter" type="service" id="api_platform.name_converter" on-invalid="ignore"/>
55+
</service>
56+
57+
<service id="ApiPlatform\Doctrine\Odm\Filter\IriSearchFilter" alias="api_platform.doctrine_mongodb.odm.iri_search_filter"/>
58+
59+
<service id="api_platform.doctrine_mongodb.odm.iri_search_filter.instance" parent="api_platform.doctrine_mongodb.odm.iri_search_filter">
60+
<argument type="collection"/>
61+
</service>
62+
5063
<service id="api_platform.doctrine_mongodb.odm.boolean_filter" class="ApiPlatform\Doctrine\Odm\Filter\BooleanFilter" public="false" abstract="true">
5164
<argument type="service" id="doctrine_mongodb" />
5265
<argument type="service" id="logger" on-invalid="ignore" />

‎src/Symfony/Bundle/Resources/config/doctrine_orm.xml

+8
Original file line numberDiff line numberDiff line change
@@ -199,6 +199,14 @@
199199
<argument type="collection"></argument>
200200
</service>
201201

202+
<service id="api_platform.doctrine.orm.iri_search_filter" class="ApiPlatform\Doctrine\Orm\Filter\IriSearchFilter" public="false">
203+
<argument type="service" id="doctrine"/>
204+
<argument type="service" id="logger" on-invalid="ignore"/>
205+
<argument key="$nameConverter" type="service" id="api_platform.name_converter" on-invalid="ignore"/>
206+
207+
<tag name="api_platform.filter" priority="-100"/>
208+
</service>
209+
202210
<service id="api_platform.doctrine.orm.metadata.resource.metadata_collection_factory" class="ApiPlatform\Doctrine\Orm\Metadata\Resource\DoctrineOrmResourceCollectionMetadataFactory" decorates="api_platform.metadata.resource.metadata_collection_factory" decoration-priority="40">
203211
<argument type="service" id="doctrine" />
204212
<argument type="service" id="api_platform.doctrine.orm.metadata.resource.metadata_collection_factory.inner" />

‎src/Symfony/Bundle/Resources/config/state/provider.xml

+8
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,14 @@
1818
<argument type="service" id="api_platform.serializer.context_builder" />
1919
</service>
2020

21+
<service id="api_platform.state_provider.iri_converter_parameter" class="ApiPlatform\State\Provider\IriConverterParameterProvider" public="false">
22+
<argument type="service" id="api_platform.iri_converter"/>
23+
<argument type="service" id="logger" />
24+
<argument type="service" id="api_platform.api.identifiers_extractor" />
25+
26+
<tag name="api_platform.parameter_provider" key="api_platform.state_provider.iri_converter_parameter" priority="-895" />
27+
</service>
28+
2129
<service id="api_platform.state_provider.deserialize" class="ApiPlatform\State\Provider\DeserializeProvider" decorates="api_platform.state_provider.main" decoration-priority="300">
2230
<argument type="service" id="api_platform.state_provider.deserialize.inner" />
2331
<argument type="service" id="api_platform.serializer" />

‎src/Symfony/Bundle/Resources/config/symfony/events.xml

+8
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,14 @@
3333
<tag name="kernel.event_listener" event="kernel.request" method="onKernelRequest" priority="4" />
3434
</service>
3535

36+
<service id="api_platform.state_provider.iri_converter_parameter" class="ApiPlatform\State\Provider\IriConverterParameterProvider" public="false">
37+
<argument type="service" id="api_platform.iri_converter"/>
38+
<argument type="service" id="logger" />
39+
<argument type="service" id="api_platform.api.identifiers_extractor" />
40+
41+
<tag name="api_platform.parameter_provider" key="api_platform.state_provider.iri_converter_parameter" priority="-895" />
42+
</service>
43+
3644
<service id="api_platform.state_provider.deserialize" class="ApiPlatform\State\Provider\DeserializeProvider">
3745
<argument>null</argument>
3846
<argument type="service" id="api_platform.serializer" />

0 commit comments

Comments
 (0)