Server : Apache System : Linux server2.corals.io 4.18.0-348.2.1.el8_5.x86_64 #1 SMP Mon Nov 15 09:17:08 EST 2021 x86_64 User : corals ( 1002) PHP Version : 7.4.33 Disable Function : exec,passthru,shell_exec,system Directory : /home/corals/old/vendor/magento/framework/Setup/Declaration/Schema/Diff/ |
<?php
/**
* Copyright © Magento, Inc. All rights reserved.
* See COPYING.txt for license details.
*/
namespace Magento\Framework\Setup\Declaration\Schema\Diff;
use Magento\Framework\Setup\Declaration\Schema\Dto\Column;
use Magento\Framework\Setup\Declaration\Schema\Dto\Constraint;
use Magento\Framework\Setup\Declaration\Schema\Dto\ElementInterface;
use Magento\Framework\Setup\Declaration\Schema\Dto\Index;
use Magento\Framework\Setup\Declaration\Schema\Dto\Table;
use Magento\Framework\Setup\Declaration\Schema\Operations\ModifyColumn;
/**
* As table can have different types of elements inside itself.
* We need to compare all of this elements.
*
* If element exists only in XML -> then we need to create element.
* If element exists in both version and are different -> then we need to modify element.
* If element exists only in db -> then we need to remove this element.
*/
class TableDiff
{
/**
* Column type for diff.
*/
const COLUMN_DIFF_TYPE = "columns";
/**
* Constraint type for diff.
*/
const CONSTRAINT_DIFF_TYPE = "constraints";
/**
* Constraint type for diff.
*/
const INDEX_DIFF_TYPE = "indexes";
/**
* @var DiffManager
*/
private $diffManager;
/**
* Constructor.
*
* @param DiffManager $diffManager
*/
public function __construct(DiffManager $diffManager)
{
$this->diffManager = $diffManager;
}
/**
* As SQL engine can automatically create indexes for foreign keys in order to speedup selection
* and we do not have this keys in declaration - we need to ignore them.
*
* @param Table $table
* @param Index[] $indexes
* @return Index[]
*/
private function excludeAutoIndexes(Table $table, array $indexes)
{
foreach ($table->getReferenceConstraints() as $constraint) {
unset($indexes[$constraint->getName()]);
}
return $indexes;
}
/**
* As foreign key is constraint, that do not allow to change column schema definition
* we need to disable it in order to change column definition. When column definition
* will be changed we need to enable foreign key again.
* We need to start column modification from parent table (reference table) and then go to
* tables that have foreign keys.
*
* @param Table $declaredTable
* @param Table $generatedTable
* @param Diff $diff
* @return Diff
*/
private function turnOffForeignKeys(Table $declaredTable, Table $generatedTable, Diff $diff)
{
$changes = $diff->getChange($generatedTable->getName(), ModifyColumn::OPERATION_NAME);
foreach ($changes as $elementHistory) {
/** If this is column we need to recreate foreign key */
if ($elementHistory->getNew() instanceof Column) {
$column = $elementHistory->getNew();
$references = $generatedTable->getReferenceConstraints();
$declaredReferences = $this->getElementsListByNameWithoutPrefix(
$declaredTable->getReferenceConstraints()
);
foreach ($references as $reference) {
/** In case when we have foreign key on column, that should be modified */
if ($reference->getColumn()->getName() === $column->getName() &&
isset($declaredReferences[$reference->getNameWithoutPrefix()])
) {
/**
* Lets disable foreign key and enable it again
* As between drop and create operations we have operation of modification
* we will drop key, modify column, add key
*/
$diff = $this->diffManager->registerRemoval($diff, [$reference]);
$diff = $this->diffManager
->registerCreation(
$diff,
$declaredReferences[$reference->getNameWithoutPrefix()]
);
}
}
}
}
return $diff;
}
/**
* Switches keys of the array on the element name without prefix.
*
* @param Constraint[]|Index[] $elements
* @return array
*/
private function getElementsListByNameWithoutPrefix(array $elements)
{
$elementsList = [];
foreach ($elements as $element) {
$elementsList[$element->getNameWithoutPrefix()] = $element;
}
return $elementsList;
}
/**
* Diff between tables.
*
* @param Table | ElementInterface $declaredTable
* @param Table | ElementInterface $generatedTable
* @param Diff $diff
* @inheritdoc
*/
public function diff(
ElementInterface $declaredTable,
ElementInterface $generatedTable,
Diff $diff
) {
if ($declaredTable->getResource() !== $generatedTable->getResource()) {
$this->diffManager->registerRecreation($declaredTable, $generatedTable, $diff);
return $diff;
}
if ($this->diffManager->shouldBeModified($declaredTable, $generatedTable)) {
$this->diffManager->registerTableModification($declaredTable, $generatedTable, $diff);
}
return $this->calculateDiff($declaredTable, $generatedTable, $diff);
}
/**
* Calculate the difference between tables.
*
* @param Table|ElementInterface $declaredTable
* @param Table|ElementInterface $generatedTable
* @param Diff $diff
* @return Diff
*/
private function calculateDiff(ElementInterface $declaredTable, ElementInterface $generatedTable, Diff $diff)
{
$types = [self::COLUMN_DIFF_TYPE, self::CONSTRAINT_DIFF_TYPE, self::INDEX_DIFF_TYPE];
//We do inspection for each element type
foreach ($types as $elementType) {
$generatedElements = $generatedTable->getElementsByType($elementType);
$declaredElements = $declaredTable->getElementsByType($elementType);
if ($elementType === self::INDEX_DIFF_TYPE) {
$generatedElements = $this->excludeAutoIndexes($generatedTable, $generatedElements);
$declaredElements = $this->excludeAutoIndexes($declaredTable, $declaredElements);
}
if (in_array($elementType, [self::CONSTRAINT_DIFF_TYPE, self::INDEX_DIFF_TYPE], true)) {
$generatedElements = $this->getElementsListByNameWithoutPrefix($generatedElements);
$declaredElements = $this->getElementsListByNameWithoutPrefix($declaredElements);
}
foreach ($declaredElements as $elementName => $element) {
//If it is new for generated (generated from db) elements - we need to create it
if (!isset($generatedElements[$elementName])) {
$diff = $this->diffManager->registerCreation($diff, $element);
} elseif ($this->diffManager->shouldBeModified(
$element,
$generatedElements[$elementName]
)) {
$diff = $this->diffManager
->registerModification($diff, $element, $generatedElements[$elementName]);
}
//Unset processed elements from generated from db schema
//All other unprocessed elements will be added as removed ones
unset($generatedElements[$elementName]);
}
//Elements that should be removed
if ($this->diffManager->shouldBeRemoved($generatedElements)) {
$diff = $this->diffManager->registerRemoval($diff, $generatedElements);
}
}
$diff = $this->turnOffForeignKeys($declaredTable, $generatedTable, $diff);
return $diff;
}
}