250 lines
9.7 KiB
PHP
250 lines
9.7 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace PhpMyAdmin\Query;
|
|
|
|
use PhpMyAdmin\Dbal\DatabaseInterface;
|
|
use PhpMyAdmin\Util;
|
|
|
|
use function array_keys;
|
|
use function in_array;
|
|
use function strtoupper;
|
|
|
|
/**
|
|
* Handles data compatibility from SQL query results
|
|
*/
|
|
class Compatibility
|
|
{
|
|
/**
|
|
* @param (string|int|null)[][] $eachTables
|
|
*
|
|
* @return (string|int|null)[][]
|
|
*/
|
|
public static function getISCompatForGetTablesFull(array $eachTables, string $eachDatabase): array
|
|
{
|
|
foreach (array_keys($eachTables) as $tableName) {
|
|
if (! isset($eachTables[$tableName]['Type']) && isset($eachTables[$tableName]['Engine'])) {
|
|
// pma BC, same parts of PMA still uses 'Type'
|
|
$eachTables[$tableName]['Type'] =& $eachTables[$tableName]['Engine'];
|
|
} elseif (! isset($eachTables[$tableName]['Engine']) && isset($eachTables[$tableName]['Type'])) {
|
|
// old MySQL reports Type, newer MySQL reports Engine
|
|
$eachTables[$tableName]['Engine'] =& $eachTables[$tableName]['Type'];
|
|
}
|
|
|
|
// Compatibility with INFORMATION_SCHEMA output
|
|
$eachTables[$tableName]['TABLE_SCHEMA'] = $eachDatabase;
|
|
$eachTables[$tableName]['TABLE_NAME'] =& $eachTables[$tableName]['Name'];
|
|
$eachTables[$tableName]['ENGINE'] =& $eachTables[$tableName]['Engine'];
|
|
$eachTables[$tableName]['VERSION'] =& $eachTables[$tableName]['Version'];
|
|
$eachTables[$tableName]['ROW_FORMAT'] =& $eachTables[$tableName]['Row_format'];
|
|
$eachTables[$tableName]['TABLE_ROWS'] =& $eachTables[$tableName]['Rows'];
|
|
$eachTables[$tableName]['AVG_ROW_LENGTH'] =& $eachTables[$tableName]['Avg_row_length'];
|
|
$eachTables[$tableName]['DATA_LENGTH'] =& $eachTables[$tableName]['Data_length'];
|
|
$eachTables[$tableName]['MAX_DATA_LENGTH'] =& $eachTables[$tableName]['Max_data_length'];
|
|
$eachTables[$tableName]['INDEX_LENGTH'] =& $eachTables[$tableName]['Index_length'];
|
|
$eachTables[$tableName]['DATA_FREE'] =& $eachTables[$tableName]['Data_free'];
|
|
$eachTables[$tableName]['AUTO_INCREMENT'] =& $eachTables[$tableName]['Auto_increment'];
|
|
$eachTables[$tableName]['CREATE_TIME'] =& $eachTables[$tableName]['Create_time'];
|
|
$eachTables[$tableName]['UPDATE_TIME'] =& $eachTables[$tableName]['Update_time'];
|
|
$eachTables[$tableName]['CHECK_TIME'] =& $eachTables[$tableName]['Check_time'];
|
|
$eachTables[$tableName]['TABLE_COLLATION'] =& $eachTables[$tableName]['Collation'];
|
|
$eachTables[$tableName]['CHECKSUM'] =& $eachTables[$tableName]['Checksum'];
|
|
$eachTables[$tableName]['CREATE_OPTIONS'] =& $eachTables[$tableName]['Create_options'];
|
|
$eachTables[$tableName]['TABLE_COMMENT'] =& $eachTables[$tableName]['Comment'];
|
|
|
|
if (
|
|
strtoupper($eachTables[$tableName]['Comment'] ?? '') === 'VIEW'
|
|
&& $eachTables[$tableName]['Engine'] == null
|
|
) {
|
|
$eachTables[$tableName]['TABLE_TYPE'] = 'VIEW';
|
|
} elseif ($eachDatabase === 'information_schema') {
|
|
$eachTables[$tableName]['TABLE_TYPE'] = 'SYSTEM VIEW';
|
|
} else {
|
|
/**
|
|
* @todo difference between 'TEMPORARY' and 'BASE TABLE'
|
|
* but how to detect?
|
|
*/
|
|
$eachTables[$tableName]['TABLE_TYPE'] = 'BASE TABLE';
|
|
}
|
|
}
|
|
|
|
return $eachTables;
|
|
}
|
|
|
|
public static function isMySqlOrPerconaDb(DatabaseInterface $dbi): bool
|
|
{
|
|
$serverType = Util::getServerType($dbi);
|
|
|
|
return $serverType === 'MySQL' || $serverType === 'Percona Server';
|
|
}
|
|
|
|
public static function isMariaDb(DatabaseInterface $dbi): bool
|
|
{
|
|
return Util::getServerType($dbi) === 'MariaDB';
|
|
}
|
|
|
|
public static function isCompatibleRenameIndex(DatabaseInterface $dbi, int $serverVersion): bool
|
|
{
|
|
if (self::isMySqlOrPerconaDb($dbi)) {
|
|
return $serverVersion >= 50700;
|
|
}
|
|
|
|
// @see https://mariadb.com/kb/en/alter-table/#rename-indexkey
|
|
if (self::isMariaDb($dbi)) {
|
|
return $serverVersion >= 100502;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
public static function isIntegersLengthRestricted(DatabaseInterface $dbi): bool
|
|
{
|
|
// MySQL made restrictions on the integer types' length from versions >= 8.0.18
|
|
// See: https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-19.html
|
|
$serverType = Util::getServerType($dbi);
|
|
$serverVersion = $dbi->getVersion();
|
|
|
|
return $serverType === 'MySQL' && $serverVersion >= 80018;
|
|
}
|
|
|
|
public static function supportsReferencesPrivilege(DatabaseInterface $dbi): bool
|
|
{
|
|
// See: https://mariadb.com/kb/en/grant/#table-privileges
|
|
// Unused
|
|
if ($dbi->isMariaDB()) {
|
|
return false;
|
|
}
|
|
|
|
// https://dev.mysql.com/doc/refman/5.6/en/privileges-provided.html#priv_references
|
|
// This privilege is unused before MySQL 5.6.22.
|
|
// As of 5.6.22, creation of a foreign key constraint
|
|
// requires at least one of the SELECT, INSERT, UPDATE, DELETE,
|
|
// or REFERENCES privileges for the parent table.
|
|
return $dbi->getVersion() >= 50622;
|
|
}
|
|
|
|
public static function isIntegersSupportLength(string $type, string $length, DatabaseInterface $dbi): bool
|
|
{
|
|
// MySQL Removed the Integer types' length from versions >= 8.0.18
|
|
// except TINYINT(1).
|
|
// See: https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-19.html
|
|
$integerTypes = ['SMALLINT', 'MEDIUMINT', 'INT', 'BIGINT'];
|
|
$typeLengthNotAllowed = in_array($type, $integerTypes, true) || $type === 'TINYINT' && $length !== '1';
|
|
|
|
return ! (self::isIntegersLengthRestricted($dbi) && $typeLengthNotAllowed);
|
|
}
|
|
|
|
/**
|
|
* Returns whether the database server supports virtual columns
|
|
*/
|
|
public static function isVirtualColumnsSupported(DatabaseInterface $dbi, int $serverVersion): bool
|
|
{
|
|
// @see: https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-6.html
|
|
if (self::isMySqlOrPerconaDb($dbi)) {
|
|
return $serverVersion >= 50706;
|
|
}
|
|
|
|
// @see https://mariadb.com/kb/en/changes-improvements-in-mariadb-52/#new-features
|
|
if (self::isMariaDb($dbi)) {
|
|
return $serverVersion >= 50200;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Check whether the database supports JSON data type
|
|
*
|
|
* @return bool true if JSON is supported
|
|
*/
|
|
public static function isJsonSupported(DatabaseInterface $dbi): bool
|
|
{
|
|
// @see: https://mariadb.com/kb/en/mariadb-1027-release-notes/#json
|
|
// @see: https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-8.html#mysqld-5-7-8-json
|
|
return $dbi->isMariaDB() && $dbi->getVersion() >= 100207 || // 10.2.7
|
|
! $dbi->isMariaDB() && $dbi->getVersion() >= 50708; // 5.7.8
|
|
}
|
|
|
|
/**
|
|
* Check whether the database supports UUID data type
|
|
*
|
|
* @return bool true if UUID is supported
|
|
*/
|
|
public static function isUUIDSupported(DatabaseInterface $dbi): bool
|
|
{
|
|
// @see: https://mariadb.com/kb/en/mariadb-1070-release-notes/#uuid
|
|
return $dbi->isMariaDB() && $dbi->getVersion() >= 100700; // 10.7.0
|
|
}
|
|
|
|
/**
|
|
* Check whether the database supports VECTOR data type
|
|
*
|
|
* @return bool true if VECTOR is supported
|
|
*/
|
|
public static function isVectorSupported(DatabaseInterface $dbi): bool
|
|
{
|
|
// @see: https://mariadb.com/docs/release-notes/community-server/old-releases/mariadb-11-7-rolling-releases/mariadb-11-7-1-release-notes#vectors
|
|
// @see: https://dev.mysql.com/doc/relnotes/mysql/9.0/en/news-9-0-0.html#mysqld-9-0-0-vectors
|
|
return $dbi->isMariaDB() && $dbi->getVersion() >= 110701 || // 11.7.1
|
|
$dbi->isMySql() && $dbi->getVersion() >= 90000; // 9.0.0
|
|
}
|
|
|
|
/**
|
|
* Returns whether the database server supports virtual columns
|
|
*/
|
|
public static function supportsStoredKeywordForVirtualColumns(DatabaseInterface $dbi, int $serverVersion): bool
|
|
{
|
|
// @see: https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-6.html
|
|
if (self::isMySqlOrPerconaDb($dbi)) {
|
|
return $serverVersion >= 50706;
|
|
}
|
|
|
|
// @see https://mariadb.com/kb/en/generated-columns/#mysql-compatibility-support
|
|
if (self::isMariaDb($dbi)) {
|
|
return $serverVersion >= 100201;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Returns whether the database server supports compressed columns
|
|
*/
|
|
public static function supportsCompressedColumns(DatabaseInterface $dbi, int $serverVersion): bool
|
|
{
|
|
// @see https://mariadb.com/kb/en/innodb-page-compression/#comment_1992
|
|
// Comment: Page compression is only available in MariaDB >= 10.1. [...]
|
|
if (self::isMariaDb($dbi)) {
|
|
return $serverVersion >= 100100;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @see https://dev.mysql.com/doc/relnotes/mysql/5.7/en/news-5-7-6.html#mysqld-5-7-6-account-management
|
|
* @see https://mariadb.com/kb/en/mariadb-1042-release-notes/#notable-changes
|
|
*
|
|
* @psalm-pure
|
|
*/
|
|
public static function hasAccountLocking(bool $isMariaDb, int $version): bool
|
|
{
|
|
return $isMariaDb && $version >= 100402 || ! $isMariaDb && $version >= 50706;
|
|
}
|
|
|
|
/** @return non-empty-string */
|
|
public static function getShowBinLogStatusStmt(DatabaseInterface $dbal): string
|
|
{
|
|
if ($dbal->isMySql() && $dbal->getVersion() >= 80200) {
|
|
return 'SHOW BINARY LOG STATUS';
|
|
}
|
|
|
|
if ($dbal->isMariaDB() && $dbal->getVersion() >= 100502) {
|
|
return 'SHOW BINLOG STATUS';
|
|
}
|
|
|
|
return 'SHOW MASTER STATUS';
|
|
}
|
|
}
|
