ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: opt / cpanel / ea-wappspector / vendor / squizlabs / php_codesniffer / tests / Core / Tokenizers / PHP

<?php
/**
 * Tests that embedded variables and expressions in heredoc strings are tokenized
 * as one heredoc string token.
 *
 * @author    Juliette Reinders Folmer <phpcs_nospam@adviesenzo.nl>
 * @copyright 2022 Squiz Pty Ltd (ABN 77 084 670 600)
 * @license   https://github.com/PHPCSStandards/PHP_CodeSniffer/blob/master/licence.txt BSD Licence
 */

namespace PHP_CodeSniffer\Tests\Core\Tokenizers\PHP;

use PHP_CodeSniffer\Tests\Core\Tokenizers\AbstractTokenizerTestCase;

final class HeredocStringTest extends AbstractTokenizerTestCase
{

/**
     * Test that heredoc strings contain the complete interpolated string.
     *
     * @param string $testMarker      The comment which prefaces the target token in the test file.
     * @param string $expectedContent The expected content of the heredoc string.
     *
     * @dataProvider dataHeredocString
     * @covers       PHP_CodeSniffer\Tokenizers\PHP::tokenize
     *
     * @return void
     */
    public function testHeredocString($testMarker, $expectedContent)
    {
        $tokens = $this->phpcsFile->getTokens();

$target = $this->getTargetToken($testMarker, T_HEREDOC);
        $this->assertSame($expectedContent."\n", $tokens[$target]['content']);

}//end testHeredocString()

/**
     * Test that heredoc strings contain the complete interpolated string when combined with other texts.
     *
     * @param string $testMarker      The comment which prefaces the target token in the test file.
     * @param string $expectedContent The expected content of the heredoc string.
     *
     * @dataProvider dataHeredocString
     * @covers       PHP_CodeSniffer\Tokenizers\PHP::tokenize
     *
     * @return void
     */
    public function testHeredocStringWrapped($testMarker, $expectedContent)
    {
        $tokens = $this->phpcsFile->getTokens();

$testMarker = substr($testMarker, 0, -3).'Wrapped */';
        $target     = $this->getTargetToken($testMarker, T_HEREDOC);
        $this->assertSame('Do '.$expectedContent." Something\n", $tokens[$target]['content']);

}//end testHeredocStringWrapped()

/**
     * Data provider.
     *
     * Type reference:
     * 1. Directly embedded variables.
     * 2. Braces outside the variable.
     * 3. Braces after the dollar sign.
     * 4. Variable variables and expressions.
     *
     * @link https://wiki.php.net/rfc/deprecate_dollar_brace_string_interpolation
     *
     * @see testHeredocString()
     *
     * @return array<string, array<string, string>>
     */
    public static function dataHeredocString()
    {
        return [
            'Type 1: simple variable'                                                  => [
                'testMarker'      => '/* testSimple1 */',
                'expectedContent' => '$foo',
            ],
            'Type 2: simple variable'                                                  => [
                'testMarker'      => '/* testSimple2 */',
                'expectedContent' => '{$foo}',
            ],
            'Type 3: simple variable'                                                  => [
                'testMarker'      => '/* testSimple3 */',
                'expectedContent' => '${foo}',
            ],
            'Type 1: array offset'                                                     => [
                'testMarker'      => '/* testDIM1 */',
                'expectedContent' => '$foo[bar]',
            ],
            'Type 2: array offset'                                                     => [
                'testMarker'      => '/* testDIM2 */',
                'expectedContent' => '{$foo[\'bar\']}',
            ],
            'Type 3: array offset'                                                     => [
                'testMarker'      => '/* testDIM3 */',
                'expectedContent' => '${foo[\'bar\']}',
            ],
            'Type 1: object property'                                                  => [
                'testMarker'      => '/* testProperty1 */',
                'expectedContent' => '$foo->bar',
            ],
            'Type 2: object property'                                                  => [
                'testMarker'      => '/* testProperty2 */',
                'expectedContent' => '{$foo->bar}',
            ],
            'Type 2: object method call'                                               => [
                'testMarker'      => '/* testMethod1 */',
                'expectedContent' => '{$foo->bar()}',
            ],
            'Type 2: closure function call'                                            => [
                'testMarker'      => '/* testClosure1 */',
                'expectedContent' => '{$foo()}',
            ],
            'Type 2: chaining various syntaxes'                                        => [
                'testMarker'      => '/* testChain1 */',
                'expectedContent' => '{$foo[\'bar\']->baz()()}',
            ],
            'Type 4: variable variables'                                               => [
                'testMarker'      => '/* testVariableVar1 */',
                'expectedContent' => '${$bar}',
            ],
            'Type 4: variable constants'                                               => [
                'testMarker'      => '/* testVariableVar2 */',
                'expectedContent' => '${(foo)}',
            ],
            'Type 4: object property'                                                  => [
                'testMarker'      => '/* testVariableVar3 */',
                'expectedContent' => '${foo->bar}',
            ],
            'Type 4: variable variable nested in array offset'                         => [
                'testMarker'      => '/* testNested1 */',
                'expectedContent' => '${foo["${bar}"]}',
            ],
            'Type 4: variable array offset nested in array offset'                     => [
                'testMarker'      => '/* testNested2 */',
                'expectedContent' => '${foo["${bar[\'baz\']}"]}',
            ],
            'Type 4: variable object property'                                         => [
                'testMarker'      => '/* testNested3 */',
                'expectedContent' => '${foo->{$baz}}',
            ],
            'Type 4: variable object property - complex with single quotes'            => [
                'testMarker'      => '/* testNested4 */',
                'expectedContent' => '${foo->{${\'a\'}}}',
            ],
            'Type 4: variable object property - complex with single and double quotes' => [
                'testMarker'      => '/* testNested5 */',
                'expectedContent' => '${foo->{"${\'a\'}"}}',
            ],
        ];

}//end dataHeredocString()

}//end class

