TYPO3 / TYPO3.CMS

     * @return string|null Returns NULL if URL was not processed or the processed URL as a string.

     * @throws \RuntimeException if a hook was registered but did not fulfill the correct parameters.

     */

    protected function processUrl(string $context, string $url, array $typolinkConfiguration = [])

    {

        $urlProcessors = $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['urlProcessing']['urlProcessors'] ?? false;

        if (!$urlProcessors) {

            return $url;

        }

        foreach ($urlProcessors as $identifier => $configuration) {

            if (empty($configuration) || !is_array($configuration)) {

                throw new \RuntimeException('Missing configuration for URI processor "' . $identifier . '".', 1491130459);

            }

            if (!is_string($configuration['processor']) || empty($configuration['processor']) || !class_exists($configuration['processor']) || !is_subclass_of($configuration['processor'], UrlProcessorInterface::class)) {

                throw new \RuntimeException('The URI processor "' . $identifier . '" defines an invalid provider. Ensure the class exists and implements the "' . UrlProcessorInterface::class . '".', 1491130460);

            }

        }

        $orderedProcessors = GeneralUtility::makeInstance(DependencyOrderingService::class)->orderByDependencies($urlProcessors);

        $keepProcessing = true;

        foreach ($orderedProcessors as $configuration) {

            /** @var UrlProcessorInterface $urlProcessor */

            $urlProcessor = GeneralUtility::makeInstance($configuration['processor']);

            $url = $urlProcessor->process($context, $url, $typolinkConfiguration, $this->contentObjectRenderer, $keepProcessing);

            if (!$keepProcessing) {

                break;

            }

        }

        return $url;

    }

    /**

     * @return TypoScriptFrontendController

     * @return string|null Returns NULL if URL was not processed or the processed URL as a string.

     * @throws \RuntimeException if a hook was registered but did not fulfill the correct parameters.

     */

    protected function processUrl($context, $url, $typolinkConfiguration = [])

    {

        $urlProcessors = $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['urlProcessing']['urlProcessors'] ?? [];

        if (empty($urlProcessors)) {

            return $url;

        }

        foreach ($urlProcessors as $identifier => $configuration) {

            if (empty($configuration) || !is_array($configuration)) {

                throw new \RuntimeException('Missing configuration for URI processor "' . $identifier . '".', 1442050529);

            }

            if (!is_string($configuration['processor']) || empty($configuration['processor']) || !class_exists($configuration['processor']) || !is_subclass_of($configuration['processor'], UrlProcessorInterface::class)) {

                throw new \RuntimeException('The URI processor "' . $identifier . '" defines an invalid provider. Ensure the class exists and implements the "' . UrlProcessorInterface::class . '".', 1442050579);

            }

        }

        $orderedProcessors = GeneralUtility::makeInstance(DependencyOrderingService::class)->orderByDependencies($urlProcessors);

        $keepProcessing = true;

        foreach ($orderedProcessors as $configuration) {

            /** @var UrlProcessorInterface $urlProcessor */

            $urlProcessor = GeneralUtility::makeInstance($configuration['processor']);

            $url = $urlProcessor->process($context, $url, $typolinkConfiguration, $this, $keepProcessing);

            if (!$keepProcessing) {

                break;

            }

        }

        return $url;

    }

    /**

     * Creates a href attibute for given $mailAddress.