ExternalLinktypeTest.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\Linkvalidator\Tests\Unit\Linktype;
 
use GuzzleHttp\Cookie\CookieJar;
use GuzzleHttp\Exception\ClientException;
use GuzzleHttp\Psr7\Response;
use Prophecy\Argument;
use Prophecy\PhpUnit\ProphecyTrait;
use Prophecy\Prophecy\ObjectProphecy;
use ‪TYPO3\CMS\Core\Http\RequestFactory;
use ‪TYPO3\CMS\Core\Localization\LanguageService;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
use ‪TYPO3\CMS\Linkvalidator\LinkAnalyzer;
use ‪TYPO3\CMS\Linkvalidator\Linktype\ExternalLinktype;
use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
class ‪ExternalLinktypeTest extends UnitTestCase
{
    use ProphecyTrait;
 
    protected function ‪setUp(): void
    {
        parent::setUp();
        ‪$GLOBALS['LANG'] = $this->‪buildLanguageServiceProphecy()->reveal();
    }
 
    private function ‪buildLanguageServiceProphecy(): ObjectProphecy
    {
        $languageServiceProphecy = $this->prophesize(LanguageService::class);
        $languageServiceProphecy
            ->includeLLFile('EXT:linkvalidator/Resources/Private/Language/Module/locallang.xlf');
        $languageServiceProphecy->getLL(Argument::any())->willReturn('translation string');
        return $languageServiceProphecy;
    }
 
    public function ‪checkLinkWithExternalUrlNotFoundReturnsFalse(): void
    {
        $responseProphecy = $this->prophesize(Response::class);
        $responseProphecy->getStatusCode()->willReturn(404);
 
        $exceptionProphecy = $this->prophesize(ClientException::class);
        $exceptionProphecy->hasResponse()
            ->willReturn(true);
        $exceptionProphecy->getResponse()
            ->willReturn($responseProphecy->reveal());
 
        $url = 'https://example.org/~not-existing-url';
        $options = $this->‪getRequestHeaderOptions();
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request($url, 'HEAD', $options)
            ->willThrow($exceptionProphecy->reveal());
 
        $optionsSecondTryWithGET = array_merge_recursive($options, ['headers' => ['Range' => 'bytes=0-4048']]);
        $requestFactoryProphecy->request($url, 'GET', $optionsSecondTryWithGET)
            ->willThrow($exceptionProphecy->reveal());
        $subject = new ‪ExternalLinktype($requestFactoryProphecy->reveal());
 
        $result = $subject->checkLink($url, null, null);
 
        self::assertFalse($result);
    }
 
    public function ‪checkLinkWithExternalUrlNotFoundResultsNotFoundErrorType(): void
    {
        $responseProphecy = $this->prophesize(Response::class);
        $responseProphecy->getStatusCode()->willReturn(404);
 
        $exceptionProphecy = $this->prophesize(ClientException::class);
        $exceptionProphecy->hasResponse()
            ->willReturn(true);
        $exceptionProphecy->getResponse()
            ->willReturn($responseProphecy->reveal());
 
        $options = $this->‪getRequestHeaderOptions();
 
        $url = 'https://example.org/~not-existing-url';
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request($url, 'HEAD', $options)
            ->willThrow($exceptionProphecy->reveal());
        $optionsSecondTryWithGET = array_merge_recursive($options, ['headers' => ['Range' => 'bytes=0-4048']]);
        $requestFactoryProphecy->request($url, 'GET', $optionsSecondTryWithGET)
            ->willThrow($exceptionProphecy->reveal());
        $subject = new ExternalLinktype($requestFactoryProphecy->reveal());
 
        $subject->checkLink($url, null, null);
        $errorParams = $subject->getErrorParams();
 
        self::assertSame($errorParams['errorType'], 'httpStatusCode');
        self::assertSame($errorParams['errno'], 404);
    }
 
    private function ‪getCookieJarProphecy(): CookieJar
    {
        $cookieJar = $this->prophesize(CookieJar::class);
        $cookieJar = $cookieJar->reveal();
        GeneralUtility::addInstance(CookieJar::class, $cookieJar);
        return $cookieJar;
    }
 