[-] BackfillExplicitOctalNotationTest.php [edit]
[-] PHPOpenTagEOF2Test.inc [edit]
[-] BackfillEnumTest.inc [edit]
[-] PHPOpenTagEOF1Test.php [edit]
[-] BackfillAsymmetricVisibilityTest.php [edit]
[-] EnumCaseTest.php [edit]
[-] StableCommentWhitespaceTest.inc [edit]
[-] HeredocNowdocTest.inc [edit]
[-] TypeIntersectionTest.php [edit]
[-] DNFTypesParseError2Test.php [edit]
[-] TypeIntersectionTest.inc [edit]
[-] NamedFunctionCallArgumentsTest.inc [edit]
[-] TypedConstantsTest.inc [edit]
[-] UndoNamespacedNameSingleTokenTest.php [edit]
[-] BackfillFnTokenParseErrorTest.inc [edit]
[+] ..
[-] StableCommentWhitespaceWinTest.php [edit]
[-] DNFTypesTest.inc [edit]
[-] DNFTypesParseError1Test.inc [edit]
[-] BitwiseOrTest.php [edit]
[-] BackfillFnTokenParseErrorTest.php [edit]
[-] DoubleQuotedStringTest.php [edit]
[-] BackfillReadonlyTest.inc [edit]
[-] PHPOpenTagEOF1Test.inc [edit]
[-] PHPOpenTagEOF2Test.php [edit]
[-] BackfillNumericSeparatorTest.inc [edit]
[-] ArrayKeywordTest.inc [edit]
[-] BackfillMatchTokenTest.php [edit]
[-] DoubleArrowTest.inc [edit]
[-] HeredocStringTest.inc [edit]
[-] GotoLabelTest.inc [edit]
[-] OtherContextSensitiveKeywordsTest.php [edit]
[-] StableCommentWhitespaceTest.php [edit]
[-] NullsafeObjectOperatorTest.php [edit]
[-] DNFTypesParseError1Test.php [edit]
[-] AttributesTest.php [edit]
[-] ExitKeywordTest.inc [edit]
[-] HeredocParseErrorTest.php [edit]
[-] AnonClassParenthesisOwnerTest.php [edit]
[-] NullableVsInlineThenTest.inc [edit]
[-] ArrayKeywordTest.php [edit]
[-] NullsafeObjectOperatorTest.inc [edit]
[-] BackfillExplicitOctalNotationTest.inc [edit]
[-] ResolveSimpleTokenTest.inc [edit]
[-] DNFTypesParseError2Test.inc [edit]
[-] BackfillEnumTest.php [edit]
[-] YieldTest.inc [edit]
[-] BackfillReadonlyTest.php [edit]
[-] HeredocNowdocTest.php [edit]
[-] ShortArrayTest.inc [edit]
[-] DefaultKeywordTest.php [edit]
[-] StableCommentWhitespaceWinTest.inc [edit]
[-] BitwiseOrTest.inc [edit]
[-] DNFTypesTest.php [edit]
[-] DoubleArrowTest.php [edit]
[-] EnumCaseTest.inc [edit]
[-] TypedConstantsTest.php [edit]
[-] BackfillNumericSeparatorTest.php [edit]
[-] BackfillFnTokenTest.php [edit]
[-] FinallyTest.inc [edit]
[-] HeredocStringTest.php [edit]
[-] ShortArrayTest.php [edit]
[-] BackfillMatchTokenTest.inc [edit]
[-] NullableVsInlineThenTest.php [edit]
[-] DoubleQuotedStringTest.inc [edit]
[-] GotoLabelTest.php [edit]
[-] ExitKeywordTest.php [edit]
[-] HeredocParseErrorTest.inc [edit]
[-] ResolveSimpleTokenTest.php [edit]
[-] UndoNamespacedNameSingleTokenTest.inc [edit]
[-] OtherContextSensitiveKeywordsTest.inc [edit]
[-] NamedFunctionCallArgumentsTest.php [edit]
[-] AnonClassParenthesisOwnerTest.inc [edit]
[-] PHPOpenTagEOF3Test.inc [edit]
[-] BackfillFnTokenTest.inc [edit]
[-] BackfillAsymmetricVisibilityTest.inc [edit]
[-] AttributesTest.inc [edit]
[-] ContextSensitiveKeywordsTest.inc [edit]
[-] FinallyTest.php [edit]
[-] PHPOpenTagEOF3Test.php [edit]
[-] YieldTest.php [edit]
[-] DefaultKeywordTest.inc [edit]
[-] ContextSensitiveKeywordsTest.php [edit]