/**
* Performs all actions that are needed to update database structure.
*
* @return boolean True if the system updated successfully and false
* otherwise.
*/
public function run()
{
$current_version = $this->getDatabaseVersion();
if (!preg_match("/^([0-9]{1,2}\\.){2}[0-9]{1,2}(-(alpha|beta|rc)\\.[0-9]+)?\$/", $current_version)) {
$this->errors[] = getlocal('The current version ({0}) is unknown or wrong formated', array($current_version));
return false;
}
if (version_compare($current_version, MIBEW_VERSION) == 0) {
$this->log[] = getlocal('The database is already up to date');
return true;
}
if (version_compare($current_version, self::MIN_VERSION) < 0) {
$this->errors[] = getlocal('You can update the system only from {0} and later versions. The current version is {1}', array(self::MIN_VERSION, $current_version));
return false;
}
try {
// Perform incremental updates
foreach (Utils::getUpdates($this) as $version => $method) {
if (version_compare($version, $current_version) <= 0) {
// Skip updates to lower versions.
continue;
}
// Run the update
if (!$method()) {
$this->errors[] = getlocal('Cannot update to {0}', array($version));
return false;
}
// Store new version number in the database. With this info
// we can rerun the updating process if one of pending
// updates fails.
if (!$this->setDatabaseVersion($version)) {
return false;
} else {
$this->log[] = getlocal('Updated to {0}', array($version));
}
$current_version = $version;
}
} catch (\Exception $e) {
// Something went wrong
$this->errors[] = getlocal('Update failed: {0}', array($e->getMessage()));
return false;
}
// Use the version from the PHP's constant as the current database
// version.
if ($this->setDatabaseVersion(MIBEW_VERSION)) {
return false;
}
// Clean up the cache
$this->cache->flush();
return true;
}
/**
* Tries to update a plugin.
*
* @param string $plugin_name Name of the plugin to update.
* @return boolean Indicates if the plugin has been updated or not.
*/
public function update($plugin_name)
{
$plugin = new PluginInfo($plugin_name);
if (!$plugin->needsUpdate()) {
// There is no need to update the plugin
return true;
}
if (!$plugin->canBeUpdated()) {
// The plugin cannot be updated.
return false;
}
try {
// Perform incremental updates
$updates = MaintenanceUtils::getUpdates($plugin->getClass());
foreach ($updates as $version => $method) {
// Skip updates to lower versions.
if (version_compare($version, $plugin->getInstalledVersion()) <= 0) {
continue;
}
// Skip updates to versions that greater then the current plugin
// version.
if (version_compare($version, $plugin->getVersion()) > 0) {
break;
}
// Run the update
if (!$method()) {
// By some reasons we cannot update to the next version.
// Stop the process here.
return false;
}
// Store new version number in the database. With this info
// we can rerun the updating process if one of pending
// updates fails.
$plugin->getState()->version = $version;
$plugin->getState()->save();
}
} catch (\Exception $e) {
// Something went wrong
trigger_error(sprintf('Update of "%s" plugin failed: %s', $plugin->getName(), $e->getMessage()), E_USER_WARNING);
return false;
}
// All updates are done. Make sure the state of the plugin contains
// current plugin version.
$plugin->getState()->version = $plugin->getVersion();
$plugin->getState()->save();
return true;
}
