CompositeExpression.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Database\Query\Expression;
 
use Doctrine\DBAL\Query\Expression\CompositeExpression as DoctrineCompositeExpression;
 
class ‪CompositeExpression extends DoctrineCompositeExpression
{
    private array ‪$parts = [];
 
    private string ‪$type;
 
    public function ‪__construct(‪$type, array ‪$parts = [])
    {
        // Pass empty parts to parent constructor as we have borrowed nearly all method to this level because of their
        // private visibility nature.
        parent::__construct((string)‪$type, []);
        $this->type = (string)‪$type;
        if (‪$parts !== []) {
            // doctrine/dbal solved the issue to avoid empty parts by making it mandatory to avoid instantiating this
            // class without a part. As we allow this and handle empty parts later on, we apply the empty check here.
            // @see https://github.com/doctrine/dbal/issues/2388
            array_filter(‪$parts, static fn(‪CompositeExpression|DoctrineCompositeExpression|string $value): bool => !(($value instanceof DoctrineCompositeExpression) ? $value->count() === 0 : empty($value)));
        }
        $this->parts = ‪$parts;
    }
 
    public static function ‪and($part = null, ...‪$parts): self
    {
        $mergedParts = array_merge([$part], ‪$parts);
        array_filter($mergedParts, static fn(‪CompositeExpression|DoctrineCompositeExpression|string|null $value): bool => !(($value instanceof DoctrineCompositeExpression) ? $value->count() === 0 : empty($value)));
        return (new self(self::TYPE_AND, []))->with(...$mergedParts);
    }
 
    public static function ‪or($part = null, ...‪$parts): self
    {
        $mergedParts = array_merge([$part], ‪$parts);
        array_filter($mergedParts, static fn(‪CompositeExpression|DoctrineCompositeExpression|string|null $value): bool => !(($value instanceof DoctrineCompositeExpression) ? $value->count() === 0 : empty($value)));
        return (new self(self::TYPE_OR, []))->with(...$mergedParts);
    }
 
    public function ‪with($part = null, ...‪$parts): self
    {
        $mergedParts = array_merge([$part], ‪$parts);
        $that = clone $this;
        foreach ($mergedParts as $singlePart) {
            // Due to a bug in Doctrine DBAL, we must add our own check here,
            // which we luckily can, as we use a subclass anyway.
            // @see https://github.com/doctrine/dbal/issues/2388
            $isEmpty = (($singlePart instanceof DoctrineCompositeExpression) ? $singlePart->count() === 0 : empty($singlePart));
            if (!$isEmpty) {
                $that->parts[] = $singlePart;
            }
        }
 
        return $that;
    }
 
    public function ‪count(): int
    {
        return ‪count($this->parts);
    }
 
    public function ‪getType(): string
    {
        return ‪$this->type;
    }
 
    public function ‪__toString(): string
    {
        if ($this->‪count() === 0) {
            return '';
        }
        if ($this->‪count() === 1) {
            return (string)$this->parts[0];
        }
        return '((' . implode(') ' . $this->type . ' (', $this->parts) . '))';
    }
}