    private function ‪getRequestHeaderOptions(): array
    {
        return [
            'cookies' => $this->‪getCookieJarProphecy(),
            'allow_redirects' => ['strict' => true],
            'headers' => [
                'User-Agent' => 'TYPO3 linkvalidator',
                'Accept' => '*/*',
                'Accept-Language' => '*',
                'Accept-Encoding' => '*',
            ],
        ];
    }
 
    public function ‪preprocessUrlsDataProvider(): \Generator
    {
        // regression test for issue #92230: handle incomplete or faulty URLs gracefully
        yield 'faulty URL with mailto' => [
            'mailto:http://example.org',
            'mailto:http://example.org',
        ];
        yield 'Relative URL' => [
            '/abc',
            '/abc',
        ];
 
        // regression tests for issues #89488, #89682
        yield 'URL with query parameter and ampersand' => [
            'https://standards.cen.eu/dyn/www/f?p=204:6:0::::FSP_ORG_ID,FSP_LANG_ID:,22&cs=1A3FFBC44FAB6B2A181C9525249C3A829',
            'https://standards.cen.eu/dyn/www/f?p=204:6:0::::FSP_ORG_ID,FSP_LANG_ID:,22&cs=1A3FFBC44FAB6B2A181C9525249C3A829',
        ];
        yield 'URL with query parameter and ampersand with HTML entities' => [
            'https://standards.cen.eu/dyn/www/f?p=204:6:0::::FSP_ORG_ID,FSP_LANG_ID:,22&amp;cs=1A3FFBC44FAB6B2A181C9525249C3A829',
            'https://standards.cen.eu/dyn/www/f?p=204:6:0::::FSP_ORG_ID,FSP_LANG_ID:,22&cs=1A3FFBC44FAB6B2A181C9525249C3A829',
        ];
 
        // regression tests for #89378
        yield 'URL with path with dashes' => [
            'https://example.com/Unternehmen/Ausbildung-Qualifikation/Weiterbildung-in-Niedersachsen/',
            'https://example.com/Unternehmen/Ausbildung-Qualifikation/Weiterbildung-in-Niedersachsen/',
        ];
        yield 'URL with path with dashes (2)' => [
            'https://example.com/startseite/wirtschaft/wirtschaftsfoerderung/beratung-foerderung/gruenderberatung/gruenderforen.html',
            'https://example.com/startseite/wirtschaft/wirtschaftsfoerderung/beratung-foerderung/gruenderberatung/gruenderforen.html',
        ];
        yield 'URL with path with dashes (3)' => [
            'http://example.com/universitaet/die-uni-im-ueberblick/lageplan/gebaeude/building/120',
            'http://example.com/universitaet/die-uni-im-ueberblick/lageplan/gebaeude/building/120',
        ];
        yield 'URL with path and query parameters (including &, ~,; etc.)' => [
            'http://example.com/tv?bcpid=1701167454001&amp;amp;amp;bckey=AQ~~,AAAAAGL7LqU~,aXlKNnCf9d9Tmck-kOc4PGFfCgHjM5JR&amp;amp;amp;bctid=1040702768001',
            'http://example.com/tv?bcpid=1701167454001&amp;amp;bckey=AQ~~,AAAAAGL7LqU~,aXlKNnCf9d9Tmck-kOc4PGFfCgHjM5JR&amp;amp;bctid=1040702768001',
        ];
 
        // make sure we correctly handle URLs with query parameters and fragment etc.
        yield 'URL with query parameters, fragment, user, pass, port etc.' => [
            'http://usr:pss@example.com:81/mypath/myfile.html?a=b&b[]=2&b[]=3#myfragment',
            'http://usr:pss@example.com:81/mypath/myfile.html?a=b&b[]=2&b[]=3#myfragment',
        ];
        yield 'domain with special characters, URL with query parameters, fragment, user, pass, port etc.' => [
            'http://usr:pss@äxample.com:81/mypath/myfile.html?a=b&b[]=2&b[]=3#myfragment',
            'http://usr:pss@xn--xample-9ta.com:81/mypath/myfile.html?a=b&b[]=2&b[]=3#myfragment',
        ];
 
        // domains with special characters: should be converted to punycode
        yield 'domain with special characters' => [
            'https://www.grün-example.org',
            'https://www.xn--grn-example-uhb.org',
        ];
        yield 'domain with special characters and path' => [
            'https://www.grün-example.org/a/bcd-efg/sfsfsfsfsf',
            'https://www.xn--grn-example-uhb.org/a/bcd-efg/sfsfsfsfsf',
        ];
    }
 
