shipmonk/doctrine-hint-driven-sql-walker

Doctrine's SqlWalker that allows hooking multiple handlers via ->setHint() while each can edit produced SQL or its part.

1.0.0 2024-01-23 15:55 UTC

Requires

• php: ^7.2 || ^8.0
• doctrine/orm: ^2.14.0

Requires (Dev)

• doctrine/annotations: ^2.0.1
• doctrine/dbal: ^2.10 || ^3.7
• doctrine/event-manager: ^1.2 || ^2.0
• editorconfig-checker/editorconfig-checker: ^10.4.0
• ergebnis/composer-normalize: ^2.19.0
• phpstan/phpstan: ^1.10.50
• phpstan/phpstan-phpunit: ^1.3.15
• phpstan/phpstan-strict-rules: ^1.5.2
• phpunit/phpunit: ^8.5.36
• shipmonk/composer-dependency-analyser: ^1.0
• slevomat/coding-standard: ^8.14.1

MIT

README

Since Doctrine's SqlWalker serves as a translator from DQL AST to SQL, it becomes problematic when you want to alter resulting SQL within multiple libraries by such approach. There just can be only single SqlWalker.

This library solves this issue, by providing HintHandler base class which is designed for SQL modification and can be used multiple times in $queryBuilder->setHint().

Installation:

composer require shipmonk/doctrine-hint-driven-sql-walker

Usage:

$queryBuilder
    ->setHint(Query::HINT_CUSTOM_OUTPUT_WALKER, HintDrivenSqlWalker::class)
    ->setHint(MaxExecutionTimeHintHandler::class, 1000)

Where MaxExecutionTimeHintHandler just extends our HintHandler and picks some SqlNode to hook to and alters appropriate SQL part:

class MaxExecutionTimeSqlWalker extends HintHandler
{

    public function getNodes(): array
    {
        return [SqlNode::SelectClause];
    }

    public function processNode(
        SqlNode $sqlNode,
        string $sql,
    ): string
    {
        // grab the 1000 passed to ->setHint()
        $milliseconds = $this->getHintValue();

        // edit SQL as needed
        return preg_replace(
            '~^SELECT (.*?)~',
            "SELECT /*+ MAX_EXECUTION_TIME($milliseconds) */ \\1 ",
            $sql
        );
    }

SqlNode is an enum of all walkXxx methods in Doctrine's SqlWalker, so you are able to intercept any part of AST processing the SqlWalker does.

Implementors

• shipmonk/doctrine-mysql-optimizer-hints (since v2)
• shipmonk/doctrine-mysql-index-hints (since v3)

Compatibility

Version	PHP Compatibility	doctrine/orm
v1	7.2 - 8.3	2.x
v2	8.1 - 8.3	3.x