Liste aller Unterseiten in PHP erhalten oder Alternative zu QueryGenerator->getTreeList

Eine Alternative zu dieser Funktion könnt ihr mit dem TYPO3 QueryBuilder schnell selber zaubern. Diese kann dann so oder so ähnlich aussehen:

<?php

declare(strict_types=1);
namespace In2code\Lux\Domain\Repository;

use Doctrine\DBAL\DBALException;
use Doctrine\DBAL\Driver\Exception as ExceptionDbalDriver;
use PDO;
use TYPO3\CMS\Core\Database\ConnectionPool;
use TYPO3\CMS\Core\Database\Query\Restriction\DeletedRestriction;
use TYPO3\CMS\Core\Database\Query\Restriction\HiddenRestriction;
use TYPO3\CMS\Core\Utility\GeneralUtility;

class PageRepository extends AbstractRepository
{
    const TABLE_NAME = 'pages';
    
    /**
     * Successor of TYPO3\CMS\Core\Database\QueryGenerator->getTreeList as it was removed in TYPO3 12
     *
     * @param int $pageIdentifier Start page identifier
     * @param bool $addStart Add start page identifier to list
     * @param bool $addHidden Should records with pages.hidden=1 be added?
     * @return array
     * @throws DBALException
     * @throws ExceptionDbalDriver
     */
    public function getAllSubpageIdentifiers(int $pageIdentifier, bool $addStart = true, bool $addHidden = true): array
    {
        $identifiers = [];
        if ($addStart === true) {
            $identifiers[] = $pageIdentifier;
        }
        foreach ($this->getChildrenPageIdentifiers($pageIdentifier, $addHidden) as $identifier) {
            $identifiers = array_merge($identifiers, $this->getAllSubpageIdentifiers($identifier, true, $addHidden));
        }
        return $identifiers;
    }

    /**
     * @param int $pageIdentifier
     * @param bool $addHidden
     * @return array
     * @throws DBALException
     * @throws ExceptionDbalDriver
     */
    protected function getChildrenPageIdentifiers(int $pageIdentifier, bool $addHidden): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)->getQueryBuilderForTable(self::TABLE_NAME);
        $queryBuilder->getRestrictions()->removeAll();
        $queryBuilder->getRestrictions()->add(GeneralUtility::makeInstance(DeletedRestriction::class));
        $queryBuilder
            ->select('uid', 'uid')
            ->from(self::TABLE_NAME)
            ->where(
                $queryBuilder->expr()->eq(
                    'pid',
                    $queryBuilder->createNamedParameter($pageIdentifier, PDO::PARAM_INT)
                ),
                $queryBuilder->expr()->eq('sys_language_uid', 0)
            );
        if ($addHidden === false) {
            $queryBuilder->getRestrictions()->add(GeneralUtility::makeInstance(HiddenRestriction::class));
        }
        $result = $queryBuilder->execute()->fetchAllKeyValue();
        return array_values($result);
    }
}

Dieses Code-Beispiel wurde (leicht modifiziert) aus der Extension LUX entnommen. Hierbei wird die Startfunktion getAllSubpageIdentifiers() rekursiv aufgerufen, bis alle Unterseiten hinzugefügt wurden. Als Parameter muss mindestens die Startseiten UID übergeben werden.

Die Deprecation Notice zur QueryGenerator Klasse findet ihr übrigens in der TYPO3 Dokumentation.