2 use Shaarli\Config\ConfigJson
;
3 use Shaarli\Config\ConfigPhp
;
4 use Shaarli\Config\ConfigManager
;
8 * Used to update stuff when a new Shaarli's version is reached.
9 * Update methods are ran only once, and the stored in a JSON file.
14 * @var array Updates which are already done.
16 protected $doneUpdates;
19 * @var LinkDB instance.
24 * @var ConfigManager $conf Configuration Manager instance.
29 * @var bool True if the user is logged in, false otherwise.
31 protected $isLoggedIn;
34 * @var ReflectionMethod[] List of current class methods.
41 * @param array $doneUpdates Updates which are already done.
42 * @param LinkDB $linkDB LinkDB instance.
43 * @param ConfigManager $conf Configuration Manager instance.
44 * @param boolean $isLoggedIn True if the user is logged in.
46 public function __construct($doneUpdates, $linkDB, $conf, $isLoggedIn)
48 $this->doneUpdates
= $doneUpdates;
49 $this->linkDB
= $linkDB;
51 $this->isLoggedIn
= $isLoggedIn;
53 // Retrieve all update methods.
54 $class = new ReflectionClass($this);
55 $this->methods
= $class->getMethods();
59 * Run all new updates.
60 * Update methods have to start with 'updateMethod' and return true (on success).
62 * @return array An array containing ran updates.
64 * @throws UpdaterException If something went wrong.
66 public function update()
68 $updatesRan = array();
70 // If the user isn't logged in, exit without updating.
71 if ($this->isLoggedIn
!== true) {
75 if ($this->methods
=== null) {
76 throw new UpdaterException('Couldn\'t retrieve Updater class methods.');
79 foreach ($this->methods
as $method) {
80 // Not an update method or already done, pass.
81 if (! startsWith($method->getName(), 'updateMethod')
82 || in_array($method->getName(), $this->doneUpdates
)
88 $method->setAccessible(true);
89 $res = $method->invoke($this);
90 // Update method must return true to be considered processed.
92 $updatesRan[] = $method->getName();
94 } catch (Exception
$e) {
95 throw new UpdaterException($method, $e);
99 $this->doneUpdates
= array_merge($this->doneUpdates
, $updatesRan);
105 * @return array Updates methods already processed.
107 public function getDoneUpdates()
109 return $this->doneUpdates
;
113 * Move deprecated options.php to config.php.
115 * Milestone 0.9 (old versioning) - shaarli/Shaarli#41:
116 * options.php is not supported anymore.
118 public function updateMethodMergeDeprecatedConfigFile()
120 if (is_file($this->conf
->get('resource.data_dir') . '/options.php')) {
121 include $this->conf
->get('resource.data_dir') . '/options.php';
123 // Load GLOBALS into config
124 $allowedKeys = array_merge(ConfigPhp
::$ROOT_KEYS);
125 $allowedKeys[] = 'config';
126 foreach ($GLOBALS as $key => $value) {
127 if (in_array($key, $allowedKeys)) {
128 $this->conf
->set($key, $value);
131 $this->conf
->write($this->isLoggedIn
);
132 unlink($this->conf
->get('resource.data_dir').'/options.php');
139 * Move old configuration in PHP to the new config system in JSON format.
141 * Will rename 'config.php' into 'config.save.php' and create 'config.json.php'.
142 * It will also convert legacy setting keys to the new ones.
144 public function updateMethodConfigToJson()
146 // JSON config already exists, nothing to do.
147 if ($this->conf
->getConfigIO() instanceof ConfigJson
) {
151 $configPhp = new ConfigPhp();
152 $configJson = new ConfigJson();
153 $oldConfig = $configPhp->read($this->conf
->getConfigFile() . '.php');
154 rename($this->conf
->getConfigFileExt(), $this->conf
->getConfigFile() . '.save.php');
155 $this->conf
->setConfigIO($configJson);
156 $this->conf
->reload();
158 $legacyMap = array_flip(ConfigPhp
::$LEGACY_KEYS_MAPPING);
159 foreach (ConfigPhp
::$ROOT_KEYS as $key) {
160 $this->conf
->set($legacyMap[$key], $oldConfig[$key]);
163 // Set sub config keys (config and plugins)
164 $subConfig = array('config', 'plugins');
165 foreach ($subConfig as $sub) {
166 foreach ($oldConfig[$sub] as $key => $value) {
167 if (isset($legacyMap[$sub .'.'. $key])) {
168 $configKey = $legacyMap[$sub .'.'. $key];
170 $configKey = $sub .'.'. $key;
172 $this->conf
->set($configKey, $value);
177 $this->conf
->write($this->isLoggedIn
);
179 } catch (IOException
$e) {
180 error_log($e->getMessage());
186 * Escape settings which have been manually escaped in every request in previous versions:
188 * - general.header_link
191 * @return bool true if the update is successful, false otherwise.
193 public function updateMethodEscapeUnescapedConfig()
196 $this->conf
->set('general.title', escape($this->conf
->get('general.title')));
197 $this->conf
->set('general.header_link', escape($this->conf
->get('general.header_link')));
198 $this->conf
->set('redirector.url', escape($this->conf
->get('redirector.url')));
199 $this->conf
->write($this->isLoggedIn
);
200 } catch (Exception
$e) {
201 error_log($e->getMessage());
208 * Update the database to use the new ID system, which replaces linkdate primary keys.
209 * Also, creation and update dates are now DateTime objects (done by LinkDB).
211 * Since this update is very sensitve (changing the whole database), the datastore will be
212 * automatically backed up into the file datastore.<datetime>.php.
214 * LinkDB also adds the field 'shorturl' with the precedent format (linkdate smallhash),
215 * which will be saved by this method.
217 * @return bool true if the update is successful, false otherwise.
219 public function updateMethodDatastoreIds()
221 // up to date database
222 if (isset($this->linkDB
[0])) {
226 $save = $this->conf
->get('resource.data_dir') .'/datastore.'. date('YmdHis') .'.php';
227 copy($this->conf
->get('resource.datastore'), $save);
230 foreach ($this->linkDB
as $offset => $value) {
232 unset($this->linkDB
[$offset]);
234 $links = array_reverse($links);
236 foreach ($links as $l) {
237 unset($l['linkdate']);
239 $this->linkDB
[$cpt++
] = $l;
242 $this->linkDB
->save($this->conf
->get('resource.page_cache'));
243 $this->linkDB
->reorder();
249 * Rename tags starting with a '-' to work with tag exclusion search.
251 public function updateMethodRenameDashTags()
253 $linklist = $this->linkDB
->filterSearch();
254 foreach ($linklist as $key => $link) {
255 $link['tags'] = preg_replace('/(^| )\-/', '$1', $link['tags
']);
256 $link['tags
'] = implode(' ', array_unique(LinkFilter::tagsStrToArray($link['tags
'], true)));
257 $this->linkDB[$key] = $link;
259 $this->linkDB->save($this->conf->get('resource.page_cache
'));
264 * Initialize API settings:
265 * - api.enabled: true
266 * - api.secret: generated secret
268 public function updateMethodApiSettings()
270 if ($this->conf->exists('api
.secret
')) {
274 $this->conf->set('api
.enabled
', true);
278 $this->conf->get('credentials
.login
'),
279 $this->conf->get('credentials
.salt
')
282 $this->conf->write($this->isLoggedIn);
287 * New setting: theme name. If the default theme is used, nothing to do.
289 * If the user uses a custom theme, raintpl_tpl dir is updated to the parent directory,
290 * and the current theme is set as default in the theme setting.
292 * @return bool true if the update is successful, false otherwise.
294 public function updateMethodDefaultTheme()
296 // raintpl_tpl isn't the root template directory anymore
.
297 // We run the update only if this folder still contains the template files.
298 $tplDir = $this->conf
->get('resource.raintpl_tpl');
299 $tplFile = $tplDir . '/linklist.html';
300 if (! file_exists($tplFile)) {
304 $parent = dirname($tplDir);
305 $this->conf
->set('resource.raintpl_tpl', $parent);
306 $this->conf
->set('resource.theme', trim(str_replace($parent, '', $tplDir), '/'));
307 $this->conf
->write($this->isLoggedIn
);
309 // Dependency injection gore
310 RainTPL
::$tpl_dir = $tplDir;
316 * Move the file to inc/user.css to data/user.css.
318 * Note: Due to hardcoded paths, it's not unit testable. But one line of code should be fine.
320 * @return bool true if the update is successful, false otherwise.
322 public function updateMethodMoveUserCss()
324 if (! is_file('inc/user.css')) {
328 return rename('inc/user.css', 'data/user.css');
332 * While the new default theme is in an unstable state
333 * continue to use the vintage theme
335 public function updateMethodDefaultThemeVintage()
337 if ($this->conf
->get('resource.theme') !== 'default') {
340 $this->conf
->set('resource.theme', 'vintage');
341 $this->conf
->write($this->isLoggedIn
);
347 * * `markdown_escape` is a new setting, set to true as default.
349 * If the markdown plugin was already enabled, escaping is disabled to avoid
350 * breaking existing entries.
352 public function updateMethodEscapeMarkdown()
354 if ($this->conf
->exists('security.markdown_escape')) {
358 if (in_array('markdown', $this->conf
->get('general.enabled_plugins'))) {
359 $this->conf
->set('security.markdown_escape', false);
361 $this->conf
->set('security.markdown_escape', true);
363 $this->conf
->write($this->isLoggedIn
);
369 * Add 'http://' to Piwik URL the setting is set.
371 * @return bool true if the update is successful, false otherwise.
373 public function updateMethodPiwikUrl()
375 if (! $this->conf
->exists('plugins.PIWIK_URL') || startsWith($this->conf
->get('plugins.PIWIK_URL'), 'http')) {
379 $this->conf
->set('plugins.PIWIK_URL', 'http://'. $this->conf
->get('plugins.PIWIK_URL'));
380 $this->conf
->write($this->isLoggedIn
);
385 * Update updates.check_updates_branch setting.
387 * If the current major version digit matches the latest branch
388 * major version digit, we set the branch to `latest`,
389 * otherwise we'll check updates on the `stable` branch.
391 * No update required for the dev version.
393 * Note: due to hardcoded URL and lack of dependency injection, this is not unit testable.
395 * FIXME! This needs to be removed when we switch to first digit major version
396 * instead of the second one since the versionning process will change.
398 public function updateMethodCheckUpdateRemoteBranch()
400 if (shaarli_version
=== 'dev' || $this->conf
->get('updates.check_updates_branch') === 'latest') {
404 // Get latest branch major version digit
405 $latestVersion = ApplicationUtils
::getLatestGitVersionCode(
406 'https://raw.githubusercontent.com/shaarli/Shaarli/latest/shaarli_version.php',
409 if (preg_match('/(\d+)\.\d+$/', $latestVersion, $matches) === false) {
412 $latestMajor = $matches[1];
414 // Get current major version digit
415 preg_match('/(\d+)\.\d+$/', shaarli_version
, $matches);
416 $currentMajor = $matches[1];
418 if ($currentMajor === $latestMajor) {
423 $this->conf
->set('updates.check_updates_branch', $branch);
424 $this->conf
->write($this->isLoggedIn
);
430 * Class UpdaterException.
432 class UpdaterException
extends Exception
435 * @var string Method where the error occurred.
440 * @var Exception The parent exception.
447 * @param string $message Force the error message if set.
448 * @param string $method Method where the error occurred.
449 * @param Exception|bool $previous Parent exception.
451 public function __construct($message = '', $method = '', $previous = false)
453 $this->method
= $method;
454 $this->previous
= $previous;
455 $this->message
= $this->buildMessage($message);
459 * Build the exception error message.
461 * @param string $message Optional given error message.
463 * @return string The built error message.
465 private function buildMessage($message)
468 if (! empty($message)) {
469 $out .= $message . PHP_EOL
;
472 if (! empty($this->method
)) {
473 $out .= 'An error occurred while running the update '. $this->method
. PHP_EOL
;
476 if (! empty($this->previous
)) {
477 $out .= ' '. $this->previous
->getMessage();
485 * Read the updates file, and return already done updates.
487 * @param string $updatesFilepath Updates file path.
489 * @return array Already done update methods.
491 function read_updates_file($updatesFilepath)
493 if (! empty($updatesFilepath) && is_file($updatesFilepath)) {
494 $content = file_get_contents($updatesFilepath);
495 if (! empty($content)) {
496 return explode(';', $content);
503 * Write updates file.
505 * @param string $updatesFilepath Updates file path.
506 * @param array $updates Updates array to write.
508 * @throws Exception Couldn't write version number.
510 function write_updates_file($updatesFilepath, $updates)
512 if (empty($updatesFilepath)) {
513 throw new Exception('Updates file path is not set, can\'t write updates.');
516 $res = file_put_contents($updatesFilepath, implode(';', $updates));
517 if ($res === false) {
518 throw new Exception('Unable to write updates in '. $updatesFilepath . '.');