nextcloud/lib/private/releasenotes.php
2016-07-22 09:48:05 +02:00

111 lines
3 KiB
PHP

<?php
/**
* @copyright Copyright (c) 2016, ownCloud, Inc.
*
* @author Joas Schilling <coding@schilljs.com>
* @author Victor Dubiniuk <dubiniuk@owncloud.com>
*
* @license AGPL-3.0
*
* This code is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License, version 3,
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License, version 3,
* along with this program. If not, see <http://www.gnu.org/licenses/>
*
*/
namespace OC;
use Doctrine\DBAL\Platforms\MySqlPlatform;
use OCP\IDBConnection;
/**
* Class to store release notes
*/
class ReleaseNotes {
/** @var IDBConnection $dbConnection */
protected $dbConnection;
/**
* @param IDBConnection $dbConnection
*/
public function __construct(IDBConnection $dbConnection) {
$this->dbConnection = $dbConnection;
}
/**
* @param string $fromVersion
* @param string $toVersion
* @return string[]
*/
public function getReleaseNotes($fromVersion, $toVersion) {
$releaseNotes = [];
$l10n = \OC::$server->getL10N('core');
try {
$fromVersionMajorMinor = $this->getMajorMinor($fromVersion);
} catch (\InvalidArgumentException $e) {
$fromVersionMajorMinor = '';
}
try {
$toVersionMajorMinor = $this->getMajorMinor($toVersion);
} catch (\InvalidArgumentException $e) {
$toVersionMajorMinor = '';
}
if ($fromVersionMajorMinor === '8.2' && $toVersionMajorMinor === '9.0') {
if ($this->isMysql() && $this->countFilecacheEntries() > 200000) {
$releaseNotes[] = $l10n->t(
'Hint: You can speed up the upgrade by executing this SQL command manually: ALTER TABLE %s ADD COLUMN checksum varchar(255) DEFAULT NULL AFTER permissions;',
[$this->dbConnection->getQueryBuilder()->getTableName('filecache')]
);
}
}
return $releaseNotes;
}
/**
* @return bool
*/
protected function isMysql(){
return $this->dbConnection->getDatabasePlatform() instanceof MySqlPlatform;
}
/**
* Count entries in filecache table
* @return int
*/
protected function countFilecacheEntries(){
$query = $this->dbConnection->getQueryBuilder();
$query->selectAlias($query->createFunction('COUNT(*)'), 'num_entries')
->from('filecache');
$result = $query->execute();
$row = $result->fetch();
$result->closeCursor();
return (int) $row['num_entries'];
}
/**
* Strip everything except first digits
* @param string $version
* @return string
* @throws \InvalidArgumentException
*/
private function getMajorMinor($version){
$versionArray = explode('.', $version);
if (count($versionArray) < 2) {
throw new \InvalidArgumentException('Version should have at least 2 parts separated by dot.');
}
return implode('.', [ $versionArray[0], $versionArray[1] ]);
}
}