ForeignKeyDefinitionTest.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\Core\Tests\Unit\Database\Schema\Parser;
 
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\Attributes\Test;
use ‪TYPO3\CMS\Core\Database\Schema\Parser\AST\AbstractCreateDefinitionItem;
use ‪TYPO3\CMS\Core\Database\Schema\Parser\AST\CreateForeignKeyDefinitionItem;
use ‪TYPO3\CMS\Core\Database\Schema\Parser\AST\CreateTableStatement;
use ‪TYPO3\CMS\Core\Database\Schema\Parser\Lexer;
use ‪TYPO3\CMS\Core\Database\Schema\Parser\Parser;
use TYPO3\TestingFramework\Core\Unit\UnitTestCase;
 
final class ‪ForeignKeyDefinitionTest extends UnitTestCase
{
    public static function ‪canParseForeignKeyDefinitionDataProvider(): array
    {
        return [
            // See ReferenceDefinitionTest for actual reference definition parsing tests
            'FOREIGN KEY (single column)' => [
                'FOREIGN KEY (`aField`) REFERENCES `bTable` (`bField`)',
                '',
                [['aField', 0, null]],
                'bTable',
                [['bField', 0, null]],
            ],
            'FOREIGN KEY (multiple columns)' => [
                'FOREIGN KEY (`aField`(20) ASC, `bField`) REFERENCES `bTable` (`cField`, `dField`)',
                '',
                [['aField', 20, 'ASC'], ['bField', 0, null]],
                'bTable',
                [['cField', 0, null], ['dField', 0, null]],
            ],
            'FOREIGN KEY (index name)' => [
                'FOREIGN KEY `aIndex`(`aField`, `bField`) REFERENCES `bTable` (`cField`(240) DESC, `dField`)',
                'aIndex',
                [['aField', 0, null], ['bField', 0, null]],
                'bTable',
                [['cField', 240, 'DESC'], ['dField', 0, null]],
            ],
        ];
    }
 
    #[DataProvider('canParseForeignKeyDefinitionDataProvider')]
    #[Test]
    public function ‪canParseForeignKeyDefinition(
        string $indexDefinition,
        string $indexName,
        array $indexColumns,
        string $foreignTableName,
        array $foreignTableColumns
    ): void {
        $statement = sprintf('CREATE TABLE `aTable`(`aField` INT(11), %s);', $indexDefinition);
        $subject = $this->‪createSubject($statement);
 
        self::assertInstanceOf(CreateForeignKeyDefinitionItem::class, $subject);
        self::assertSame($indexName, $subject->indexName->schemaObjectName);
        self::assertSame($foreignTableName, $subject->reference->tableName->schemaObjectName);
 
        foreach ($indexColumns as $index => $column) {
            self::assertSame($column[0], $subject->columnNames[$index]->columnName->schemaObjectName);
            self::assertSame($column[1], $subject->columnNames[$index]->length);
            self::assertSame($column[2], $subject->columnNames[$index]->direction);
        }
 
        foreach ($foreignTableColumns as $index => $column) {
            self::assertSame($column[0], $subject->reference->columnNames[$index]->columnName->schemaObjectName);
            self::assertSame($column[1], $subject->reference->columnNames[$index]->length);
            self::assertSame($column[2], $subject->reference->columnNames[$index]->direction);
        }
    }
 
    private function ‪createSubject(string $statement): ‪AbstractCreateDefinitionItem
    {
        ‪$parser = new ‪Parser(new ‪Lexer());
        $createTableStatement = ‪$parser->getAST($statement);
        return $createTableStatement->createDefinition->items[1];
    }
}