shipmonk / doctrine-query-checker
Doctrine Query AST validator
dev-master
2025-02-21 08:46 UTC
Requires
- php: ^8.1
- doctrine/dbal: ^4.0
- doctrine/orm: ^3.0
- psr/log: ^1.0 || ^2.0 || ^3.0
Requires (Dev)
- editorconfig-checker/editorconfig-checker: ^10.6.0
- ergebnis/composer-normalize: ^2.42.0
- nette/utils: ^4.0
- phpstan/phpstan: ^2.0
- phpstan/phpstan-phpunit: ^2.0
- phpstan/phpstan-strict-rules: ^2.0
- phpunit/phpunit: ^10.5
- ramsey/uuid: ^4.7.6
- ramsey/uuid-doctrine: ^2.1.0
- shipmonk/composer-dependency-analyser: ^1.8
- shipmonk/name-collision-detector: ^2.1
- shipmonk/phpstan-rules: ^4.1
- slevomat/coding-standard: ^8.15
- symfony/cache: ^6.4 || ^7.0
This package is auto-updated.
Last update: 2025-02-21 11:28:39 UTC
README
Doctrine Query Tree Walker that perform additional checks on the query AST in addition to the default checks performed by Doctrine.
Currently it checks that the types of the parameters passed to the query are correct. For example the following will result in exception:
// throws 'Parameter "created_at" is of type "string", but expected "datetime" (because it\'s used in expression with u.createdAt)' $this->entityManager->createQueryBuilder() ->select('u') ->from(User::class, 'u') ->where('u.createdAt < :created_at') ->setParameter('created_at', 'not a date') ->getQuery() ->setHint(Query::HINT_CUSTOM_TREE_WALKERS, [QueryCheckerTreeWalker::class]); ->getResult();
If you want to log the exceptions instead of throwing them, you can pass a logger to the QueryCheckerTreeWalker:
QueryCheckerTreeWalker::setLogger($logger);
Installation
composer require shipmonk/doctrine-query-checker
Enabling for a specific query
use Doctrine\ORM\Query; use ShipMonk\DoctrineQueryChecker\QueryCheckerTreeWalker; $query = $this->entityManager->createQueryBuilder() ->select('u') ->from(User::class, 'u') ->getQuery() ->setHint(Query::HINT_CUSTOM_TREE_WALKERS, [QueryCheckerTreeWalker::class]);
Enabling for all queries
use Doctrine\ORM\Query; use ShipMonk\DoctrineQueryChecker\QueryCheckerTreeWalker; $this->entityManager->getConfiguration() ->setDefaultQueryHint(Query::HINT_CUSTOM_TREE_WALKERS, [QueryCheckerTreeWalker::class]);