vendor/contao/core-bundle/src/Resources/contao/models/PageModel.php line 1508

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of Contao.
  5.  *
  6.  * (c) Leo Feyer
  7.  *
  8.  * @license LGPL-3.0-or-later
  9.  */
  11. namespace Contao;
  13. use Contao\CoreBundle\Exception\NoRootPageFoundException;
  14. use Contao\CoreBundle\Routing\Page\PageRoute;
  15. use Contao\CoreBundle\Routing\ResponseContext\HtmlHeadBag\HtmlHeadBag;
  16. use Contao\CoreBundle\Routing\ResponseContext\JsonLd\ContaoPageSchema;
  17. use Contao\CoreBundle\Routing\ResponseContext\JsonLd\JsonLdManager;
  18. use Contao\CoreBundle\Util\LocaleUtil;
  19. use Contao\Model\Collection;
  20. use Contao\Model\Registry;
  21. use Symfony\Cmf\Component\Routing\RouteObjectInterface;
  22. use Symfony\Component\Routing\Exception\ResourceNotFoundException;
  23. use Symfony\Component\Routing\Exception\RouteNotFoundException;
  24. use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
  26. /**
  27.  * Reads and writes pages
  28.  *
  29.  * @property string|integer         $id
  30.  * @property string|integer         $pid
  31.  * @property string|integer         $sorting
  32.  * @property string|integer         $tstamp
  33.  * @property string                 $title
  34.  * @property string                 $alias
  35.  * @property string                 $type
  36.  * @property string|integer         $routePriority
  37.  * @property string                 $pageTitle
  38.  * @property string                 $language
  39.  * @property string                 $robots
  40.  * @property string|null            $description
  41.  * @property string                 $redirect
  42.  * @property string|boolean         $alwaysForward
  43.  * @property string|integer         $jumpTo
  44.  * @property string|boolean         $redirectBack
  45.  * @property string                 $url
  46.  * @property string|boolean         $target
  47.  * @property string                 $dns
  48.  * @property string                 $staticFiles
  49.  * @property string                 $staticPlugins
  50.  * @property string|boolean         $fallback
  51.  * @property string|boolean         $disableLanguageRedirect
  52.  * @property string|boolean         $maintenanceMode
  53.  * @property string|null            $favicon
  54.  * @property string|null            $robotsTxt
  55.  * @property string                 $mailerTransport
  56.  * @property string|integer         $enableCanonical
  57.  * @property string                 $canonicalLink
  58.  * @property string                 $canonicalKeepParams
  59.  * @property string                 $adminEmail
  60.  * @property string                 $dateFormat
  61.  * @property string                 $timeFormat
  62.  * @property string                 $datimFormat
  63.  * @property string                 $validAliasCharacters
  64.  * @property string|boolean         $useFolderUrl
  65.  * @property string                 $urlPrefix
  66.  * @property string                 $urlSuffix
  67.  * @property string|boolean         $useSSL
  68.  * @property string|boolean         $autoforward
  69.  * @property string|boolean         $protected
  70.  * @property string|array|null      $groups
  71.  * @property string|boolean         $includeLayout
  72.  * @property string|integer         $layout
  73.  * @property string|integer         $subpageLayout
  74.  * @property string|boolean         $includeCache
  75.  * @property string|integer|boolean $cache
  76.  * @property string|boolean         $alwaysLoadFromCache
  77.  * @property string|integer|boolean $clientCache
  78.  * @property string|boolean         $includeChmod
  79.  * @property string|integer         $cuser
  80.  * @property string|integer         $cgroup
  81.  * @property string                 $chmod
  82.  * @property string|boolean         $noSearch
  83.  * @property string|boolean         $requireItem
  84.  * @property string                 $cssClass
  85.  * @property string                 $sitemap
  86.  * @property string|boolean         $hide
  87.  * @property string|boolean         $guests
  88.  * @property string|integer         $tabindex
  89.  * @property string                 $accesskey
  90.  * @property string|boolean         $published
  91.  * @property string|integer         $start
  92.  * @property string|integer         $stop
  93.  * @property string|boolean         $enforceTwoFactor
  94.  * @property string|integer         $twoFactorJumpTo
  95.  *
  96.  * @property array          $trail
  97.  * @property string         $mainAlias
  98.  * @property string         $mainTitle
  99.  * @property string         $mainPageTitle
  100.  * @property string         $parentAlias
  101.  * @property string         $parentTitle
  102.  * @property string         $parentPageTitle
  103.  * @property string         $folderUrl
  104.  * @property boolean        $isPublic
  105.  * @property integer        $rootId
  106.  * @property string         $rootAlias
  107.  * @property string         $rootTitle
  108.  * @property string         $rootPageTitle
  109.  * @property integer        $rootSorting
  110.  * @property string         $domain
  111.  * @property string         $rootLanguage
  112.  * @property boolean        $rootIsPublic
  113.  * @property boolean        $rootIsFallback
  114.  * @property string|boolean $rootUseSSL
  115.  * @property string         $rootFallbackLanguage
  116.  * @property boolean        $minifyMarkup
  117.  * @property integer        $layoutId
  118.  * @property boolean        $hasJQuery
  119.  * @property boolean        $hasMooTools
  120.  * @property string         $template
  121.  * @property string         $templateGroup
  122.  * @property boolean        $useAutoItem
  123.  *
  124.  * @method static PageModel|null findById($id, array $opt=array())
  125.  * @method static PageModel|null findByPk($id, array $opt=array())
  126.  * @method static PageModel|null findByIdOrAlias($val, array $opt=array())
  127.  * @method static PageModel|null findOneBy($col, $val, array $opt=array())
  128.  * @method static PageModel|null findOneByPid($val, array $opt=array())
  129.  * @method static PageModel|null findOneBySorting($val, array $opt=array())
  130.  * @method static PageModel|null findOneByTstamp($val, array $opt=array())
  131.  * @method static PageModel|null findOneByTitle($val, array $opt=array())
  132.  * @method static PageModel|null findOneByAlias($val, array $opt=array())
  133.  * @method static PageModel|null findOneByType($val, array $opt=array())
  134.  * @method static PageModel|null findOneByRoutePriority($val, array $opt=array())
  135.  * @method static PageModel|null findOneByPageTitle($val, array $opt=array())
  136.  * @method static PageModel|null findOneByLanguage($val, array $opt=array())
  137.  * @method static PageModel|null findOneByRobots($val, array $opt=array())
  138.  * @method static PageModel|null findOneByDescription($val, array $opt=array())
  139.  * @method static PageModel|null findOneByRedirect($val, array $opt=array())
  140.  * @method static PageModel|null findOneByAlwaysForward($val, array $opt=array())
  141.  * @method static PageModel|null findOneByJumpTo($val, array $opt=array())
  142.  * @method static PageModel|null findOneByRedirectBack($val, array $opt=array())
  143.  * @method static PageModel|null findOneByUrl($val, array $opt=array())
  144.  * @method static PageModel|null findOneByTarget($val, array $opt=array())
  145.  * @method static PageModel|null findOneByDns($val, array $opt=array())
  146.  * @method static PageModel|null findOneByStaticFiles($val, array $opt=array())
  147.  * @method static PageModel|null findOneByStaticPlugins($val, array $opt=array())
  148.  * @method static PageModel|null findOneByFallback($val, array $opt=array())
  149.  * @method static PageModel|null findOneByDisableLanguageRedirect($val, array $opt=array())
  150.  * @method static PageModel|null findOneByFavicon($val, array $opt=array())
  151.  * @method static PageModel|null findOneByRobotsTxt($val, array $opt=array())
  152.  * @method static PageModel|null findOneByMailerTransport($val, array $opt=array())
  153.  * @method static PageModel|null findOneByEnableCanonical($val, array $opt=array())
  154.  * @method static PageModel|null findOneByCanonicalLink($val, array $opt=array())
  155.  * @method static PageModel|null findOneByCanonicalKeepParams($val, array $opt=array())
  156.  * @method static PageModel|null findOneByAdminEmail($val, array $opt=array())
  157.  * @method static PageModel|null findOneByDateFormat($val, array $opt=array())
  158.  * @method static PageModel|null findOneByTimeFormat($val, array $opt=array())
  159.  * @method static PageModel|null findOneByDatimFormat($val, array $opt=array())
  160.  * @method static PageModel|null findOneByValidAliasCharacters($val, array $opt=array())
  161.  * @method static PageModel|null findOneByUseFolderUrl($val, array $opt=array())
  162.  * @method static PageModel|null findOneByUrlPrefix($val, array $opt=array())
  163.  * @method static PageModel|null findOneByUrlSuffix($val, array $opt=array())
  164.  * @method static PageModel|null findOneByUseSSL($val, array $opt=array())
  165.  * @method static PageModel|null findOneByAutoforward($val, array $opt=array())
  166.  * @method static PageModel|null findOneByProtected($val, array $opt=array())
  167.  * @method static PageModel|null findOneByGroups($val, array $opt=array())
  168.  * @method static PageModel|null findOneByIncludeLayout($val, array $opt=array())
  169.  * @method static PageModel|null findOneByLayout($val, array $opt=array())
  170.  * @method static PageModel|null findOneBySubpageLayout($val, array $opt=array())
  171.  * @method static PageModel|null findOneByIncludeCache($val, array $opt=array())
  172.  * @method static PageModel|null findOneByCache($val, array $opt=array())
  173.  * @method static PageModel|null findOneByIncludeChmod($val, array $opt=array())
  174.  * @method static PageModel|null findOneByCuser($val, array $opt=array())
  175.  * @method static PageModel|null findOneByCgroup($val, array $opt=array())
  176.  * @method static PageModel|null findOneByChmod($val, array $opt=array())
  177.  * @method static PageModel|null findOneByNoSearch($val, array $opt=array())
  178.  * @method static PageModel|null findOneByCssClass($val, array $opt=array())
  179.  * @method static PageModel|null findOneBySitemap($val, array $opt=array())
  180.  * @method static PageModel|null findOneByHide($val, array $opt=array())
  181.  * @method static PageModel|null findOneByGuests($val, array $opt=array())
  182.  * @method static PageModel|null findOneByTabindex($val, array $opt=array())
  183.  * @method static PageModel|null findOneByAccesskey($val, array $opt=array())
  184.  * @method static PageModel|null findOneByPublished($val, array $opt=array())
  185.  * @method static PageModel|null findOneByStart($val, array $opt=array())
  186.  * @method static PageModel|null findOneByStop($val, array $opt=array())
  187.  * @method static PageModel|null findOneByEnforceTwoFactor($val, array $opt=array())
  188.  * @method static PageModel|null findOneByTwoFactorJumpTo($val, array $opt=array())
  189.  *
  190.  * @method static Collection|PageModel[]|PageModel|null findByPid($val, array $opt=array())
  191.  * @method static Collection|PageModel[]|PageModel|null findBySorting($val, array $opt=array())
  192.  * @method static Collection|PageModel[]|PageModel|null findByTstamp($val, array $opt=array())
  193.  * @method static Collection|PageModel[]|PageModel|null findByTitle($val, array $opt=array())
  194.  * @method static Collection|PageModel[]|PageModel|null findByAlias($val, array $opt=array())
  195.  * @method static Collection|PageModel[]|PageModel|null findByType($val, array $opt=array())
  196.  * @method static Collection|PageModel[]|PageModel|null findByRoutePriority($val, array $opt=array())
  197.  * @method static Collection|PageModel[]|PageModel|null findByPageTitle($val, array $opt=array())
  198.  * @method static Collection|PageModel[]|PageModel|null findByLanguage($val, array $opt=array())
  199.  * @method static Collection|PageModel[]|PageModel|null findByRobots($val, array $opt=array())
  200.  * @method static Collection|PageModel[]|PageModel|null findByDescription($val, array $opt=array())
  201.  * @method static Collection|PageModel[]|PageModel|null findByRedirect($val, array $opt=array())
  202.  * @method static Collection|PageModel[]|PageModel|null findByAlwaysForward($val, array $opt=array())
  203.  * @method static Collection|PageModel[]|PageModel|null findByJumpTo($val, array $opt=array())
  204.  * @method static Collection|PageModel[]|PageModel|null findByRedirectBack($val, array $opt=array())
  205.  * @method static Collection|PageModel[]|PageModel|null findByUrl($val, array $opt=array())
  206.  * @method static Collection|PageModel[]|PageModel|null findByTarget($val, array $opt=array())
  207.  * @method static Collection|PageModel[]|PageModel|null findByDns($val, array $opt=array())
  208.  * @method static Collection|PageModel[]|PageModel|null findByStaticFiles($val, array $opt=array())
  209.  * @method static Collection|PageModel[]|PageModel|null findByStaticPlugins($val, array $opt=array())
  210.  * @method static Collection|PageModel[]|PageModel|null findByFallback($val, array $opt=array())
  211.  * @method static Collection|PageModel[]|PageModel|null findByDisableLanguageRedirect($val, array $opt=array())
  212.  * @method static Collection|PageModel[]|PageModel|null findByFavicon($val, array $opt=array())
  213.  * @method static Collection|PageModel[]|PageModel|null findByRobotsTxt($val, array $opt=array())
  214.  * @method static Collection|PageModel[]|PageModel|null findByMailerTransport($val, array $opt=array())
  215.  * @method static Collection|PageModel[]|PageModel|null findByEnableCanonical($val, array $opt=array())
  216.  * @method static Collection|PageModel[]|PageModel|null findByCanonicalLink($val, array $opt=array())
  217.  * @method static Collection|PageModel[]|PageModel|null findByCanonicalKeepParams($val, array $opt=array())
  218.  * @method static Collection|PageModel[]|PageModel|null findByAdminEmail($val, array $opt=array())
  219.  * @method static Collection|PageModel[]|PageModel|null findByDateFormat($val, array $opt=array())
  220.  * @method static Collection|PageModel[]|PageModel|null findByTimeFormat($val, array $opt=array())
  221.  * @method static Collection|PageModel[]|PageModel|null findByDatimFormat($val, array $opt=array())
  222.  * @method static Collection|PageModel[]|PageModel|null findByValidAliasCharacters($val, array $opt=array())
  223.  * @method static Collection|PageModel[]|PageModel|null findByUseFolderUrl($val, array $opt=array())
  224.  * @method static Collection|PageModel[]|PageModel|null findByUrlPrefix($val, array $opt=array())
  225.  * @method static Collection|PageModel[]|PageModel|null findByUrlSuffix($val, array $opt=array())
  226.  * @method static Collection|PageModel[]|PageModel|null findByUseSSL($val, array $opt=array())
  227.  * @method static Collection|PageModel[]|PageModel|null findByAutoforward($val, array $opt=array())
  228.  * @method static Collection|PageModel[]|PageModel|null findByProtected($val, array $opt=array())
  229.  * @method static Collection|PageModel[]|PageModel|null findByGroups($val, array $opt=array())
  230.  * @method static Collection|PageModel[]|PageModel|null findByIncludeLayout($val, array $opt=array())
  231.  * @method static Collection|PageModel[]|PageModel|null findByLayout($val, array $opt=array())
  232.  * @method static Collection|PageModel[]|PageModel|null findBySubpageLayout($val, array $opt=array())
  233.  * @method static Collection|PageModel[]|PageModel|null findByIncludeCache($val, array $opt=array())
  234.  * @method static Collection|PageModel[]|PageModel|null findByCache($val, array $opt=array())
  235.  * @method static Collection|PageModel[]|PageModel|null findByIncludeChmod($val, array $opt=array())
  236.  * @method static Collection|PageModel[]|PageModel|null findByCuser($val, array $opt=array())
  237.  * @method static Collection|PageModel[]|PageModel|null findByCgroup($val, array $opt=array())
  238.  * @method static Collection|PageModel[]|PageModel|null findByChmod($val, array $opt=array())
  239.  * @method static Collection|PageModel[]|PageModel|null findByNoSearch($val, array $opt=array())
  240.  * @method static Collection|PageModel[]|PageModel|null findByCssClass($val, array $opt=array())
  241.  * @method static Collection|PageModel[]|PageModel|null findBySitemap($val, array $opt=array())
  242.  * @method static Collection|PageModel[]|PageModel|null findByHide($val, array $opt=array())
  243.  * @method static Collection|PageModel[]|PageModel|null findByGuests($val, array $opt=array())
  244.  * @method static Collection|PageModel[]|PageModel|null findByTabindex($val, array $opt=array())
  245.  * @method static Collection|PageModel[]|PageModel|null findByAccesskey($val, array $opt=array())
  246.  * @method static Collection|PageModel[]|PageModel|null findByPublished($val, array $opt=array())
  247.  * @method static Collection|PageModel[]|PageModel|null findByStart($val, array $opt=array())
  248.  * @method static Collection|PageModel[]|PageModel|null findByStop($val, array $opt=array())
  249.  * @method static Collection|PageModel[]|PageModel|null findByEnforceTwoFactor($val, array $opt=array())
  250.  * @method static Collection|PageModel[]|PageModel|null findByTwoFactorJumpTo($val, array $opt=array())
  251.  * @method static Collection|PageModel[]|PageModel|null findMultipleByIds($val, array $opt=array())
  252.  * @method static Collection|PageModel[]|PageModel|null findBy($col, $val, array $opt=array())
  253.  * @method static Collection|PageModel[]|PageModel|null findAll(array $opt=array())
  254.  *
  255.  * @method static integer countById($id, array $opt=array())
  256.  * @method static integer countByPid($val, array $opt=array())
  257.  * @method static integer countBySorting($val, array $opt=array())
  258.  * @method static integer countByTstamp($val, array $opt=array())
  259.  * @method static integer countByTitle($val, array $opt=array())
  260.  * @method static integer countByAlias($val, array $opt=array())
  261.  * @method static integer countByType($val, array $opt=array())
  262.  * @method static integer countByRoutePriority($val, array $opt=array())
  263.  * @method static integer countByPageTitle($val, array $opt=array())
  264.  * @method static integer countByLanguage($val, array $opt=array())
  265.  * @method static integer countByRobots($val, array $opt=array())
  266.  * @method static integer countByDescription($val, array $opt=array())
  267.  * @method static integer countByRedirect($val, array $opt=array())
  268.  * @method static integer countByAlwaysForward($val, array $opt=array())
  269.  * @method static integer countByJumpTo($val, array $opt=array())
  270.  * @method static integer countByRedirectBack($val, array $opt=array())
  271.  * @method static integer countByUrl($val, array $opt=array())
  272.  * @method static integer countByTarget($val, array $opt=array())
  273.  * @method static integer countByDns($val, array $opt=array())
  274.  * @method static integer countByStaticFiles($val, array $opt=array())
  275.  * @method static integer countByStaticPlugins($val, array $opt=array())
  276.  * @method static integer countByFallback($val, array $opt=array())
  277.  * @method static integer countByDisableLanguageRedirect($val, array $opt=array())
  278.  * @method static integer countByFavicon($val, array $opt=array())
  279.  * @method static integer countByRobotsTxt($val, array $opt=array())
  280.  * @method static integer countByMailerTransport($val, array $opt=array())
  281.  * @method static integer countByEnableCanonical($val, array $opt=array())
  282.  * @method static integer countByCanonicalLink($val, array $opt=array())
  283.  * @method static integer countByCanonicalKeepParams($val, array $opt=array())
  284.  * @method static integer countByAdminEmail($val, array $opt=array())
  285.  * @method static integer countByDateFormat($val, array $opt=array())
  286.  * @method static integer countByTimeFormat($val, array $opt=array())
  287.  * @method static integer countByDatimFormat($val, array $opt=array())
  288.  * @method static integer countByValidAliasCharacters($val, array $opt=array())
  289.  * @method static integer countByUseFolderUrl($val, array $opt=array())
  290.  * @method static integer countByUrlPrefix($val, array $opt=array())
  291.  * @method static integer countByUrlSuffix($val, array $opt=array())
  292.  * @method static integer countByUseSSL($val, array $opt=array())
  293.  * @method static integer countByAutoforward($val, array $opt=array())
  294.  * @method static integer countByProtected($val, array $opt=array())
  295.  * @method static integer countByGroups($val, array $opt=array())
  296.  * @method static integer countByIncludeLayout($val, array $opt=array())
  297.  * @method static integer countByLayout($val, array $opt=array())
  298.  * @method static integer countBySubpageLayout($val, array $opt=array())
  299.  * @method static integer countByIncludeCache($val, array $opt=array())
  300.  * @method static integer countByCache($val, array $opt=array())
  301.  * @method static integer countByIncludeChmod($val, array $opt=array())
  302.  * @method static integer countByCuser($val, array $opt=array())
  303.  * @method static integer countByCgroup($val, array $opt=array())
  304.  * @method static integer countByChmod($val, array $opt=array())
  305.  * @method static integer countByNoSearch($val, array $opt=array())
  306.  * @method static integer countByCssClass($val, array $opt=array())
  307.  * @method static integer countBySitemap($val, array $opt=array())
  308.  * @method static integer countByHide($val, array $opt=array())
  309.  * @method static integer countByGuests($val, array $opt=array())
  310.  * @method static integer countByTabindex($val, array $opt=array())
  311.  * @method static integer countByAccesskey($val, array $opt=array())
  312.  * @method static integer countByPublished($val, array $opt=array())
  313.  * @method static integer countByStart($val, array $opt=array())
  314.  * @method static integer countByStop($val, array $opt=array())
  315.  * @method static integer countByEnforceTwoFactor($val, array $opt=array())
  316.  * @method static integer countByTwoFactorJumpTo($val, array $opt=array())
  317.  */
  318. class PageModel extends Model
  319. {
  320.     /**
  321.      * Table name
  322.      * @var string
  323.      */
  324.     protected static $strTable = 'tl_page';
  326.     /**
  327.      * Details loaded
  328.      * @var boolean
  329.      */
  330.     protected $blnDetailsLoaded = false;
  332.     private static ?array $prefixes = null;
  333.     private static ?array $suffixes = null;
  335.     public function __set($strKey, $varValue)
  336.     {
  337.         // Deprecate setting dynamic page attributes if they are set on the global $objPage
  338.         if (\in_array($strKey, array('pageTitle', 'description', 'robots', 'noSearch'), true) && ($GLOBALS['objPage'] ?? null) === $this)
  339.         {
  340.             trigger_deprecation('contao/core-bundle', '4.12', sprintf('Overriding "%s" is deprecated and will not work in Contao 5.0 anymore. Use the ResponseContext instead.', $strKey));
  342.             $responseContext = System::getContainer()->get('contao.routing.response_context_accessor')->getResponseContext();
  344.             if (!$responseContext)
  345.             {
  346.                 parent::__set($strKey, $varValue);
  348.                 return;
  349.             }
  351.             if (\in_array($strKey, array('pageTitle', 'description', 'robots')) && $responseContext->has(HtmlHeadBag::class))
  352.             {
  353.                 /** @var HtmlHeadBag $htmlHeadBag */
  354.                 $htmlHeadBag = $responseContext->get(HtmlHeadBag::class);
  355.                 $htmlDecoder = System::getContainer()->get('contao.string.html_decoder');
  357.                 switch ($strKey)
  358.                 {
  359.                     case 'pageTitle':
  360.                         $htmlHeadBag->setTitle($htmlDecoder->inputEncodedToPlainText($varValue ?? ''));
  361.                         break;
  363.                     case 'description':
  364.                         $htmlHeadBag->setMetaDescription($htmlDecoder->inputEncodedToPlainText($varValue ?? ''));
  365.                         break;
  367.                     case 'robots':
  368.                         $htmlHeadBag->setMetaRobots($varValue);
  369.                         break;
  370.                 }
  371.             }
  373.             if ('noSearch' === $strKey && $responseContext->has(JsonLdManager::class))
  374.             {
  375.                 /** @var JsonLdManager $jsonLdManager */
  376.                 $jsonLdManager = $responseContext->get(JsonLdManager::class);
  378.                 if ($jsonLdManager->getGraphForSchema(JsonLdManager::SCHEMA_CONTAO)->has(ContaoPageSchema::class))
  379.                 {
  380.                     /** @var ContaoPageSchema $schema */
  381.                     $schema = $jsonLdManager->getGraphForSchema(JsonLdManager::SCHEMA_CONTAO)->get(ContaoPageSchema::class);
  382.                     $schema->setNoSearch((bool) $varValue);
  383.                 }
  384.             }
  385.         }
  387.         parent::__set($strKey, $varValue);
  388.     }
  390.     public static function reset()
  391.     {
  392.         self::$prefixes = null;
  393.         self::$suffixes = null;
  394.     }
  396.     /**
  397.      * Find a published page by its ID
  398.      *
  399.      * @param integer $intId      The page ID
  400.      * @param array   $arrOptions An optional options array
  401.      *
  402.      * @return PageModel|null The model or null if there is no published page
  403.      */
  404.     public static function findPublishedById($intId, array $arrOptions=array())
  405.     {
  406.         $t = static::$strTable;
  407.         $arrColumns = array("$t.id=?");
  409.         if (!static::isPreviewMode($arrOptions))
  410.         {
  411.             $time = Date::floorToMinute();
  412.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  413.         }
  415.         return static::findOneBy($arrColumns, $intId, $arrOptions);
  416.     }
  418.     /**
  419.      * Find published pages by their PID
  420.      *
  421.      * @param integer $intPid     The parent ID
  422.      * @param array   $arrOptions An optional options array
  423.      *
  424.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  425.      */
  426.     public static function findPublishedByPid($intPid, array $arrOptions=array())
  427.     {
  428.         $t = static::$strTable;
  429.         $arrColumns = array("$t.pid=?");
  431.         if (!static::isPreviewMode($arrOptions))
  432.         {
  433.             $time = Date::floorToMinute();
  434.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  435.         }
  437.         return static::findBy($arrColumns, $intPid, $arrOptions);
  438.     }
  440.     /**
  441.      * Find the first published root page by its host name and language
  442.      *
  443.      * @param string $strHost     The host name
  444.      * @param mixed  $varLanguage An ISO language code or an array of ISO language codes
  445.      * @param array  $arrOptions  An optional options array
  446.      *
  447.      * @return PageModel|null The model or null if there is no matching root page
  448.      *
  449.      * @deprecated Deprecated since Contao 4.7, to be removed in Contao 5.0.
  450.      */
  451.     public static function findFirstPublishedRootByHostAndLanguage($strHost, $varLanguage, array $arrOptions=array())
  452.     {
  453.         trigger_deprecation('contao/core-bundle', '4.7', 'Using "Contao\PageModel::findFirstPublishedRootByHostAndLanguage()" has been deprecated and will no longer work Contao 5.0.');
  455.         $t = static::$strTable;
  456.         $objDatabase = Database::getInstance();
  458.         if (\is_array($varLanguage))
  459.         {
  460.             $arrColumns = array("$t.type='root' AND ($t.dns=? OR $t.dns='')");
  462.             if (!empty($varLanguage))
  463.             {
  464.                 $arrColumns[] = "($t.language IN('" . implode("','", $varLanguage) . "') OR $t.fallback='1')";
  465.             }
  466.             else
  467.             {
  468.                 $arrColumns[] = "$t.fallback='1'";
  469.             }
  471.             if (!isset($arrOptions['order']))
  472.             {
  473.                 $arrOptions['order'] = "$t.dns DESC" . (!empty($varLanguage) ? ", " . $objDatabase->findInSet("$t.language", array_reverse($varLanguage)) . " DESC" : "") . ", $t.sorting";
  474.             }
  476.             if (!static::isPreviewMode($arrOptions))
  477.             {
  478.                 $time = Date::floorToMinute();
  479.                 $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  480.             }
  482.             return static::findOneBy($arrColumns, $strHost, $arrOptions);
  483.         }
  485.         $arrColumns = array("$t.type='root' AND ($t.dns=? OR $t.dns='') AND ($t.language=? OR $t.fallback='1')");
  486.         $arrValues = array($strHost, $varLanguage);
  488.         if (!isset($arrOptions['order']))
  489.         {
  490.             $arrOptions['order'] = "$t.dns DESC, $t.fallback";
  491.         }
  493.         if (!static::isPreviewMode($arrOptions))
  494.         {
  495.             $time = Date::floorToMinute();
  496.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  497.         }
  499.         return static::findOneBy($arrColumns, $arrValues, $arrOptions);
  500.     }
  502.     /**
  503.      * Find the first published page by its parent ID
  504.      *
  505.      * @param integer $intPid     The parent page's ID
  506.      * @param array   $arrOptions An optional options array
  507.      *
  508.      * @return PageModel|null The model or null if there is no published page
  509.      */
  510.     public static function findFirstPublishedByPid($intPid, array $arrOptions=array())
  511.     {
  512.         $t = static::$strTable;
  513.         $unroutableTypes = System::getContainer()->get('contao.routing.page_registry')->getUnroutableTypes();
  514.         $arrColumns = array("$t.pid=? AND $t.type!='root' AND $t.type NOT IN ('" . implode("', '", $unroutableTypes) . "')");
  516.         if (!static::isPreviewMode($arrOptions))
  517.         {
  518.             $time = Date::floorToMinute();
  519.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  520.         }
  522.         if (!isset($arrOptions['order']))
  523.         {
  524.             $arrOptions['order'] = "$t.sorting";
  525.         }
  527.         return static::findOneBy($arrColumns, $intPid, $arrOptions);
  528.     }
  530.     /**
  531.      * Find the first published regular page by its parent ID
  532.      *
  533.      * @param integer $intPid     The parent page's ID
  534.      * @param array   $arrOptions An optional options array
  535.      *
  536.      * @return PageModel|null The model or null if there is no published regular page
  537.      */
  538.     public static function findFirstPublishedRegularByPid($intPid, array $arrOptions=array())
  539.     {
  540.         $t = static::$strTable;
  541.         $arrColumns = array("$t.pid=? AND $t.type='regular'");
  543.         if (!static::isPreviewMode($arrOptions))
  544.         {
  545.             $time = Date::floorToMinute();
  546.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  547.         }
  549.         if (!isset($arrOptions['order']))
  550.         {
  551.             $arrOptions['order'] = "$t.sorting";
  552.         }
  554.         return static::findOneBy($arrColumns, $intPid, $arrOptions);
  555.     }
  557.     /**
  558.      * Find the first published page by its type and parent ID
  559.      *
  560.      * @param string  $strType    The page type
  561.      * @param integer $intPid     The parent page's ID
  562.      * @param array   $arrOptions An optional options array
  563.      *
  564.      * @return PageModel|null The model or null if there is no published regular page
  565.      */
  566.     public static function findFirstPublishedByTypeAndPid($strType, $intPid, array $arrOptions=array())
  567.     {
  568.         $t = static::$strTable;
  569.         $arrColumns = array("$t.pid=? AND $t.type=?");
  571.         if (!static::isPreviewMode($arrOptions))
  572.         {
  573.             $time = Date::floorToMinute();
  574.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  575.         }
  577.         if (!isset($arrOptions['order']))
  578.         {
  579.             $arrOptions['order'] = "$t.sorting";
  580.         }
  582.         return static::findOneBy($arrColumns, array($intPid, $strType), $arrOptions);
  583.     }
  585.     /**
  586.      * Find an error 401 page by its parent ID
  587.      *
  588.      * @param integer $intPid     The parent page's ID
  589.      * @param array   $arrOptions An optional options array
  590.      *
  591.      * @return PageModel|null The model or null if there is no 401 page
  592.      */
  593.     public static function find401ByPid($intPid, array $arrOptions=array())
  594.     {
  595.         $t = static::$strTable;
  596.         $arrColumns = array("$t.pid=? AND $t.type='error_401'");
  598.         if (!static::isPreviewMode($arrOptions))
  599.         {
  600.             $time = Date::floorToMinute();
  601.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  602.         }
  604.         if (!isset($arrOptions['order']))
  605.         {
  606.             $arrOptions['order'] = "$t.sorting";
  607.         }
  609.         return static::findOneBy($arrColumns, $intPid, $arrOptions);
  610.     }
  612.     /**
  613.      * Find an error 403 page by its parent ID
  614.      *
  615.      * @param integer $intPid     The parent page's ID
  616.      * @param array   $arrOptions An optional options array
  617.      *
  618.      * @return PageModel|null The model or null if there is no 403 page
  619.      */
  620.     public static function find403ByPid($intPid, array $arrOptions=array())
  621.     {
  622.         $t = static::$strTable;
  623.         $arrColumns = array("$t.pid=? AND $t.type='error_403'");
  625.         if (!static::isPreviewMode($arrOptions))
  626.         {
  627.             $time = Date::floorToMinute();
  628.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  629.         }
  631.         if (!isset($arrOptions['order']))
  632.         {
  633.             $arrOptions['order'] = "$t.sorting";
  634.         }
  636.         return static::findOneBy($arrColumns, $intPid, $arrOptions);
  637.     }
  639.     /**
  640.      * Find an error 404 page by its parent ID
  641.      *
  642.      * @param integer $intPid     The parent page's ID
  643.      * @param array   $arrOptions An optional options array
  644.      *
  645.      * @return PageModel|null The model or null if there is no 404 page
  646.      */
  647.     public static function find404ByPid($intPid, array $arrOptions=array())
  648.     {
  649.         $t = static::$strTable;
  650.         $arrColumns = array("$t.pid=? AND $t.type='error_404'");
  652.         if (!static::isPreviewMode($arrOptions))
  653.         {
  654.             $time = Date::floorToMinute();
  655.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  656.         }
  658.         if (!isset($arrOptions['order']))
  659.         {
  660.             $arrOptions['order'] = "$t.sorting";
  661.         }
  663.         return static::findOneBy($arrColumns, $intPid, $arrOptions);
  664.     }
  666.     /**
  667.      * Find pages matching a list of possible alias names
  668.      *
  669.      * @param array $arrAliases An array of possible alias names
  670.      * @param array $arrOptions An optional options array
  671.      *
  672.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  673.      */
  674.     public static function findByAliases($arrAliases, array $arrOptions=array())
  675.     {
  676.         if (empty($arrAliases) || !\is_array($arrAliases))
  677.         {
  678.             return null;
  679.         }
  681.         // Remove everything that is not an alias
  682.         $arrAliases = array_filter(array_map(static function ($v) { return preg_match('/^[\w\/.-]+$/u', $v) ? $v : null; }, $arrAliases));
  684.         // Return if nothing is left
  685.         if (empty($arrAliases))
  686.         {
  687.             return null;
  688.         }
  690.         $t = static::$strTable;
  691.         $arrColumns = array("$t.alias IN('" . implode("','", array_filter($arrAliases)) . "')");
  693.         // Check the publication status (see #4652)
  694.         if (!static::isPreviewMode($arrOptions))
  695.         {
  696.             $time = Date::floorToMinute();
  697.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  698.         }
  700.         if (!isset($arrOptions['order']))
  701.         {
  702.             $arrOptions['order'] = Database::getInstance()->findInSet("$t.alias", $arrAliases);
  703.         }
  705.         return static::findBy($arrColumns, null, $arrOptions);
  706.     }
  708.     /**
  709.      * Find pages that have a similar alias
  710.      *
  711.      * @return Collection|PageModel[]|null A collection of models or null if there are no pages
  712.      */
  713.     public static function findSimilarByAlias(self $pageModel)
  714.     {
  715.         if ('' === $pageModel->alias)
  716.         {
  717.             return null;
  718.         }
  720.         $pageModel->loadDetails();
  722.         $t = static::$strTable;
  723.         $alias = '%' . self::stripPrefixesAndSuffixes($pageModel->alias, $pageModel->urlPrefix, $pageModel->urlSuffix) . '%';
  725.         return static::findBy(array("$t.alias LIKE ?", "$t.id!=?"), array($alias, $pageModel->id));
  726.     }
  728.     /**
  729.      * Find published pages by their ID or aliases
  730.      *
  731.      * @param mixed $varId      The numeric ID or the alias name
  732.      * @param array $arrOptions An optional options array
  733.      *
  734.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  735.      */
  736.     public static function findPublishedByIdOrAlias($varId, array $arrOptions=array())
  737.     {
  738.         $t = static::$strTable;
  739.         $arrColumns = !preg_match('/^[1-9]\d*$/', $varId) ? array("BINARY $t.alias=?") : array("$t.id=?");
  741.         if (!static::isPreviewMode($arrOptions))
  742.         {
  743.             $time = Date::floorToMinute();
  744.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  745.         }
  747.         return static::findBy($arrColumns, $varId, $arrOptions);
  748.     }
  750.     /**
  751.      * Find all published subpages by their parent ID and exclude pages only visible for guests
  752.      *
  753.      * @param integer $intPid        The parent page's ID
  754.      * @param boolean $blnShowHidden If true, hidden pages will be included
  755.      * @param boolean $blnIsSitemap  If true, the sitemap settings apply
  756.      *
  757.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  758.      *
  759.      * @deprecated Deprecated since Contao 4.9, to be removed in Contao 5.0;
  760.      *             use PageModel::findPublishedByPid() instead and filter the guests pages yourself
  761.      */
  762.     public static function findPublishedSubpagesWithoutGuestsByPid($intPid, $blnShowHidden=false, $blnIsSitemap=false)
  763.     {
  764.         trigger_deprecation('contao/core-bundle', '4.9', 'Using PageModel::findPublishedSubpagesWithoutGuestsByPid() has been deprecated and will no longer work Contao 5.0. Use PageModel::findPublishedByPid() instead and filter the guests pages yourself.');
  766.         $time = Date::floorToMinute();
  767.         $tokenChecker = System::getContainer()->get('contao.security.token_checker');
  768.         $blnFeUserLoggedIn = $tokenChecker->hasFrontendUser();
  769.         $blnBeUserLoggedIn = $tokenChecker->isPreviewMode();
  770.         $unroutableTypes = System::getContainer()->get('contao.routing.page_registry')->getUnroutableTypes();
  772.         $objSubpages = Database::getInstance()->prepare("SELECT p1.*, (SELECT COUNT(*) FROM tl_page p2 WHERE p2.pid=p1.id AND p2.type!='root' AND p2.type NOT IN ('" . implode("', '", $unroutableTypes) . "')" . (!$blnShowHidden ? ($blnIsSitemap ? " AND (p2.hide='' OR sitemap='map_always')" : " AND p2.hide=''") : "") . ($blnFeUserLoggedIn ? " AND p2.guests=''" : "") . (!$blnBeUserLoggedIn ? " AND p2.published='1' AND (p2.start='' OR p2.start<=$time) AND (p2.stop='' OR p2.stop>$time)" : "") . ") AS subpages FROM tl_page p1 WHERE p1.pid=? AND p1.type!='root' AND p1.type NOT IN ('" . implode("', '", $unroutableTypes) . "')" . (!$blnShowHidden ? ($blnIsSitemap ? " AND (p1.hide='' OR sitemap='map_always')" : " AND p1.hide=''") : "") . ($blnFeUserLoggedIn ? " AND p1.guests=''" : "") . (!$blnBeUserLoggedIn ? " AND p1.published='1' AND (p1.start='' OR p1.start<=$time) AND (p1.stop='' OR p1.stop>$time)" : "") . " ORDER BY p1.sorting")
  773.                                               ->execute($intPid);
  775.         if ($objSubpages->numRows < 1)
  776.         {
  777.             return null;
  778.         }
  780.         return static::createCollectionFromDbResult($objSubpages, 'tl_page');
  781.     }
  783.     /**
  784.      * Find all published regular pages by their IDs
  785.      *
  786.      * @param array $arrIds     An array of page IDs
  787.      * @param array $arrOptions An optional options array
  788.      *
  789.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  790.      */
  791.     public static function findPublishedRegularByIds($arrIds, array $arrOptions=array())
  792.     {
  793.         if (empty($arrIds) || !\is_array($arrIds))
  794.         {
  795.             return null;
  796.         }
  798.         $t = static::$strTable;
  799.         $unroutableTypes = System::getContainer()->get('contao.routing.page_registry')->getUnroutableTypes();
  800.         $arrColumns = array("$t.id IN(" . implode(',', array_map('\intval', $arrIds)) . ") AND $t.type NOT IN ('" . implode("', '", $unroutableTypes) . "')");
  802.         if (empty($arrOptions['includeRoot']))
  803.         {
  804.             $arrColumns[] = "$t.type!='root'";
  805.         }
  807.         if (!static::isPreviewMode($arrOptions))
  808.         {
  809.             $time = Date::floorToMinute();
  810.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  811.         }
  813.         if (!isset($arrOptions['order']))
  814.         {
  815.             $arrOptions['order'] = Database::getInstance()->findInSet("$t.id", $arrIds);
  816.         }
  818.         return static::findBy($arrColumns, null, $arrOptions);
  819.     }
  821.     /**
  822.      * Find all published regular pages by their IDs and exclude pages only visible for guests
  823.      *
  824.      * @param array $arrIds     An array of page IDs
  825.      * @param array $arrOptions An optional options array
  826.      *
  827.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  828.      *
  829.      * @deprecated Deprecated since Contao 4.12, to be removed in Contao 5;
  830.      *             use PageModel::findPublishedRegularByIds() instead.
  831.      */
  832.     public static function findPublishedRegularWithoutGuestsByIds($arrIds, array $arrOptions=array())
  833.     {
  834.         trigger_deprecation('contao/core-bundle', '4.12', 'Using PageModel::findPublishedRegularWithoutGuestsByIds() has been deprecated and will no longer work in Contao 5.0. Use PageModel::findPublishedRegularByIds() instead.');
  836.         if (empty($arrIds) || !\is_array($arrIds))
  837.         {
  838.             return null;
  839.         }
  841.         $t = static::$strTable;
  842.         $unroutableTypes = System::getContainer()->get('contao.routing.page_registry')->getUnroutableTypes();
  843.         $arrColumns = array("$t.id IN(" . implode(',', array_map('\intval', $arrIds)) . ") AND $t.type NOT IN ('" . implode("', '", $unroutableTypes) . "')");
  845.         if (empty($arrOptions['includeRoot']))
  846.         {
  847.             $arrColumns[] = "$t.type!='root'";
  848.         }
  850.         if (System::getContainer()->get('contao.security.token_checker')->hasFrontendUser())
  851.         {
  852.             $arrColumns[] = "$t.guests=''";
  853.         }
  855.         if (!static::isPreviewMode($arrOptions))
  856.         {
  857.             $time = Date::floorToMinute();
  858.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  859.         }
  861.         if (!isset($arrOptions['order']))
  862.         {
  863.             $arrOptions['order'] = Database::getInstance()->findInSet("$t.id", $arrIds);
  864.         }
  866.         return static::findBy($arrColumns, null, $arrOptions);
  867.     }
  869.     /**
  870.      * Find all published regular pages by their parent IDs
  871.      *
  872.      * @param integer $intPid     The parent page's ID
  873.      * @param array   $arrOptions An optional options array
  874.      *
  875.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  876.      */
  877.     public static function findPublishedRegularByPid($intPid, array $arrOptions=array())
  878.     {
  879.         $t = static::$strTable;
  880.         $unroutableTypes = System::getContainer()->get('contao.routing.page_registry')->getUnroutableTypes();
  881.         $arrColumns = array("$t.pid=? AND $t.type!='root' AND $t.type NOT IN ('" . implode("', '", $unroutableTypes) . "')");
  883.         if (!static::isPreviewMode($arrOptions))
  884.         {
  885.             $time = Date::floorToMinute();
  886.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  887.         }
  889.         if (!isset($arrOptions['order']))
  890.         {
  891.             $arrOptions['order'] = "$t.sorting";
  892.         }
  894.         return static::findBy($arrColumns, $intPid, $arrOptions);
  895.     }
  897.     /**
  898.      * Find all published regular pages by their parent IDs and exclude pages only visible for guests
  899.      *
  900.      * @param integer $intPid     The parent page's ID
  901.      * @param array   $arrOptions An optional options array
  902.      *
  903.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no pages
  904.      *
  905.      * @deprecated Deprecated since Contao 4.12, to be removed in Contao 5;
  906.      *             use PageModel::findPublishedRegularByPid() instead.
  907.      */
  908.     public static function findPublishedRegularWithoutGuestsByPid($intPid, array $arrOptions=array())
  909.     {
  910.         trigger_deprecation('contao/core-bundle', '4.12', 'Using PageModel::findPublishedRegularWithoutGuestsByPid() has been deprecated and will no longer work in Contao 5.0. Use PageModel::findPublishedRegularByPid() instead.');
  912.         $t = static::$strTable;
  913.         $unroutableTypes = System::getContainer()->get('contao.routing.page_registry')->getUnroutableTypes();
  914.         $arrColumns = array("$t.pid=? AND $t.type!='root' AND $t.type NOT IN ('" . implode("', '", $unroutableTypes) . "')");
  916.         if (System::getContainer()->get('contao.security.token_checker')->hasFrontendUser())
  917.         {
  918.             $arrColumns[] = "$t.guests=''";
  919.         }
  921.         if (!static::isPreviewMode($arrOptions))
  922.         {
  923.             $time = Date::floorToMinute();
  924.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  925.         }
  927.         if (!isset($arrOptions['order']))
  928.         {
  929.             $arrOptions['order'] = "$t.sorting";
  930.         }
  932.         return static::findBy($arrColumns, $intPid, $arrOptions);
  933.     }
  935.     /**
  936.      * Find the language fallback page by hostname
  937.      *
  938.      * @param string $strHost    The hostname
  939.      * @param array  $arrOptions An optional options array
  940.      *
  941.      * @return PageModel|Model|null The model or null if there is no fallback page
  942.      */
  943.     public static function findPublishedFallbackByHostname($strHost, array $arrOptions=array())
  944.     {
  945.         // Try to load from the registry (see #8544)
  946.         if (empty($arrOptions))
  947.         {
  948.             $objModel = Registry::getInstance()->fetch(static::$strTable, $strHost, 'contao.dns-fallback');
  950.             if ($objModel !== null)
  951.             {
  952.                 return $objModel;
  953.             }
  954.         }
  956.         $t = static::$strTable;
  957.         $arrColumns = array("$t.dns=? AND $t.fallback='1'");
  959.         if (isset($arrOptions['fallbackToEmpty']) && $arrOptions['fallbackToEmpty'] === true)
  960.         {
  961.             $arrColumns = array("($t.dns=? OR $t.dns='') AND $t.fallback='1'");
  963.             if (!isset($arrOptions['order']))
  964.             {
  965.                 $arrOptions['order'] = "$t.dns DESC";
  966.             }
  967.         }
  969.         if (!static::isPreviewMode($arrOptions))
  970.         {
  971.             $time = Date::floorToMinute();
  972.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  973.         }
  975.         return static::findOneBy($arrColumns, $strHost, $arrOptions);
  976.     }
  978.     /**
  979.      * Finds the published root pages
  980.      *
  981.      * @param array $arrOptions An optional options array
  982.      *
  983.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no parent pages
  984.      */
  985.     public static function findPublishedRootPages(array $arrOptions=array())
  986.     {
  987.         $t = static::$strTable;
  988.         $arrColumns = array("$t.type='root'");
  990.         if (isset($arrOptions['dns']))
  991.         {
  992.             $arrColumns = array("$t.type='root' AND $t.dns=?");
  993.         }
  995.         if (!static::isPreviewMode($arrOptions))
  996.         {
  997.             $time = Date::floorToMinute();
  998.             $arrColumns[] = "$t.published='1' AND ($t.start='' OR $t.start<=$time) AND ($t.stop='' OR $t.stop>$time)";
  999.         }
  1001.         return static::findBy($arrColumns, $arrOptions['dns'] ?? null, $arrOptions);
  1002.     }
  1004.     /**
  1005.      * Find the parent pages of a page
  1006.      *
  1007.      * @param integer $intId The page's ID
  1008.      *
  1009.      * @return Collection|PageModel[]|PageModel|null A collection of models or null if there are no parent pages
  1010.      */
  1011.     public static function findParentsById($intId)
  1012.     {
  1013.         $arrModels = array();
  1015.         while ($intId > 0 && ($objPage = static::findByPk($intId)) !== null)
  1016.         {
  1017.             $intId = $objPage->pid;
  1018.             $arrModels[] = $objPage;
  1019.         }
  1021.         if (empty($arrModels))
  1022.         {
  1023.             return null;
  1024.         }
  1026.         return static::createCollection($arrModels, 'tl_page');
  1027.     }
  1029.     /**
  1030.      * Find the first active page by its member groups
  1031.      *
  1032.      * @param array $arrIds An array of member group IDs
  1033.      *
  1034.      * @return PageModel|null The model or null if there is no matching member group
  1035.      */
  1036.     public static function findFirstActiveByMemberGroups($arrIds)
  1037.     {
  1038.         if (empty($arrIds) || !\is_array($arrIds))
  1039.         {
  1040.             return null;
  1041.         }
  1043.         $time = Date::floorToMinute();
  1044.         $objDatabase = Database::getInstance();
  1045.         $arrIds = array_map('\intval', $arrIds);
  1047.         $objResult = $objDatabase->prepare("SELECT p.* FROM tl_member_group g LEFT JOIN tl_page p ON g.jumpTo=p.id WHERE g.id IN(" . implode(',', $arrIds) . ") AND g.jumpTo>0 AND g.redirect='1' AND g.disable!='1' AND (g.start='' OR g.start<=$time) AND (g.stop='' OR g.stop>$time) AND p.published='1' AND (p.start='' OR p.start<=$time) AND (p.stop='' OR p.stop>$time) ORDER BY " . $objDatabase->findInSet('g.id', $arrIds))
  1048.                                  ->limit(1)
  1049.                                  ->execute();
  1051.         if ($objResult->numRows < 1)
  1052.         {
  1053.             return null;
  1054.         }
  1056.         $objRegistry = Registry::getInstance();
  1058.         /** @var PageModel|Model $objPage */
  1059.         if ($objPage = $objRegistry->fetch('tl_page', $objResult->id))
  1060.         {
  1061.             return $objPage;
  1062.         }
  1064.         return new static($objResult);
  1065.     }
  1067.     /**
  1068.      * Find a page by its ID and return it with the inherited details
  1069.      *
  1070.      * @param integer|string $intId The page's ID
  1071.      *
  1072.      * @return PageModel|null The model or null if there is no matching page
  1073.      */
  1074.     public static function findWithDetails($intId)
  1075.     {
  1076.         $objPage = static::findByPk($intId);
  1078.         if ($objPage === null)
  1079.         {
  1080.             return null;
  1081.         }
  1083.         return $objPage->loadDetails();
  1084.     }
  1086.     /**
  1087.      * Register the contao.dns-fallback alias when the model is attached to the registry
  1088.      *
  1089.      * @param Registry $registry The model registry
  1090.      */
  1091.     public function onRegister(Registry $registry)
  1092.     {
  1093.         parent::onRegister($registry);
  1095.         // Register this model as being the fallback page for a given dns
  1096.         if ($this->fallback && $this->type == 'root' && !$registry->isRegisteredAlias($this, 'contao.dns-fallback', $this->dns))
  1097.         {
  1098.             $registry->registerAlias($this, 'contao.dns-fallback', $this->dns);
  1099.         }
  1100.     }
  1102.     /**
  1103.      * Unregister the contao.dns-fallback alias when the model is detached from the registry
  1104.      *
  1105.      * @param Registry $registry The model registry
  1106.      */
  1107.     public function onUnregister(Registry $registry)
  1108.     {
  1109.         parent::onUnregister($registry);
  1111.         // Unregister the fallback page
  1112.         if ($this->fallback && $this->type == 'root' && $registry->isRegisteredAlias($this, 'contao.dns-fallback', $this->dns))
  1113.         {
  1114.             $registry->unregisterAlias($this, 'contao.dns-fallback', $this->dns);
  1115.         }
  1116.     }
  1118.     /**
  1119.      * Get the details of a page including inherited parameters
  1120.      *
  1121.      * @return PageModel The page model
  1122.      *
  1123.      * @throws NoRootPageFoundException If no root page is found
  1124.      */
  1125.     public function loadDetails()
  1126.     {
  1127.         // Loaded already
  1128.         if ($this->blnDetailsLoaded)
  1129.         {
  1130.             return $this;
  1131.         }
  1133.         // Set some default values
  1134.         $this->protected = (bool) $this->protected;
  1135.         $this->groups = $this->protected ? StringUtil::deserialize($this->groups, true) : array();
  1136.         $this->layout = ($this->includeLayout && $this->layout) ? $this->layout : false;
  1137.         $this->cache = $this->includeCache ? $this->cache : false;
  1138.         $this->alwaysLoadFromCache = $this->includeCache ? $this->alwaysLoadFromCache : false;
  1139.         $this->clientCache = $this->includeCache ? $this->clientCache : false;
  1141.         $pid = $this->pid;
  1142.         $type = $this->type;
  1143.         $alias = $this->alias;
  1144.         $name = $this->title;
  1145.         $title = $this->pageTitle ?: $this->title;
  1146.         $folderUrl = '';
  1147.         $palias = '';
  1148.         $pname = '';
  1149.         $ptitle = '';
  1150.         $trail = array($this->id, $pid);
  1151.         $time = time();
  1153.         // Inherit the settings
  1154.         if ($this->type == 'root')
  1155.         {
  1156.             $objParentPage = $this; // see #4610
  1157.         }
  1158.         else
  1159.         {
  1160.             // Load all parent pages
  1161.             $objParentPage = self::findParentsById($pid);
  1163.             if ($objParentPage !== null)
  1164.             {
  1165.                 while ($pid > 0 && $type != 'root' && $objParentPage->next())
  1166.                 {
  1167.                     $pid = $objParentPage->pid;
  1168.                     $type = $objParentPage->type;
  1170.                     // Parent title
  1171.                     if (!$ptitle)
  1172.                     {
  1173.                         $palias = $objParentPage->alias;
  1174.                         $pname = $objParentPage->title;
  1175.                         $ptitle = $objParentPage->pageTitle ?: $objParentPage->title;
  1176.                     }
  1178.                     // Page title
  1179.                     if ($type != 'root')
  1180.                     {
  1181.                         // If $folderUrl is not yet set, use the alias of the first
  1182.                         // parent page if it is not a root page (see #2129)
  1183.                         if (!$folderUrl && $objParentPage->alias && $objParentPage->alias !== 'index' && $objParentPage->alias !== '/')
  1184.                         {
  1185.                             $folderUrl = $objParentPage->alias . '/';
  1186.                         }
  1188.                         $alias = $objParentPage->alias;
  1189.                         $name = $objParentPage->title;
  1190.                         $title = $objParentPage->pageTitle ?: $objParentPage->title;
  1191.                         $trail[] = $objParentPage->pid;
  1192.                     }
  1194.                     // Cache
  1195.                     if ($objParentPage->includeCache)
  1196.                     {
  1197.                         $this->cache = $this->cache !== false ? $this->cache : $objParentPage->cache;
  1198.                         $this->alwaysLoadFromCache = $this->alwaysLoadFromCache !== false ? $this->alwaysLoadFromCache : $objParentPage->alwaysLoadFromCache;
  1199.                         $this->clientCache = $this->clientCache !== false ? $this->clientCache : $objParentPage->clientCache;
  1200.                     }
  1202.                     // Layout
  1203.                     if ($objParentPage->includeLayout && $this->layout === false)
  1204.                     {
  1205.                         $this->layout = $objParentPage->subpageLayout ?: $objParentPage->layout;
  1206.                     }
  1208.                     // Protection
  1209.                     if ($objParentPage->protected && $this->protected === false)
  1210.                     {
  1211.                         $this->protected = true;
  1212.                         $this->groups = StringUtil::deserialize($objParentPage->groups, true);
  1213.                     }
  1214.                 }
  1215.             }
  1217.             // Set the titles
  1218.             $this->mainAlias = $alias;
  1219.             $this->mainTitle = $name;
  1220.             $this->mainPageTitle = $title;
  1221.             $this->parentAlias = $palias;
  1222.             $this->parentTitle = $pname;
  1223.             $this->parentPageTitle = $ptitle;
  1224.             $this->folderUrl = $folderUrl;
  1225.         }
  1227.         $container = System::getContainer();
  1228.         $request = $container->get('request_stack')->getCurrentRequest();
  1230.         // Set the root ID and title
  1231.         if ($objParentPage !== null && $objParentPage->type == 'root')
  1232.         {
  1233.             $this->rootId = $objParentPage->id;
  1234.             $this->rootAlias = $objParentPage->alias;
  1235.             $this->rootTitle = $objParentPage->title;
  1236.             $this->rootPageTitle = $objParentPage->pageTitle ?: $objParentPage->title;
  1237.             $this->rootSorting = $objParentPage->sorting;
  1238.             $this->domain = $objParentPage->dns;
  1239.             $this->rootLanguage = $objParentPage->language;
  1240.             $this->language = $objParentPage->language;
  1241.             $this->staticFiles = $objParentPage->staticFiles;
  1242.             $this->staticPlugins = $objParentPage->staticPlugins;
  1243.             $this->dateFormat = $objParentPage->dateFormat;
  1244.             $this->timeFormat = $objParentPage->timeFormat;
  1245.             $this->datimFormat = $objParentPage->datimFormat;
  1246.             $this->validAliasCharacters = $objParentPage->validAliasCharacters;
  1247.             $this->urlPrefix = $objParentPage->urlPrefix;
  1248.             $this->urlSuffix = $objParentPage->urlSuffix;
  1249.             $this->disableLanguageRedirect = $objParentPage->disableLanguageRedirect;
  1250.             $this->adminEmail = $objParentPage->adminEmail;
  1251.             $this->enforceTwoFactor = $objParentPage->enforceTwoFactor;
  1252.             $this->twoFactorJumpTo = $objParentPage->twoFactorJumpTo;
  1253.             $this->useFolderUrl = $objParentPage->useFolderUrl;
  1254.             $this->mailerTransport = $objParentPage->mailerTransport;
  1255.             $this->enableCanonical = $objParentPage->enableCanonical;
  1256.             $this->useAutoItem = Config::get('useAutoItem');
  1257.             $this->maintenanceMode = $objParentPage->maintenanceMode;
  1259.             // Store whether the root page has been published
  1260.             $this->rootIsPublic = ($objParentPage->published && (!$objParentPage->start || $objParentPage->start <= $time) && (!$objParentPage->stop || $objParentPage->stop > $time));
  1261.             $this->rootIsFallback = (bool) $objParentPage->fallback;
  1262.             $this->rootUseSSL = $objParentPage->useSSL;
  1263.             $this->rootFallbackLanguage = $objParentPage->language;
  1265.             // Store the fallback language (see #6874)
  1266.             if (!$objParentPage->fallback)
  1267.             {
  1268.                 $this->rootFallbackLanguage = null;
  1270.                 $objFallback = static::findPublishedFallbackByHostname($objParentPage->dns);
  1272.                 if ($objFallback !== null)
  1273.                 {
  1274.                     $this->rootFallbackLanguage = $objFallback->language;
  1275.                 }
  1276.             }
  1278.             if ($container->getParameter('contao.legacy_routing'))
  1279.             {
  1280.                 $this->urlPrefix = $container->getParameter('contao.prepend_locale') ? LocaleUtil::formatAsLanguageTag($objParentPage->language) : '';
  1281.                 $this->urlSuffix = $container->getParameter('contao.url_suffix');
  1282.             }
  1283.         }
  1285.         // No root page found
  1286.         elseif ($request && $container->get('contao.routing.scope_matcher')->isFrontendRequest($request) && $this->type != 'root')
  1287.         {
  1288.             $container->get('monolog.logger.contao.error')->error('Page ID "' . $this->id . '" does not belong to a root page');
  1290.             throw new NoRootPageFoundException('No root page found');
  1291.         }
  1293.         $this->trail = array_reverse($trail);
  1295.         // Use the global date format if none is set (see #6104)
  1296.         if (!$this->dateFormat)
  1297.         {
  1298.             $this->dateFormat = Config::get('dateFormat');
  1299.         }
  1301.         if (!$this->timeFormat)
  1302.         {
  1303.             $this->timeFormat = Config::get('timeFormat');
  1304.         }
  1306.         if (!$this->datimFormat)
  1307.         {
  1308.             $this->datimFormat = Config::get('datimFormat');
  1309.         }
  1311.         $this->isPublic = ($this->published && (!$this->start || $this->start <= $time) && (!$this->stop || $this->stop > $time));
  1313.         // HOOK: add custom logic
  1314.         if (!empty($GLOBALS['TL_HOOKS']['loadPageDetails']) && \is_array($GLOBALS['TL_HOOKS']['loadPageDetails']))
  1315.         {
  1316.             $parentModels = array();
  1318.             if ($objParentPage instanceof Collection)
  1319.             {
  1320.                 $parentModels = $objParentPage->getModels();
  1321.             }
  1323.             foreach ($GLOBALS['TL_HOOKS']['loadPageDetails'] as $callback)
  1324.             {
  1325.                 System::importStatic($callback[0])->{$callback[1]}($parentModels, $this);
  1326.             }
  1327.         }
  1329.         // Prevent saving (see #6506 and #7199)
  1330.         $this->preventSaving();
  1331.         $this->blnDetailsLoaded = true;
  1333.         return $this;
  1334.     }
  1336.     /**
  1337.      * Generate a front end URL
  1338.      *
  1339.      * @param string $strParams    An optional string of URL parameters
  1340.      * @param string $strForceLang Force a certain language
  1341.      *
  1342.      * @throws RouteNotFoundException
  1343.      * @throws ResourceNotFoundException
  1344.      *
  1345.      * @return string A URL that can be used in the front end
  1346.      */
  1347.     public function getFrontendUrl($strParams=null, $strForceLang=null)
  1348.     {
  1349.         $page = $this;
  1350.         $page->loadDetails();
  1352.         if ($strForceLang !== null)
  1353.         {
  1354.             trigger_deprecation('contao/core-bundle', '4.0', 'Using "Contao\PageModel::getFrontendUrl()" with $strForceLang has been deprecated and will no longer work in Contao 5.0.');
  1356.             $strForceLang = LocaleUtil::formatAsLanguageTag($strForceLang);
  1358.             $page = $page->cloneOriginal();
  1359.             $page->preventSaving(false);
  1360.             $page->language = $strForceLang;
  1361.             $page->rootLanguage = $strForceLang;
  1363.             if (System::getContainer()->getParameter('contao.legacy_routing'))
  1364.             {
  1365.                 $page->urlPrefix = System::getContainer()->getParameter('contao.prepend_locale') ? $strForceLang : '';
  1366.             }
  1367.         }
  1369.         $objRouter = System::getContainer()->get('router');
  1370.         $referenceType = $this->domain && $objRouter->getContext()->getHost() !== $this->domain ? UrlGeneratorInterface::ABSOLUTE_URL : UrlGeneratorInterface::ABSOLUTE_PATH;
  1372.         try
  1373.         {
  1374.             $strUrl = $objRouter->generate(PageRoute::PAGE_BASED_ROUTE_NAME, array(RouteObjectInterface::CONTENT_OBJECT => $page, 'parameters' => $strParams), $referenceType);
  1375.         }
  1376.         catch (RouteNotFoundException $e)
  1377.         {
  1378.             $pageRegistry = System::getContainer()->get('contao.routing.page_registry');
  1380.             if (!$pageRegistry->isRoutable($this))
  1381.             {
  1382.                 throw new ResourceNotFoundException(sprintf('Page ID %s is not routable', $this->id), 0, $e);
  1383.             }
  1385.             throw $e;
  1386.         }
  1388.         // Make the URL relative to the base path
  1389.         if (0 === strncmp($strUrl, '/', 1))
  1390.         {
  1391.             $strUrl = substr($strUrl, \strlen(Environment::get('path')) + 1);
  1392.         }
  1394.         return $this->applyLegacyLogic($strUrl, $strParams);
  1395.     }
  1397.     /**
  1398.      * Generate an absolute URL depending on the current rewriteURL setting
  1399.      *
  1400.      * @param string $strParams An optional string of URL parameters
  1401.      *
  1402.      * @throws RouteNotFoundException
  1403.      * @throws ResourceNotFoundException
  1404.      *
  1405.      * @return string An absolute URL that can be used in the front end
  1406.      */
  1407.     public function getAbsoluteUrl($strParams=null)
  1408.     {
  1409.         $this->loadDetails();
  1411.         $objRouter = System::getContainer()->get('router');
  1413.         try
  1414.         {
  1415.             $strUrl = $objRouter->generate(PageRoute::PAGE_BASED_ROUTE_NAME, array(RouteObjectInterface::CONTENT_OBJECT => $this, 'parameters' => $strParams), UrlGeneratorInterface::ABSOLUTE_URL);
  1416.         }
  1417.         catch (RouteNotFoundException $e)
  1418.         {
  1419.             $pageRegistry = System::getContainer()->get('contao.routing.page_registry');
  1421.             if (!$pageRegistry->isRoutable($this))
  1422.             {
  1423.                 throw new ResourceNotFoundException(sprintf('Page ID %s is not routable', $this->id), 0, $e);
  1424.             }
  1426.             throw $e;
  1427.         }
  1429.         return $this->applyLegacyLogic($strUrl, $strParams);
  1430.     }
  1432.     /**
  1433.      * Generate the front end preview URL
  1434.      *
  1435.      * @param string $strParams An optional string of URL parameters
  1436.      *
  1437.      * @throws RouteNotFoundException
  1438.      * @throws ResourceNotFoundException
  1439.      *
  1440.      * @return string The front end preview URL
  1441.      */
  1442.     public function getPreviewUrl($strParams=null)
  1443.     {
  1444.         $container = System::getContainer();
  1446.         if (!$previewScript = $container->getParameter('contao.preview_script'))
  1447.         {
  1448.             return $this->getAbsoluteUrl($strParams);
  1449.         }
  1451.         $this->loadDetails();
  1453.         $context = $container->get('router')->getContext();
  1454.         $baseUrl = $context->getBaseUrl();
  1456.         // Add the preview script
  1457.         $context->setBaseUrl($previewScript);
  1459.         $objRouter = System::getContainer()->get('router');
  1461.         try
  1462.         {
  1463.             $strUrl = $objRouter->generate(PageRoute::PAGE_BASED_ROUTE_NAME, array(RouteObjectInterface::CONTENT_OBJECT => $this, 'parameters' => $strParams), UrlGeneratorInterface::ABSOLUTE_URL);
  1464.         }
  1465.         catch (RouteNotFoundException $e)
  1466.         {
  1467.             $pageRegistry = System::getContainer()->get('contao.routing.page_registry');
  1469.             if (!$pageRegistry->isRoutable($this))
  1470.             {
  1471.                 throw new ResourceNotFoundException(sprintf('Page ID %s is not routable', $this->id), 0, $e);
  1472.             }
  1474.             throw $e;
  1475.         }
  1477.         $context->setBaseUrl($baseUrl);
  1479.         return $this->applyLegacyLogic($strUrl, $strParams);
  1480.     }
  1482.     /**
  1483.      * Return the slug options
  1484.      *
  1485.      * @return array The slug options
  1486.      */
  1487.     public function getSlugOptions()
  1488.     {
  1489.         // Use primary language for slug generation, until fixed in ICU or ausi/slug-generator (see #2413)
  1490.         $slugOptions = array('locale'=>LocaleUtil::getPrimaryLanguage($this->language));
  1492.         if ($this->validAliasCharacters)
  1493.         {
  1494.             $slugOptions['validChars'] = $this->validAliasCharacters;
  1495.         }
  1497.         return $slugOptions;
  1498.     }
  1500.     /**
  1501.      * Modifies a URL from the URL generator.
  1502.      *
  1503.      * @param string      $strUrl
  1504.      * @param string|null $strParams
  1505.      *
  1506.      * @return string
  1507.      */
  1508.     private function applyLegacyLogic($strUrl, $strParams)
  1509.     {
  1510.         // Decode sprintf placeholders
  1511.         if ($strParams !== null && strpos($strParams, '%') !== false)
  1512.         {
  1513.             trigger_deprecation('contao/core-bundle', '4.2', 'Using sprintf placeholders in URLs has been deprecated and will no longer work in Contao 5.0.');
  1515.             $arrMatches = array();
  1516.             preg_match_all('/%([sducoxXbgGeEfF])/', $strParams, $arrMatches);
  1518.             foreach (array_unique($arrMatches[1]) as $v)
  1519.             {
  1520.                 $strUrl = str_replace('%25' . $v, '%' . $v, $strUrl);
  1521.             }
  1522.         }
  1524.         // HOOK: add custom logic
  1525.         if (isset($GLOBALS['TL_HOOKS']['generateFrontendUrl']) && \is_array($GLOBALS['TL_HOOKS']['generateFrontendUrl']))
  1526.         {
  1527.             trigger_deprecation('contao/core-bundle', '4.0', 'Using the "generateFrontendUrl" hook has been deprecated and will no longer work in Contao 5.0.');
  1529.             foreach ($GLOBALS['TL_HOOKS']['generateFrontendUrl'] as $callback)
  1530.             {
  1531.                 $strUrl = System::importStatic($callback[0])->{$callback[1]}($this->row(), $strParams ?? '', $strUrl);
  1532.             }
  1534.             return $strUrl;
  1535.         }
  1537.         return $strUrl;
  1538.     }
  1540.     private static function stripPrefixesAndSuffixes(string $alias, string $urlPrefix, string $urlSuffix): string
  1541.     {
  1542.         if (null === self::$prefixes || null === self::$suffixes)
  1543.         {
  1544.             $rows = Database::getInstance()
  1545.                 ->execute("SELECT urlPrefix, urlSuffix FROM tl_page WHERE type='root'")
  1546.                 ->fetchAllAssoc()
  1547.             ;
  1549.             self::$prefixes = array();
  1550.             self::$suffixes = array();
  1552.             foreach (array_column($rows, 'urlPrefix') as $prefix)
  1553.             {
  1554.                 $prefix = trim($prefix, '/');
  1556.                 if ('' !== $prefix)
  1557.                 {
  1558.                     self::$prefixes[] = $prefix . '/';
  1559.                 }
  1560.             }
  1562.             foreach (array_column($rows, 'urlSuffix') as $suffix)
  1563.             {
  1564.                 self::$suffixes[] = $suffix;
  1565.             }
  1566.         }
  1568.         $prefixes = self::$prefixes;
  1570.         if (!empty($urlPrefix))
  1571.         {
  1572.             $prefixes[] = $urlPrefix . '/';
  1573.         }
  1575.         if (null !== ($prefixRegex = self::regexArray($prefixes)))
  1576.         {
  1577.             $alias = preg_replace('/^' . $prefixRegex . '/i', '', $alias);
  1578.         }
  1580.         if (null !== ($suffixRegex = self::regexArray(array_merge(array($urlSuffix), self::$suffixes))))
  1581.         {
  1582.             $alias = preg_replace('/' . $suffixRegex . '$/i', '', $alias);
  1583.         }
  1585.         return $alias;
  1586.     }
  1588.     private static function regexArray(array $data): ?string
  1589.     {
  1590.         $data = array_filter(array_unique($data));
  1592.         if (0 === \count($data))
  1593.         {
  1594.             return null;
  1595.         }
  1597.         usort($data, static fn ($v, $k) => \strlen($v));
  1599.         foreach ($data as $k => $v)
  1600.         {
  1601.             $data[$k] = preg_quote($v, '/');
  1602.         }
  1604.         return '(' . implode('|', $data) . ')';
  1605.     }
  1606. }
  1608. class_alias(PageModel::class, 'PageModel');