    public function ‪preprocessUrlReturnsCorrectString(string $inputUrl, $expectedResult): void
    {
        $subject = new ‪ExternalLinktype();
        $method = new \ReflectionMethod($subject, 'preprocessUrl');
        $method->setAccessible(true);
        $result = $method->invokeArgs($subject, [$inputUrl]);
        self::assertEquals($result, $expectedResult);
    }
 
    public function ‪setAdditionalConfigMergesHeaders(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::any())->shouldBeCalled();
 
        $externalLinkType = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinkType->setAdditionalConfig(['headers.' => [
            'X-MAS' => 'Merry!',
        ]]);
 
        $externalLinkType->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
 
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::that(static function ($result) {
            return $result['headers']['X-MAS'] === 'Merry!' && $result['headers']['User-Agent'] === 'TYPO3 linkvalidator';
        }))->shouldBeCalled();
    }
 
    public function ‪requestWithNoTimeoutIsCalledIfTimeoutNotSetByTsConfig(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $externalLinkType = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinkType->setAdditionalConfig([]);
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::that(static function ($result) {
            if (isset($result['timeout'])) {
                return false;
            }
            return true;
        }))->shouldBeCalled();
        $externalLinkType->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
    }
 
    public function ‪setAdditionalConfigOverwritesUserAgent(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::any())->shouldBeCalled();
 
        $externalLinktype = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinktype->setAdditionalConfig([
            'httpAgentName' => 'TYPO3 Testing',
        ]);
 
        $externalLinktype->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
 
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::that(static function ($result) {
            return $result['headers']['User-Agent'] === 'TYPO3 Testing';
        }))->shouldBeCalled();
    }
 
    public function ‪setAdditionalConfigAppendsAgentUrlIfConfigured(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::any())->shouldBeCalled();
 
        $externalLinkType = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinkType->setAdditionalConfig([
            'httpAgentUrl' => 'http://example.com',
        ]);
 
        $externalLinkType->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
 
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::that(static function ($result) {
            return $result['headers']['User-Agent'] === 'TYPO3 linkvalidator http://example.com';
        }))->shouldBeCalled();
    }
 
    public function ‪setAdditionalConfigAppendsEmailIfConfigured(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::any())->shouldBeCalled();
 
        $externalLinktype = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinktype->setAdditionalConfig([
            'httpAgentEmail' => 'mail@example.com',
        ]);
 
        $externalLinktype->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
 
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::that(static function ($result) {
            return $result['headers']['User-Agent'] === 'TYPO3 linkvalidator;mail@example.com';
        }))->shouldBeCalled();
    }
 
    public function ‪setAdditionalConfigAppendsEmailFromGlobalsIfConfigured(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::any())->shouldBeCalled();
        ‪$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress'] = 'test@example.com';
 
        $externalLinkType = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinkType->setAdditionalConfig([]);
 
        $externalLinkType->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
 
        $requestFactoryProphecy->request('http://example.com', 'HEAD', Argument::that(static function ($result) {
            return $result['headers']['User-Agent'] === 'TYPO3 linkvalidator;test@example.com';
        }))->shouldBeCalled();
    }
 
    public function ‪setAdditionalConfigSetsRangeAndMethod(): void
    {
        $requestFactoryProphecy = $this->prophesize(RequestFactory::class);
        $requestFactoryProphecy->request('http://example.com', 'GET', Argument::any())->shouldBeCalled();
        ‪$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress'] = 'test@example.com';
 
        $externalLinkType = new ExternalLinktype($requestFactoryProphecy->reveal());
        $externalLinkType->setAdditionalConfig([
            'method' => 'GET',
            'range' => '0-2048',
        ]);
 
        $externalLinkType->checkLink('http://example.com', [], $this->prophesize(LinkAnalyzer::class)->reveal());
 
        $requestFactoryProphecy->request('http://example.com', 'GET', Argument::that(static function ($result) {
            return $result['headers']['Range'] === 'bytes=0-2048';
        }))->shouldBeCalled();
    }
}